@omriashke/dynamico-core 0.1.0 → 0.1.2

package/dist/sources/remote.js.map

@@ -1 +1 @@
-{"version":3,"file":"remote.js","sourceRoot":"","sources":["../../src/sources/remote.ts"],"names":[],"mappings":"AAeA;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA4B;IAC7D,MAAM,SAAS,GACb,OAAO,CAAC,KAAK;QACb,CAAC,OAAO,KAAK,KAAK,WAAW;YAC3B,CAAC,CAAC,KAAK;YACP,CAAC,CAAE,CAAC,GAAG,EAAE;gBACL,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;YACjE,CAAC,CAA6B,CAAC,CAAC;IACtC,MAAM,MAAM,GACV,OAAO,CAAC,SAAS;QACjB,CAAC,OAAO,SAAS,KAAK,WAAW;YAC/B,CAAC,CAAC,SAAS;YACX,CAAC,CAAE,SAAS,SAAS;gBACjB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;YACrE,CAAiC,CAAC,CAAC;IAEzC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC/C,MAAM,KAAK,GACT,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,YAAY,CAAC;IAEjE,MAAM,SAAS,GAAG,IAAI,GAAG,EAA6B,CAAC;IACvD,IAAI,MAAM,GAAqB,IAAI,CAAC;IACpC,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC;IAEhD,SAAS,OAAO;QACd,IAAI,QAAQ;YAAE,OAAO;QACrB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,iBAAiB,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QACD,MAAM,CAAC,SAAS,GAAG,CAAC,EAAgB,EAAE,EAAE;YACtC,IAAI,CAAC;gBACH,MAAM,IAAI,GACR,OAAO,EAAE,CAAC,IAAI,KAAK,QAAQ;oBACzB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC;oBACrB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,IAAmB,CAAC,CAAC,CAAC;gBACnE,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;oBAC9E,MAAM,MAAM,GAAmB,IAAI,CAAC;oBACpC,KAAK,MAAM,CAAC,IAAI,SAAS;wBAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC3C,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,6BAA6B;YAC/B,CAAC;QACH,CAAC,CAAC;QACF,MAAM,CAAC,OAAO,GAAG,GAAG,EAAE;YACpB,MAAM,GAAG,IAAI,CAAC;YACd,iBAAiB,EAAE,CAAC;QACtB,CAAC,CAAC;QACF,MAAM,CAAC,OAAO,GAAG,GAAG,EAAE;YACpB,IAAI,CAAC;gBACH,MAAM,EAAE,KAAK,EAAE,CAAC;YAClB,CAAC;YAAC,MAAM,CAAC;gBACP,UAAU;YACZ,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED,SAAS,iBAAiB;QACxB,IAAI,QAAQ;YAAE,OAAO;QACrB,UAAU,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,EAAE,CAAC;IAEV,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,IAAY;YACtB,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,OAAO,cAAc,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,OAAO;oBACL,IAAI;oBACJ,OAAO,EAAE,GAAG;oBACZ,KAAK,EAAE;wBACL,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,qBAAqB,GAAG,CAAC,MAAM,QAAQ,IAAI,EAAE;qBACvD;iBACF,CAAC;YACJ,CAAC;YACD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAmB,CAAC;QAC9C,CAAC;QACD,SAAS,CAAC,QAAQ;YAChB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxB,OAAO,GAAG,EAAE;gBACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC7B,CAAC,CAAC;QACJ,CAAC;QACD,OAAO;YACL,QAAQ,GAAG,IAAI,CAAC;YAChB,IAAI,CAAC;gBACH,MAAM,EAAE,KAAK,EAAE,CAAC;YAClB,CAAC;YAAC,MAAM,CAAC;gBACP,UAAU;YACZ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"remote.js","sourceRoot":"","sources":["../../src/sources/remote.ts"],"names":[],"mappings":"AA2BA;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA4B;IAC7D,MAAM,SAAS,GACb,OAAO,CAAC,KAAK;QACb,CAAC,OAAO,KAAK,KAAK,WAAW;YAC3B,CAAC,CAAC,KAAK;YACP,CAAC,CAAE,CAAC,GAAG,EAAE;gBACL,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;YACjE,CAAC,CAA6B,CAAC,CAAC;IACtC,MAAM,MAAM,GACV,OAAO,CAAC,SAAS;QACjB,CAAC,OAAO,SAAS,KAAK,WAAW;YAC/B,CAAC,CAAC,SAAS;YACX,CAAC,CAAE,SAAS,SAAS;gBACjB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;YACrE,CAAiC,CAAC,CAAC;IAEzC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC/C,MAAM,KAAK,GACT,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,YAAY,CAAC;IAEjE,MAAM,SAAS,GAAG,IAAI,GAAG,EAA6B,CAAC;IACvD,IAAI,MAAM,GAAqB,IAAI,CAAC;IACpC,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC;IAEhD,SAAS,OAAO;QACd,IAAI,QAAQ;YAAE,OAAO;QACrB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YACjC,wEAAwE;YACxE,wEAAwE;YACxE,uEAAuE;YACvE,sDAAsD;YACtD,MAAM,GAAG,IAAI;gBACX,CAAC,CAAC,IAAK,MAIU,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;gBACtD,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,iBAAiB,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QACD,MAAM,CAAC,SAAS,GAAG,CAAC,EAAgB,EAAE,EAAE;YACtC,IAAI,CAAC;gBACH,MAAM,IAAI,GACR,OAAO,EAAE,CAAC,IAAI,KAAK,QAAQ;oBACzB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC;oBACrB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,IAAmB,CAAC,CAAC,CAAC;gBACnE,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;oBAC9E,MAAM,MAAM,GAAmB,IAAI,CAAC;oBACpC,KAAK,MAAM,CAAC,IAAI,SAAS;wBAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC3C,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,6BAA6B;YAC/B,CAAC;QACH,CAAC,CAAC;QACF,MAAM,CAAC,OAAO,GAAG,GAAG,EAAE;YACpB,MAAM,GAAG,IAAI,CAAC;YACd,iBAAiB,EAAE,CAAC;QACtB,CAAC,CAAC;QACF,MAAM,CAAC,OAAO,GAAG,GAAG,EAAE;YACpB,IAAI,CAAC;gBACH,MAAM,EAAE,KAAK,EAAE,CAAC;YAClB,CAAC;YAAC,MAAM,CAAC;gBACP,UAAU;YACZ,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED,SAAS,iBAAiB;QACxB,IAAI,QAAQ;YAAE,OAAO;QACrB,UAAU,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,EAAE,CAAC;IAEV,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,IAAY;YACtB,MAAM,IAAI,GAA4B,OAAO,CAAC,OAAO;gBACnD,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE;gBAChC,CAAC,CAAC,SAAS,CAAC;YACd,MAAM,GAAG,GAAG,MAAM,SAAS,CACzB,GAAG,OAAO,cAAc,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAClD,IAAI,CACL,CAAC;YACF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,OAAO;oBACL,IAAI;oBACJ,OAAO,EAAE,GAAG;oBACZ,KAAK,EAAE;wBACL,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,qBAAqB,GAAG,CAAC,MAAM,QAAQ,IAAI,EAAE;qBACvD;iBACF,CAAC;YACJ,CAAC;YACD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAmB,CAAC;QAC9C,CAAC;QACD,SAAS,CAAC,QAAQ;YAChB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxB,OAAO,GAAG,EAAE;gBACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC7B,CAAC,CAAC;QACJ,CAAC;QACD;;;;;;;;WAQG;QACH,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,UAAU;YAChC,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC;gBAC9C,MAAM,SAAS,CAAC,GAAG,OAAO,QAAQ,EAAE;oBAClC,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,GAAG,WAAW,EAAE;oBAC/D,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,UAAU,EAAE,CAAC;iBACtD,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,+CAA+C;YACjD,CAAC;QACH,CAAC;QACD,OAAO;YACL,QAAQ,GAAG,IAAI,CAAC;YAChB,IAAI,CAAC;gBACH,MAAM,EAAE,KAAK,EAAE,CAAC;YAClB,CAAC;YAAC,MAAM,CAAC;gBACP,UAAU;YACZ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -1,7 +1,12 @@
 export type Version = string;
 export type Scope = Record<string, unknown>;
 export interface PropsSchemaField {
-    type: "string" | "number" | "boolean" | "object" | "array" | "any";
+    /**
+     * Runtime type. `function` validates `typeof v === 'function'` — useful for
+     * dynamic screens/components that take callbacks. Function values render
+     * fine inside dynamic components; the schema just lets you require them.
+     */
+    type: "string" | "number" | "boolean" | "object" | "array" | "function" | "any";
     required?: boolean;
 }
 export type PropsSchema = Record<string, PropsSchemaField>;
@@ -31,7 +36,7 @@ export interface CompiledModuleError {
     version: Version;
     code?: undefined;
     error: {
-        kind: "compile" | "typecheck";
+        kind: "compile" | "typecheck" | "render" | "test";
         message: string;
         stack?: string;
         diagnostics?: Diagnostic[];
@@ -76,5 +81,14 @@ export interface Source {
     subscribe(listener: (update: SourceUpdate) => void): () => void;
     /** Optional disposal hook. */
     dispose?(): void;
+    /**
+     * Optional: report the host's scope keys to the registry so the
+     * server-side validator knows what bare specifiers it can expect
+     * components to import. Called once on DynamicoProvider mount.
+     *
+     * Remote sources (createRemoteSource) implement this as POST /scope.
+     * Local/test sources can leave it undefined.
+     */
+    reportScope?(keys: readonly string[], reportedBy?: string): Promise<void>;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omriashke/dynamico-core",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Renderer-agnostic core for dynamico: source adapters, module loader, versioned component registry.",
   "license": "Apache-2.0",
   "type": "module",
@@ -13,36 +13,28 @@
       "import": "./dist/index.js"
     }
   },
-  "files": [
-    "dist",
-    "src"
-  ],
+  "files": ["dist", "src"],
   "repository": {
     "type": "git",
     "url": "https://github.com/omriaskenazi/dynamico.git",
     "directory": "packages/core"
   },
   "homepage": "https://github.com/omriaskenazi/dynamico#readme",
-  "keywords": [
-    "react",
-    "runtime",
-    "hot-swap",
-    "dynamic-components",
-    "dynamico"
-  ],
+  "keywords": ["react", "runtime", "hot-swap", "dynamic-components", "dynamico"],
   "publishConfig": {
     "access": "public"
   },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "dev": "tsc -p tsconfig.json -w"
+  },
   "peerDependencies": {
     "react": ">=18"
   },
   "devDependencies": {
     "@types/react": "^18.3.0",
+    "react": "^19.0.0",
     "typescript": "^5.6.3"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "dev": "tsc -p tsconfig.json -w"
   }
-}
+}

