{
  "schema": "leumas.docs.page/1",
  "id": "pkg:@leumas/config-registry",
  "slug": "packages/config-registry",
  "kind": "capabilities",
  "bucket": "package",
  "title": "@leumas/config-registry",
  "name": "@leumas/config-registry",
  "eyebrow": null,
  "chip": null,
  "summary": "The Imperium config engine — the app-config schema, per-mode data contracts, the site route contract and the JSX authoring format that let Web & Studio render and manage config-driven sites.",
  "keywords": [
    "config-registry",
    "app-config",
    "per-mode",
    "config-driven",
    "contracts",
    "config registry api",
    "leumas config registry",
    "manage"
  ],
  "audience": "both",
  "funnel": {
    "product": null,
    "cta": null
  },
  "body": "# @leumas/config-registry\n\nThe Imperium config engine: an app-config schema + a registry/loader so **one config = one subdomain\napp**. Web renders/previews config-driven apps; Studio manages and routes domains → apps.\n\n**Absorbs (DRY-consolidated from):** `z.Domains2/core/src/Imperium/Main/ConfigLoader.jsx` + `RuntimeConfigLoader.secure.jsx` + the config structure in `Imperium.jsx`.\n\n## Usage\n\nConfigs live in the `configs` collection and are served by `@leumas/hosting` (host → published\nconfig). There is no build-time file loader: a `createRegistry()`/`loadFromGlob()` pair existed here\nand was deleted in the Imperium catch-up program — it had zero consumers and would have been a\n*second, competing* config source alongside the database.\n\n```js\nimport { defineConfig, validateData, normalizeSiteRoutes } from '@leumas/config-registry';\n\nconst config = defineConfig(doc);        // safe defaults over a raw doc\nvalidateData(config.mode, config.data);  // the mode's data contract\nnormalizeSiteRoutes(config);             // the four route buckets → one flat runtime table\n```\n\nA config carries `{ id, appName, mode, data, theme, baseApiUrl, header, footer, routes, redirects,\ncomponents, stores, accounts, databases, paths, seo, hosting }`. See `src/routes.js` for the route\nrecord contract and `src/dataSchemas.js` for the per-mode data contracts.\n",
  "source": {
    "path": "shared/packages/config-registry/README.md",
    "blobSha": "",
    "commit": "",
    "committedAt": "",
    "provenance": "no-git",
    "bytes": 1567,
    "hash": "58aab0c572784d119a71946164b2552fafd53011"
  },
  "urls": {
    "html": "/p/packages/config-registry",
    "json": "/docs/packages/config-registry.json",
    "md": "/docs/packages/config-registry.md"
  },
  "links": {
    "composes": [],
    "usedBy": [
      "pkg:@leumas/admin",
      "pkg:@leumas/app-kit",
      "pkg:@leumas/docs",
      "pkg:@leumas/domain-kit",
      "pkg:@leumas/features",
      "pkg:@leumas/imperium-server",
      "pkg:@leumas/mcp",
      "pkg:@leumas/qr",
      "pkg:@leumas/router-kit",
      "pkg:@leumas/site-map",
      "pkg:@leumas/studio",
      "pkg:@leumas/theme",
      "pkg:@leumas/ui",
      "pkg:@leumas/web"
    ],
    "product": [
      "pkg:@leumas/admin",
      "pkg:@leumas/converter-web",
      "pkg:@leumas/docs",
      "pkg:@leumas/studio",
      "pkg:@leumas/web"
    ],
    "howTo": [],
    "skills": [
      "skill:cinematic-frontend-director"
    ]
  },
  "exports": {
    "total": 358,
    "component": 155,
    "hook": 0,
    "helper": 203,
    "names": [
      {
        "n": "APPEARANCE_CSS_MAX_BYTES",
        "k": "component"
      },
      {
        "n": "APPEARANCE_CSS_MAX_BYTES",
        "k": "component"
      },
      {
        "n": "APPEARANCE_FONTS",
        "k": "component"
      },
      {
        "n": "APPEARANCE_FONTS",
        "k": "component"
      },
      {
        "n": "APPEARANCE_MAX_BYTES",
        "k": "component"
      },
      {
        "n": "APPEARANCE_MAX_BYTES",
        "k": "component"
      },
      {
        "n": "APPEARANCE_MODES",
        "k": "component"
      },
      {
        "n": "APPEARANCE_MODES",
        "k": "component"
      },
      {
        "n": "APPEARANCE_MONO_FONTS",
        "k": "component"
      },
      {
        "n": "APPEARANCE_MONO_FONTS",
        "k": "component"
      },
      {
        "n": "APPEARANCE_SCHEMA",
        "k": "component"
      },
      {
        "n": "APPEARANCE_SCHEMA",
        "k": "component"
      },
      {
        "n": "BIND_OPS",
        "k": "component"
      },
      {
        "n": "BIND_SOURCES",
        "k": "component"
      },
      {
        "n": "BINDING_OVERRIDE_KEYS",
        "k": "component"
      },
      {
        "n": "BINDING_OVERRIDE_REFUSED",
        "k": "component"
      },
      {
        "n": "BINDING_OVERRIDE_RULES",
        "k": "component"
      },
      {
        "n": "BINDING_OVERRIDE_SCHEMA",
        "k": "component"
      },
      {
        "n": "BLUR_STEPS",
        "k": "component"
      },
      {
        "n": "CHANGEFREQ",
        "k": "component"
      },
      {
        "n": "CHROME_POLICIES",
        "k": "component"
      },
      {
        "n": "CHROME_POLICIES",
        "k": "component"
      },
      {
        "n": "COMPONENT_NAMESPACES",
        "k": "component"
      },
      {
        "n": "COMPONENT_NAMESPACES",
        "k": "component"
      },
      {
        "n": "COMPONENTS",
        "k": "component"
      },
      {
        "n": "COMPONENTS_GENERATED_AT",
        "k": "component"
      },
      {
        "n": "CONFIG_KEY_ORDER",
        "k": "component"
      },
      {
        "n": "CONFIG_SHAPE",
        "k": "component"
      },
      {
        "n": "CONFIG_SHAPE",
        "k": "component"
      },
      {
        "n": "CUSTOM_CSS_CAP",
        "k": "component"
      },
      {
        "n": "CUSTOM_CSS_CAP",
        "k": "component"
      },
      {
        "n": "CUSTOM_MODE_PREFIX",
        "k": "component"
      },
      {
        "n": "CUSTOM_MODE_PREFIX",
        "k": "component"
      },
      {
        "n": "CUSTOM_MODE_SCHEMA",
        "k": "component"
      },
      {
        "n": "CUSTOM_MODE_SCHEMA",
        "k": "component"
      },
      {
        "n": "DATA_SCHEMAS",
        "k": "component"
      },
      {
        "n": "DATA_SCHEMAS",
        "k": "component"
      },
      {
        "n": "DATA_TEMPLATES",
        "k": "component"
      },
      {
        "n": "DATA_TEMPLATES",
        "k": "component"
      },
      {
        "n": "DATA_TEMPLATES",
        "k": "component"
      },
      {
        "n": "DEFAULT_ALLOW_AGENTS",
        "k": "component"
      },
      {
        "n": "DEFAULT_APPEARANCE",
        "k": "component"
      },
      {
        "n": "DEFAULT_APPEARANCE",
        "k": "component"
      },
      {
        "n": "DEFAULT_DENY_AGENTS",
        "k": "component"
      },
      {
        "n": "DEFAULT_INPUT_THEME",
        "k": "component"
      },
      {
        "n": "DEFAULT_SKIN",
        "k": "component"
      },
      {
        "n": "DEFAULT_SKIN",
        "k": "component"
      },
      {
        "n": "DEFAULT_TARGET",
        "k": "component"
      },
      {
        "n": "DENSITY_SCALES",
        "k": "component"
      },
      {
        "n": "DENSITY_SCALES",
        "k": "component"
      },
      {
        "n": "DENSITY_STEPS",
        "k": "component"
      },
      {
        "n": "EXTERNAL_APP_MODES",
        "k": "component"
      },
      {
        "n": "EXTERNAL_APP_MODES",
        "k": "component"
      },
      {
        "n": "FONT_STEPS",
        "k": "component"
      },
      {
        "n": "GENERATED_AT",
        "k": "component"
      },
      {
        "n": "GLOBAL_CONFIG_ID",
        "k": "component"
      },
      {
        "n": "GLOBAL_SCHEMA",
        "k": "component"
      },
      {
        "n": "INPUT_THEME_PRESETS",
        "k": "component"
      },
      {
        "n": "INPUT_THEME_SCHEMA",
        "k": "component"
      },
      {
        "n": "INPUT_THEME_TOKENS",
        "k": "component"
      },
      {
        "n": "LINK_BIO_THEMES",
        "k": "component"
      },
      {
        "n": "LINK_BIO_THEMES",
        "k": "component"
      },
      {
        "n": "MANIFEST_SHAPE",
        "k": "component"
      },
      {
        "n": "MANIFEST_SHAPE",
        "k": "component"
      },
      {
        "n": "MCP_PUBLISH_CAP",
        "k": "component"
      },
      {
        "n": "MCP_SCHEMA",
        "k": "component"
      },
      {
        "n": "MCP_TOOL_NAME_RE",
        "k": "component"
      },
      {
        "n": "MCP_TOOL_SOURCES",
        "k": "component"
      },
      {
        "n": "MCP_VISIBILITIES",
        "k": "component"
      },
      {
        "n": "MERGE_EXCLUDED_KEYS",
        "k": "component"
      },
      {
        "n": "MODE_CAPABILITIES",
        "k": "component"
      },
      {
        "n": "MODE_CAPABILITIES",
        "k": "component"
      },
      {
        "n": "MODE_SUBROUTES",
        "k": "component"
      },
      {
        "n": "MODE_SUBROUTES",
        "k": "component"
      },
      {
        "n": "MODE_SURFACES",
        "k": "component"
      },
      {
        "n": "MODE_SURFACES",
        "k": "component"
      },
      {
        "n": "MODE_VARIANTS",
        "k": "component"
      },
      {
        "n": "MODE_VARIANTS",
        "k": "component"
      },
      {
        "n": "MODE_VARIANTS",
        "k": "component"
      },
      {
        "n": "MODES",
        "k": "component"
      },
      {
        "n": "MODES",
        "k": "component"
      },
      {
        "n": "MOTION_MODES",
        "k": "component"
      },
      {
        "n": "MOTION_MODES",
        "k": "component"
      },
      {
        "n": "MOTION_STEPS",
        "k": "component"
      },
      {
        "n": "NOINDEX_PREFIXES",
        "k": "component"
      },
      {
        "n": "PAGE_LAYOUTS",
        "k": "component"
      },
      {
        "n": "PAGE_SEO_SCHEMA",
        "k": "component"
      },
      {
        "n": "PILLAR_PREFIX",
        "k": "component"
      },
      {
        "n": "PILLAR_PREFIX",
        "k": "component"
      },
      {
        "n": "PLATFORM_DISALLOW",
        "k": "component"
      },
      {
        "n": "PLATFORM_DYNAMIC_ROUTES",
        "k": "component"
      },
      {
        "n": "PLATFORM_REDIRECTS",
        "k": "component"
      },
      {
        "n": "PLATFORM_ROUTES",
        "k": "component"
      },
      {
        "n": "PRIVILEGED_TARGET_KINDS",
        "k": "component"
      },
      {
        "n": "PROXYING_TARGET_KINDS",
        "k": "component"
      },
      {
        "n": "RADIUS_SCALES",
        "k": "component"
      },
      {
        "n": "RADIUS_SCALES",
        "k": "component"
      },
      {
        "n": "RADIUS_STEPS",
        "k": "component"
      },
      {
        "n": "RESERVED_ROUTE_PREFIXES",
        "k": "component"
      },
      {
        "n": "RESERVED_ROUTE_PREFIXES",
        "k": "component"
      },
      {
        "n": "RESERVED_SITE_PREFIXES",
        "k": "component"
      },
      {
        "n": "RESERVED_SITE_PREFIXES",
        "k": "component"
      },
      {
        "n": "ROBOTS_MODES",
        "k": "component"
      },
      {
        "n": "ROUTE_BUCKETS",
        "k": "component"
      },
      {
        "n": "ROUTE_BUCKETS",
        "k": "component"
      },
      {
        "n": "ROUTE_GUARDS",
        "k": "component"
      },
      {
        "n": "ROUTE_GUARDS",
        "k": "component"
      },
      {
        "n": "ROUTE_SCHEMA",
        "k": "component"
      },
      {
        "n": "ROUTE_SCHEMA",
        "k": "component"
      },
      {
        "n": "ROUTE_SHAPE",
        "k": "component"
      },
      {
        "n": "ROUTE_SHAPE",
        "k": "component"
      },
      {
        "n": "ROUTE_UNFORMED_KEYS",
        "k": "component"
      },
      {
        "n": "ROUTE_UNFORMED_KEYS",
        "k": "component"
      },
      {
        "n": "SEO_SCHEMA",
        "k": "component"
      },
      {
        "n": "SHIELD_DEFAULTS",
        "k": "component"
      },
      {
        "n": "SHIELD_LIMITS",
        "k": "component"
      },
      {
        "n": "SHIELD_SCHEMA",
        "k": "component"
      },
      {
        "n": "SKIN_BORDERS",
        "k": "component"
      },
      {
        "n": "SKIN_BORDERS",
        "k": "component"
      },
      {
        "n": "SKIN_CARDS",
        "k": "component"
      },
      {
        "n": "SKIN_CARDS",
        "k": "component"
      },
      {
        "n": "SKIN_CHROMES",
        "k": "component"
      },
      {
        "n": "SKIN_CHROMES",
        "k": "component"
      },
      {
        "n": "SKIN_ENUMS",
        "k": "component"
      },
      {
        "n": "SKIN_ENUMS",
        "k": "component"
      },
      {
        "n": "SKIN_MAX_BYTES",
        "k": "component"
      },
      {
        "n": "SKIN_MAX_BYTES",
        "k": "component"
      },
      {
        "n": "SKIN_MOTION_CHARS",
        "k": "component"
      },
      {
        "n": "SKIN_MOTION_CHARS",
        "k": "component"
      },
      {
        "n": "SKIN_PRESETS",
        "k": "component"
      },
      {
        "n": "SKIN_PRESETS",
        "k": "component"
      },
      {
        "n": "SKIN_RATIOS",
        "k": "component"
      },
      {
        "n": "SKIN_RATIOS",
        "k": "component"
      },
      {
        "n": "SKIN_RHYTHMS",
        "k": "component"
      },
      {
        "n": "SKIN_RHYTHMS",
        "k": "component"
      },
      {
        "n": "SKIN_SCHEMA",
        "k": "component"
      },
      {
        "n": "SKIN_SCHEMA",
        "k": "component"
      },
      {
        "n": "SKIN_VALUE_RE",
        "k": "component"
      },
      {
        "n": "SKIN_VALUE_RE",
        "k": "component"
      },
      {
        "n": "SKIN_WIDTHS",
        "k": "component"
      },
      {
        "n": "SKIN_WIDTHS",
        "k": "component"
      },
      {
        "n": "SOCIAL_PLATFORM_OPTIONS",
        "k": "component"
      },
      {
        "n": "STARTER_WIREFRAMES",
        "k": "component"
      },
      {
        "n": "STARTERS_BY_ID",
        "k": "component"
      },
      {
        "n": "STORAGE_MODES",
        "k": "component"
      },
      {
        "n": "STORAGE_MODES",
        "k": "component"
      },
      {
        "n": "TARGET_KINDS",
        "k": "component"
      },
      {
        "n": "TARGET_SCHEMAS",
        "k": "component"
      },
      {
        "n": "THEME_PRESETS",
        "k": "component"
      },
      {
        "n": "THEME_PRESETS",
        "k": "component"
      },
      {
        "n": "TYPE_SCALES",
        "k": "component"
      },
      {
        "n": "TYPE_SCALES",
        "k": "component"
      },
      {
        "n": "WIREFRAME_KINDS",
        "k": "component"
      },
      {
        "n": "WIREFRAME_SHAPE",
        "k": "component"
      },
      {
        "n": "WIREFRAME_VERSION",
        "k": "component"
      },
      {
        "n": "appearanceCssText",
        "k": "helper"
      },
      {
        "n": "appearanceCssText",
        "k": "helper"
      },
      {
        "n": "appearanceForConfig",
        "k": "helper"
      },
      {
        "n": "appearanceForConfig",
        "k": "helper"
      },
      {
        "n": "appearanceMode",
        "k": "helper"
      },
      {
        "n": "appearanceMode",
        "k": "helper"
      },
      {
        "n": "appearanceToCssVars",
        "k": "helper"
      },
      {
        "n": "appearanceToCssVars",
        "k": "helper"
      },
      {
        "n": "applyBindingOverrides",
        "k": "helper"
      },
      {
        "n": "applyGlobalConfigs",
        "k": "helper"
      },
      {
        "n": "assertSkinIsMergeSafe",
        "k": "helper"
      },
      {
        "n": "assertSkinIsMergeSafe",
        "k": "helper"
      },
      {
        "n": "bindPropFor",
        "k": "helper"
      },
      {
        "n": "canonicalRoutePath",
        "k": "helper"
      },
      {
        "n": "canonicalRoutePath",
        "k": "helper"
      },
      {
        "n": "capabilitiesFor",
        "k": "helper"
      },
      {
        "n": "capabilitiesFor",
        "k": "helper"
      },
      {
        "n": "compileSiteConfig",
        "k": "helper"
      },
      {
        "n": "component",
        "k": "helper"
      },
      {
        "n": "componentCategories",
        "k": "helper"
      },
      {
        "n": "contentSourceFor",
        "k": "helper"
      },
      {
        "n": "contentSourceFor",
        "k": "helper"
      },
      {
        "n": "contrast",
        "k": "helper"
      },
      {
        "n": "createModeRegistry",
        "k": "helper"
      },
      {
        "n": "createModeRegistry",
        "k": "helper"
      },
      {
        "n": "dataSchemaFor",
        "k": "helper"
      },
      {
        "n": "dataSchemaFor",
        "k": "helper"
      },
      {
        "n": "deepMergeConfig",
        "k": "helper"
      },
      {
        "n": "defaultDataFor",
        "k": "helper"
      },
      {
        "n": "defaultDataFor",
        "k": "helper"
      },
      {
        "n": "defaultGlobalConfig",
        "k": "helper"
      },
      {
        "n": "defaultScope",
        "k": "helper"
      },
      {
        "n": "defaultVariantFor",
        "k": "helper"
      },
      {
        "n": "defaultVariantFor",
        "k": "helper"
      },
      {
        "n": "defaultVariantFor",
        "k": "helper"
      },
      {
        "n": "defineConfig",
        "k": "helper"
      },
      {
        "n": "defineConfig",
        "k": "helper"
      },
      {
        "n": "defineManifest",
        "k": "helper"
      },
      {
        "n": "defineManifest",
        "k": "helper"
      },
      {
        "n": "defineNavManifest",
        "k": "helper"
      },
      {
        "n": "defineNavManifest",
        "k": "helper"
      },
      {
        "n": "defineSiteConfig",
        "k": "helper"
      },
      {
        "n": "denormalizeSiteRoutes",
        "k": "helper"
      },
      {
        "n": "denormalizeSiteRoutes",
        "k": "helper"
      },
      {
        "n": "domainForPath",
        "k": "helper"
      }
    ]
  }
}