package/src/bookPreview.ts

@@ -0,0 +1,235 @@
+import { validateProps } from "./propsSchema.js";
+import type { PropsSchema } from "./types.js";
+
+export type BookPreviewJson = Record<string, unknown>;
+
+export interface BookPreviewConfig {
+  fixtures?: Record<string, BookPreviewJson>;
+  entries?: BookPreviewEntry[];
+  /** Legacy alias — normalized to `entries`. */
+  stories?: BookPreviewEntry[];
+}
+
+export interface BookPreviewEntry {
+  id: string;
+  kind?: "info";
+  blocks?: BookPreviewBlock[];
+}
+
+export type BookPreviewBlock =
+  | { type: "component"; component: string; props?: BookPreviewJson }
+  | { type: "stack"; items: BookPreviewBlockItem[] }
+  | { type: "row"; items: BookPreviewBlockItem[] }
+  | {
+      type: "variantGrid";
+      component: string;
+      variants: Array<{ id: string; props?: BookPreviewJson }>;
+    };
+
+export type BookPreviewBlockItem = { component: string; props?: BookPreviewJson };
+
+export interface BookPreviewPropSet {
+  entryId: string;
+  location: string;
+  props: Record<string, unknown>;
+}
+
+export interface BookPreviewValidationResult {
+  ok: boolean;
+  errors: string[];
+}
+
+/**
+ * Merge `$fixture` references into concrete prop objects.
+ *
+ * Supports both:
+ *   - top-level: `{ "$fixture": "articleCard", "variant": "default" }`
+ *   - per-field: `{ "data": { "$fixture": "articleCard" } }`
+ */
+export function resolveBookFixtures(
+  props: BookPreviewJson | undefined,
+  fixtures: Record<string, BookPreviewJson>,
+): BookPreviewJson {
+  if (!props) return {};
+
+  let merged: BookPreviewJson = { ...props };
+  if ("$fixture" in merged && typeof merged.$fixture === "string") {
+    const fixtureKey = merged.$fixture;
+    const base = fixtures[fixtureKey] ?? {};
+    const { $fixture: _omit, ...rest } = merged;
+    merged = { ...base, ...rest };
+  }
+
+  const out: BookPreviewJson = {};
+  for (const [key, value] of Object.entries(merged)) {
+    if (value && typeof value === "object" && !Array.isArray(value) && "$fixture" in value) {
+      const fixtureKey = (value as BookPreviewJson).$fixture as string;
+      const base = fixtures[fixtureKey] ?? {};
+      const { $fixture: _omit, ...rest } = value as BookPreviewJson;
+      out[key] = { ...base, ...rest };
+    } else {
+      out[key] = value;
+    }
+  }
+  return out;
+}
+
+/**
+ * Resolve book-config prop DSL to runtime values for schema validation.
+ * React element placeholders (`$component`) become null; callbacks (`$fn`) become no-ops.
+ */
+export function resolveBookPropValues(
+  props: BookPreviewJson,
+  fixtures: Record<string, BookPreviewJson>,
+): Record<string, unknown> {
+  const out: Record<string, unknown> = {};
+  for (const [key, value] of Object.entries(props)) {
+    out[key] = resolveBookPropValue(value, fixtures);
+  }
+  return out;
+}
+
+function resolveBookPropValue(value: unknown, fixtures: Record<string, BookPreviewJson>): unknown {
+  if (value === null || typeof value !== "object") return value;
+  if (Array.isArray(value)) {
+    return value.map((item) => resolveBookPropValue(item, fixtures));
+  }
+  const obj = value as BookPreviewJson;
+  if ("$fn" in obj && obj.$fn === "noop") {
+    return () => undefined;
+  }
+  if ("$component" in obj && typeof obj.$component === "string") {
+    return null;
+  }
+  if ("$fixture" in obj) {
+    return resolveBookPropValues(resolveBookFixtures(obj, fixtures), fixtures);
+  }
+  const nested: Record<string, unknown> = {};
+  for (const [key, nestedValue] of Object.entries(obj)) {
+    nested[key] = resolveBookPropValue(nestedValue, fixtures);
+  }
+  return nested;
+}
+
+export function normalizeBookPreviewConfig(raw: BookPreviewConfig): BookPreviewConfig {
+  const entries = raw.entries ?? raw.stories ?? [];
+  return { ...raw, entries };
+}
+
+/** Collect every resolved prop bag used to preview `componentName` in book.config.json. */
+export function collectBookPreviewPropSets(
+  config: BookPreviewConfig,
+  componentName: string,
+): BookPreviewPropSet[] {
+  const normalized = normalizeBookPreviewConfig(config);
+  const fixtures = normalized.fixtures ?? {};
+  const out: BookPreviewPropSet[] = [];
+
+  for (const entry of normalized.entries ?? []) {
+    if (entry.kind === "info") continue;
+    for (const block of entry.blocks ?? []) {
+      collectFromBlock(block, componentName, fixtures, entry.id, out);
+    }
+  }
+  return out;
+}
+
+function collectFromBlock(
+  block: BookPreviewBlock,
+  componentName: string,
+  fixtures: Record<string, BookPreviewJson>,
+  entryId: string,
+  out: BookPreviewPropSet[],
+): void {
+  switch (block.type) {
+    case "component":
+      collectFromComponentUse(block.component, block.props, componentName, fixtures, entryId, "preview", out);
+      return;
+    case "stack":
+    case "row":
+      for (const item of block.items) {
+        collectFromComponentUse(item.component, item.props, componentName, fixtures, entryId, "preview", out);
+      }
+      return;
+    case "variantGrid":
+      for (const variant of block.variants) {
+        collectFromComponentUse(
+          block.component,
+          variant.props,
+          componentName,
+          fixtures,
+          entryId,
+          `variant '${variant.id}'`,
+          out,
+        );
+      }
+      return;
+    default:
+      return;
+  }
+}
+
+function collectFromComponentUse(
+  usedComponent: string,
+  props: BookPreviewJson | undefined,
+  componentName: string,
+  fixtures: Record<string, BookPreviewJson>,
+  entryId: string,
+  location: string,
+  out: BookPreviewPropSet[],
+): void {
+  if (usedComponent === componentName) {
+    out.push({
+      entryId,
+      location,
+      props: resolveBookPropValues(resolveBookFixtures(props, fixtures), fixtures),
+    });
+  }
+  collectNestedComponentProps(props, componentName, fixtures, entryId, out);
+}
+
+function collectNestedComponentProps(
+  props: BookPreviewJson | undefined,
+  componentName: string,
+  fixtures: Record<string, BookPreviewJson>,
+  entryId: string,
+  out: BookPreviewPropSet[],
+): void {
+  if (!props) return;
+  for (const [key, value] of Object.entries(props)) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) continue;
+    const obj = value as BookPreviewJson;
+    if ("$component" in obj && obj.$component === componentName) {
+      const nestedProps = (obj.props as BookPreviewJson | undefined) ?? {};
+      out.push({
+        entryId,
+        location: `prop '${key}'`,
+        props: resolveBookPropValues(resolveBookFixtures(nestedProps, fixtures), fixtures),
+      });
+    }
+    collectNestedComponentProps(obj, componentName, fixtures, entryId, out);
+  }
+}
+
+/** Validate every book.config.json preview of a component against its propsSchema. */
+export function validateBookPreviewsForComponent(
+  schema: PropsSchema,
+  config: BookPreviewConfig,
+  componentName: string,
+): BookPreviewValidationResult {
+  const sets = collectBookPreviewPropSets(config, componentName);
+  if (sets.length === 0) {
+    return { ok: true, errors: [] };
+  }
+
+  const errors: string[] = [];
+  for (const set of sets) {
+    const result = validateProps(schema, set.props);
+    if (!result.ok) {
+      errors.push(
+        `book entry '${set.entryId}' (${set.location}): ${result.errors.join("; ")}`,
+      );
+    }
+  }
+  return { ok: errors.length === 0, errors };
+}

package/src/index.ts

@@ -20,9 +20,22 @@ export { Registry } from "./registry.js";
 export { loadModule } from "./loader.js";
 export { createRemoteSource, type RemoteSourceOptions } from "./sources/remote.js";
 export { validateProps, type PropsValidationResult } from "./propsSchema.js";
+export {
+  collectBookPreviewPropSets,
+  normalizeBookPreviewConfig,
+  resolveBookFixtures,
+  resolveBookPropValues,
+  validateBookPreviewsForComponent,
+  type BookPreviewBlock,
+  type BookPreviewConfig,
+  type BookPreviewEntry,
+  type BookPreviewPropSet,
+  type BookPreviewValidationResult,
+} from "./bookPreview.js";
 export {
   createRuntime,
   type RuntimeAPI,
+  type CreateRuntimeOptions,
   type DynamicoProviderProps,
   type DynamicComponentProps,
 } from "./react/createRuntime.js";

package/src/loader.ts

@@ -23,7 +23,10 @@ export function loadModule(
     if (name.startsWith("./") || name.startsWith("../") || name.startsWith("/")) {
       return requireRelative(name);
     }
-    if (Object.prototype.hasOwnProperty.call(scope, name)) {
+    // Use `in` (triggers Proxy `has` traps) so that hosts can supply scope
+    // via a Proxy and resolve module bindings lazily. Falls back to
+    // `hasOwnProperty` semantics for plain object scopes.
+    if (name in scope) {
       return scope[name];
     }
     throw new Error(

package/src/propsSchema.ts

@@ -11,6 +11,7 @@ const TYPE_CHECKS: Record<string, (v: unknown) => boolean> = {
   boolean: (v) => typeof v === "boolean",
   object: (v) => typeof v === "object" && v !== null && !Array.isArray(v),
   array: (v) => Array.isArray(v),
+  function: (v) => typeof v === "function",
   any: () => true,
 };
 
@@ -39,5 +40,6 @@ export function validateProps(
 function describe(v: unknown): string {
   if (v === null) return "null";
   if (Array.isArray(v)) return "array";
+  if (typeof v === "function") return "function";
   return typeof v;
 }

package/src/react/createRuntime.tsx

@@ -14,6 +14,13 @@ export interface RuntimeAPI {
   DynamicoProvider: React.ComponentType<DynamicoProviderProps>;
   DynamicComponent: React.ComponentType<DynamicComponentProps>;
   useDynamico: (name: string) => RegistryEntry | undefined;
+  /**
+   * Read the merged host scope from inside React. Useful in dynamic
+   * components that want to introspect what the host gave them, or to
+   * conditionally use scope features (`useScope()['@my/haptics']` may be
+   * undefined if the host didn't register it).
+   */
+  useScope: () => Scope;
 }
 
 export interface DynamicoProviderProps {
@@ -33,8 +40,26 @@ interface RuntimeContextValue {
   registry: Registry;
 }
 
-export function createRuntime(defaultScope: Scope): RuntimeAPI {
+/**
+ * Optional renderer-specific knobs passed by the platform package
+ * (`@omriashke/dynamico-web`, `@omriashke/dynamico-native`).
+ *
+ * The web runtime is fine with the built-in `defaultErrorView` (which renders
+ * a plain text Fragment via React.createElement), since DOM accepts text
+ * nodes anywhere. React Native does NOT — bare strings throw "Text strings
+ * must be rendered within a <Text> component". The native package supplies
+ * its own `defaultErrorFallback` that wraps the message in `<Text>`.
+ */
+export interface CreateRuntimeOptions {
+  defaultErrorFallback?: React.ComponentType<{ error: DynamicError }>;
+}
+
+export function createRuntime(
+  defaultScope: Scope,
+  options: CreateRuntimeOptions = {},
+): RuntimeAPI {
   const Ctx = React.createContext<RuntimeContextValue | null>(null);
+  const PlatformDefaultErrorFallback = options.defaultErrorFallback;
 
   function DynamicoProvider({ source, scope, children }: DynamicoProviderProps) {
     const registry = React.useMemo(() => {
@@ -42,6 +67,17 @@ export function createRuntime(defaultScope: Scope): RuntimeAPI {
       return new Registry(source, merged);
     }, [source, scope]);
 
+    // Auto-report host scope to the registry on mount so the server-side
+    // test validator can enforce "every component imports something the host
+    // actually provides". Source implementations that don't support scope
+    // reporting (e.g. local in-memory sources) leave the call as a no-op.
+    React.useEffect(() => {
+      const merged: Scope = { ...defaultScope, ...(scope ?? {}) };
+      const keys = Object.keys(merged);
+      void source.reportScope?.(keys, "host");
+      // Re-run whenever the set of keys changes (added/removed providers).
+    }, [source, scope]);
+
     const value = React.useMemo<RuntimeContextValue>(() => ({ registry }), [registry]);
     return <Ctx.Provider value={value}>{children}</Ctx.Provider>;
   }
@@ -54,6 +90,10 @@ export function createRuntime(defaultScope: Scope): RuntimeAPI {
     return ctx.registry;
   }
 
+  function useScope(): Scope {
+    return useRegistry().getScope();
+  }
+
   function useDynamico(name: string): RegistryEntry | undefined {
     const registry = useRegistry();
     const subscribe = React.useCallback(
@@ -126,7 +166,24 @@ export function createRuntime(defaultScope: Scope): RuntimeAPI {
     );
   }
 
-  return { DynamicoProvider, DynamicComponent, useDynamico };
+  function renderError(
+    errorFallback: DynamicComponentProps["errorFallback"],
+    error: DynamicError,
+  ): React.ReactNode {
+    if (errorFallback) {
+      if (typeof errorFallback === "function") {
+        const Fallback = errorFallback as React.ComponentType<{ error: DynamicError }>;
+        return <Fallback error={error} />;
+      }
+      return errorFallback;
+    }
+    if (PlatformDefaultErrorFallback) {
+      return <PlatformDefaultErrorFallback error={error} />;
+    }
+    return defaultErrorView(error);
+  }
+
+  return { DynamicoProvider, DynamicComponent, useDynamico, useScope };
 }
 
 function pickDefault(factory: ComponentFactory): unknown {
@@ -139,18 +196,6 @@ function pickDefault(factory: ComponentFactory): unknown {
   return undefined;
 }
 
-function renderError(
-  errorFallback: DynamicComponentProps["errorFallback"],
-  error: DynamicError,
-): React.ReactNode {
-  if (!errorFallback) return defaultErrorView(error);
-  if (typeof errorFallback === "function") {
-    const Fallback = errorFallback as React.ComponentType<{ error: DynamicError }>;
-    return <Fallback error={error} />;
-  }
-  return errorFallback;
-}
-
 function defaultErrorView(error: DynamicError): React.ReactElement {
   // Renderer-agnostic: plain text node so it works on both DOM and RN.
   return React.createElement(

package/src/registry.ts

@@ -37,6 +37,15 @@ export class Registry {
     this.scope = scope;
   }
 
+  /**
+   * Return the merged host scope. Dynamic components reach the same values
+   * via `require(name)`, but `getScope()` lets host code (or `useScope()`
+   * inside a dynamic component) introspect what's available.
+   */
+  getScope(): Scope {
+    return this.scope;
+  }
+
   /** Get the current entry for a name, if any. */
   peek(name: string): RegistryEntry | undefined {
     return this.entries.get(name);

package/src/sources/remote.ts

@@ -11,6 +11,18 @@ export interface RemoteSourceOptions {
   WebSocket?: typeof WebSocket;
   /** Reconnection backoff in ms. Default: 1000. */
   reconnectMs?: number;
+  /**
+   * Headers to send on every request. Called on each HTTP fetch and on each
+   * WebSocket reconnect, so the function can return a freshly-rotated token.
+   *
+   * - HTTP: merged into the `Authorization: ...` / `x-api-key: ...` request headers.
+   * - WebSocket: passed as `new WebSocket(url, undefined, { headers })`. This
+   *   works on React Native (which extends the standard constructor); browsers
+   *   silently ignore it because the spec doesn't allow custom WS handshake
+   *   headers. For browsers behind authenticated reverse proxies, use a
+   *   query-string token in `wsUrl` or front the registry with cookie auth.
+   */
+  headers?: () => Record<string, string>;
 }
 
 /**
@@ -47,7 +59,18 @@ export function createRemoteSource(options: RemoteSourceOptions): Source {
   function connect(): void {
     if (disposed) return;
     try {
-      socket = new WSCtor(wsUrl);
+      const hdrs = options.headers?.();
+      // RN's WebSocket constructor accepts a third {headers} arg that lets us
+      // attach Bearer / x-api-key tokens to the upgrade request. The standard
+      // browser WebSocket ignores extra constructor args, so this is a no-op
+      // there (use cookies / a query-string token instead).
+      socket = hdrs
+        ? new (WSCtor as unknown as new (
+            url: string,
+            protocols?: string | string[],
+            options?: { headers?: Record<string, string> },
+          ) => WebSocket)(wsUrl, undefined, { headers: hdrs })
+        : new WSCtor(wsUrl);
     } catch (err) {
       scheduleReconnect();
       return;
@@ -88,7 +111,13 @@ export function createRemoteSource(options: RemoteSourceOptions): Source {
 
   return {
     async fetch(name: string): Promise<CompiledModule> {
-      const res = await fetchImpl(`${httpUrl}/component/${encodeURIComponent(name)}`);
+      const init: RequestInit | undefined = options.headers
+        ? { headers: options.headers() }
+        : undefined;
+      const res = await fetchImpl(
+        `${httpUrl}/component/${encodeURIComponent(name)}`,
+        init,
+      );
       if (!res.ok) {
         return {
           name,
@@ -107,6 +136,27 @@ export function createRemoteSource(options: RemoteSourceOptions): Source {
         listeners.delete(listener);
       };
     },
+    /**
+     * Tell the registry what bare specifiers the host's scope exposes. The
+     * registry uses this to validate that every component's imports resolve
+     * against something the host actually provides — so a typo or a forgotten
+     * scope entry is caught at push time, not at navigation time.
+     *
+     * Best-effort: failures (network, 5xx, server doesn't support /scope) are
+     * silently swallowed; they don't block the app from running.
+     */
+    async reportScope(keys, reportedBy) {
+      try {
+        const baseHeaders = options.headers?.() ?? {};
+        await fetchImpl(`${httpUrl}/scope`, {
+          method: "POST",
+          headers: { "content-type": "application/json", ...baseHeaders },
+          body: JSON.stringify({ keys: [...keys], reportedBy }),
+        });
+      } catch {
+        /* best-effort: never block the host on this */
+      }
+    },
     dispose() {
       disposed = true;
       try {

package/src/types.ts

@@ -3,7 +3,19 @@ export type Version = string;
 export type Scope = Record<string, unknown>;
 
 export interface PropsSchemaField {
-  type: "string" | "number" | "boolean" | "object" | "array" | "any";
+  /**
+   * Runtime type. `function` validates `typeof v === 'function'` — useful for
+   * dynamic screens/components that take callbacks. Function values render
+   * fine inside dynamic components; the schema just lets you require them.
+   */
+  type:
+    | "string"
+    | "number"
+    | "boolean"
+    | "object"
+    | "array"
+    | "function"
+    | "any";
   required?: boolean;
 }
 
@@ -37,7 +49,7 @@ export interface CompiledModuleError {
   version: Version;
   code?: undefined;
   error: {
-    kind: "compile" | "typecheck";
+    kind: "compile" | "typecheck" | "render" | "test";
     message: string;
     stack?: string;
     diagnostics?: Diagnostic[];
@@ -93,4 +105,13 @@ export interface Source {
   subscribe(listener: (update: SourceUpdate) => void): () => void;
   /** Optional disposal hook. */
   dispose?(): void;
+  /**
+   * Optional: report the host's scope keys to the registry so the
+   * server-side validator knows what bare specifiers it can expect
+   * components to import. Called once on DynamicoProvider mount.
+   *
+   * Remote sources (createRemoteSource) implement this as POST /scope.
+   * Local/test sources can leave it undefined.
+   */
+  reportScope?(keys: readonly string[], reportedBy?: string): Promise<void>;
 }