@usefragments/core 1.10.2 → 2.0.0

package/dist/preview-runtime.js

@@ -1,5 +1,5 @@
 // src/preview-runtime.tsx
-import { useEffect, useState } from "react";
+import { useEffect, useRef, useState } from "react";
 import { Fragment, jsx } from "react/jsx-runtime";
 var EMPTY_STATE = {
   content: null,
@@ -7,9 +7,131 @@ var EMPTY_STATE = {
   error: null,
   loadedData: void 0
 };
+var LOADING_STATE = {
+  content: null,
+  isLoading: true,
+  error: null,
+  loadedData: void 0
+};
+var LOADED_DATA_COMPARISON_MAX_DEPTH = 32;
+var LOADED_DATA_COMPARISON_MAX_OBJECTS = 1e3;
+var LOADED_DATA_COMPARISON_MAX_PROPERTIES = 4e3;
+var LOADED_DATA_COMPARISON_ERROR = new Error(
+  `Preview loadedData could not be compared safely. Pass a stable object reference, or use JSON-like data within ${LOADED_DATA_COMPARISON_MAX_DEPTH} levels, ${LOADED_DATA_COMPARISON_MAX_OBJECTS} objects, and ${LOADED_DATA_COMPARISON_MAX_PROPERTIES} property inspections.`
+);
+var LOADED_DATA_COMPARISON_ERROR_STATE = {
+  content: null,
+  isLoading: false,
+  error: LOADED_DATA_COMPARISON_ERROR,
+  loadedData: void 0
+};
 function toError(error) {
   return error instanceof Error ? error : new Error(String(error));
 }
+var NO_PENDING_LOADED_DATA = /* @__PURE__ */ Symbol("no-pending-loaded-data");
+function isPlainRecord(value) {
+  const prototype = Object.getPrototypeOf(value);
+  return prototype === Object.prototype || prototype === null;
+}
+function compareLoadedDataProperties(left, right, depth, context) {
+  let leftPropertyCount = 0;
+  for (const key in left) {
+    if (context.inspectedProperties >= LOADED_DATA_COMPARISON_MAX_PROPERTIES) {
+      return "indeterminate";
+    }
+    context.inspectedProperties += 1;
+    if (!Object.prototype.hasOwnProperty.call(left, key)) continue;
+    leftPropertyCount += 1;
+    if (!Object.prototype.hasOwnProperty.call(right, key)) return "different";
+    const leftDescriptor = Object.getOwnPropertyDescriptor(left, key);
+    const rightDescriptor = Object.getOwnPropertyDescriptor(right, key);
+    if (!leftDescriptor || !rightDescriptor || !("value" in leftDescriptor) || !("value" in rightDescriptor)) {
+      return "indeterminate";
+    }
+    const comparison = compareLoadedDataValue(
+      leftDescriptor.value,
+      rightDescriptor.value,
+      depth + 1,
+      context
+    );
+    if (comparison !== "equal") return comparison;
+  }
+  let rightPropertyCount = 0;
+  for (const key in right) {
+    if (context.inspectedProperties >= LOADED_DATA_COMPARISON_MAX_PROPERTIES) {
+      return "indeterminate";
+    }
+    context.inspectedProperties += 1;
+    if (Object.prototype.hasOwnProperty.call(right, key)) rightPropertyCount += 1;
+  }
+  return leftPropertyCount === rightPropertyCount ? "equal" : "different";
+}
+function compareLoadedDataValue(left, right, depth, context) {
+  if (Object.is(left, right)) return "equal";
+  const leftType = typeof left;
+  const rightType = typeof right;
+  if (leftType !== rightType || left === null || right === null) return "different";
+  if (leftType === "function" || leftType === "symbol") return "indeterminate";
+  if (leftType !== "object") return "different";
+  const leftObject = left;
+  const rightObject = right;
+  const pairedRight = context.leftToRight.get(leftObject);
+  const pairedLeft = context.rightToLeft.get(rightObject);
+  if (pairedRight || pairedLeft) {
+    return pairedRight === rightObject && pairedLeft === leftObject ? "equal" : "different";
+  }
+  if (depth >= LOADED_DATA_COMPARISON_MAX_DEPTH) return "indeterminate";
+  if (context.comparedObjects >= LOADED_DATA_COMPARISON_MAX_OBJECTS) {
+    return "indeterminate";
+  }
+  const leftIsArray = Array.isArray(leftObject);
+  const rightIsArray = Array.isArray(rightObject);
+  if (leftIsArray !== rightIsArray) return "different";
+  if (leftIsArray && leftObject.length !== rightObject.length) {
+    return "different";
+  }
+  if (!leftIsArray) {
+    const leftIsPlainRecord = isPlainRecord(leftObject);
+    const rightIsPlainRecord = isPlainRecord(rightObject);
+    if (leftIsPlainRecord !== rightIsPlainRecord) return "different";
+    if (!leftIsPlainRecord) return "indeterminate";
+  }
+  context.comparedObjects += 1;
+  context.leftToRight.set(leftObject, rightObject);
+  context.rightToLeft.set(rightObject, leftObject);
+  return compareLoadedDataProperties(leftObject, rightObject, depth, context);
+}
+function compareLoadedData(left, right) {
+  try {
+    return compareLoadedDataValue(left, right, 0, {
+      comparedObjects: 0,
+      inspectedProperties: 0,
+      leftToRight: /* @__PURE__ */ new WeakMap(),
+      rightToLeft: /* @__PURE__ */ new WeakMap()
+    });
+  } catch {
+    return "indeterminate";
+  }
+}
+function useStableLoadedData(loadedData) {
+  const stableLoadedData = useRef(loadedData);
+  const pendingLoadedData = useRef(NO_PENDING_LOADED_DATA);
+  const comparison = compareLoadedData(stableLoadedData.current, loadedData);
+  if (comparison === "equal") {
+    pendingLoadedData.current = NO_PENDING_LOADED_DATA;
+    return { loadedData: stableLoadedData.current, comparisonError: null };
+  }
+  if (comparison === "different" || pendingLoadedData.current === loadedData) {
+    stableLoadedData.current = loadedData;
+    pendingLoadedData.current = NO_PENDING_LOADED_DATA;
+    return { loadedData, comparisonError: null };
+  }
+  pendingLoadedData.current = loadedData;
+  return {
+    loadedData: stableLoadedData.current,
+    comparisonError: LOADED_DATA_COMPARISON_ERROR
+  };
+}
 async function executeVariantLoaders(loaders, loadedData) {
   const hasLoaders = !!loaders && loaders.length > 0;
   if (!hasLoaders) {
@@ -46,33 +168,47 @@ async function resolvePreviewRuntimeState(options) {
   }
 }
 function usePreviewVariantRuntime(options) {
-  const { variant, loadedData } = options;
-  const [state, setState] = useState(EMPTY_STATE);
+  const { variant } = options;
+  const { loadedData, comparisonError } = useStableLoadedData(options.loadedData);
+  const [resolution, setResolution] = useState({
+    variant: null,
+    loadedData: void 0,
+    state: EMPTY_STATE
+  });
   useEffect(() => {
     let cancelled = false;
     if (!variant) {
-      setState(EMPTY_STATE);
+      setResolution({ variant: null, loadedData, state: EMPTY_STATE });
       return () => {
         cancelled = true;
       };
     }
-    const hasLoaders = !!variant.loaders && variant.loaders.length > 0;
-    setState({
-      content: null,
-      isLoading: hasLoaders,
-      error: null,
-      loadedData: void 0
-    });
+    if (comparisonError) {
+      setResolution({ variant, loadedData, state: LOADED_DATA_COMPARISON_ERROR_STATE });
+      return () => {
+        cancelled = true;
+      };
+    }
+    setResolution({ variant, loadedData, state: LOADING_STATE });
     resolvePreviewRuntimeState({ variant, loadedData }).then((nextState) => {
       if (!cancelled) {
-        setState(nextState);
+        setResolution({ variant, loadedData, state: nextState });
       }
     });
     return () => {
       cancelled = true;
     };
-  }, [variant, loadedData]);
-  return state;
+  }, [variant, loadedData, comparisonError]);
+  if (!variant) {
+    return EMPTY_STATE;
+  }
+  if (comparisonError) {
+    return LOADED_DATA_COMPARISON_ERROR_STATE;
+  }
+  if (resolution.variant !== variant || resolution.loadedData !== loadedData) {
+    return LOADING_STATE;
+  }
+  return resolution.state;
 }
 function PreviewVariantRuntime({
   variant,

package/dist/preview-runtime.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/preview-runtime.tsx"],"sourcesContent":["import { useEffect, useState, type ReactNode } from \"react\";\nimport type { VariantLoader, VariantRenderOptions } from \"./types.js\";\n\n/**\n * Minimal contract for rendering a preview variant.\n * Compatible with fragment variants and Storybook-adapted variants.\n */\nexport interface PreviewVariantLike {\n  render: (options?: VariantRenderOptions) => ReactNode;\n  loaders?: VariantLoader[];\n}\n\nexport interface PreviewRuntimeState {\n  content: ReactNode | null;\n  isLoading: boolean;\n  error: Error | null;\n  loadedData?: Record<string, unknown>;\n}\n\nexport interface PreviewRuntimeOptions {\n  variant?: PreviewVariantLike | null;\n  loadedData?: Record<string, unknown>;\n}\n\nconst EMPTY_STATE: PreviewRuntimeState = {\n  content: null,\n  isLoading: false,\n  error: null,\n  loadedData: undefined,\n};\n\nfunction toError(error: unknown): Error {\n  return error instanceof Error ? error : new Error(String(error));\n}\n\n/**\n * Execute all variant loaders and merge their payloads.\n * `loadedData` is applied last so host-level overrides win.\n */\nexport async function executeVariantLoaders(\n  loaders: VariantLoader[] | undefined,\n  loadedData?: Record<string, unknown>,\n): Promise<Record<string, unknown> | undefined> {\n  const hasLoaders = !!loaders && loaders.length > 0;\n  if (!hasLoaders) {\n    return loadedData;\n  }\n\n  const results = await Promise.all(loaders.map((loader) => loader()));\n  const mergedFromLoaders = results.reduce<Record<string, unknown>>(\n    (acc, result) => ({ ...acc, ...result }),\n    {},\n  );\n\n  return loadedData ? { ...mergedFromLoaders, ...loadedData } : mergedFromLoaders;\n}\n\n/**\n * Resolve a full runtime state (loader execution + render) in one async call.\n * This is useful for testing and for hook/component orchestration.\n */\nexport async function resolvePreviewRuntimeState(\n  options: PreviewRuntimeOptions,\n): Promise<PreviewRuntimeState> {\n  const { variant, loadedData } = options;\n  if (!variant) {\n    return EMPTY_STATE;\n  }\n\n  try {\n    const mergedLoadedData = await executeVariantLoaders(variant.loaders, loadedData);\n    const content = variant.render({ loadedData: mergedLoadedData });\n    return {\n      content,\n      isLoading: false,\n      error: null,\n      loadedData: mergedLoadedData,\n    };\n  } catch (error) {\n    return {\n      content: null,\n      isLoading: false,\n      error: toError(error),\n      loadedData: undefined,\n    };\n  }\n}\n\n/**\n * Hook for rendering a preview variant with loader support.\n */\nexport function usePreviewVariantRuntime(\n  options: PreviewRuntimeOptions,\n): PreviewRuntimeState {\n  const { variant, loadedData } = options;\n  const [state, setState] = useState<PreviewRuntimeState>(EMPTY_STATE);\n\n  useEffect(() => {\n    let cancelled = false;\n\n    if (!variant) {\n      setState(EMPTY_STATE);\n      return () => {\n        cancelled = true;\n      };\n    }\n\n    const hasLoaders = !!variant.loaders && variant.loaders.length > 0;\n    setState({\n      content: null,\n      isLoading: hasLoaders,\n      error: null,\n      loadedData: undefined,\n    });\n\n    resolvePreviewRuntimeState({ variant, loadedData }).then((nextState) => {\n      if (!cancelled) {\n        setState(nextState);\n      }\n    });\n\n    return () => {\n      cancelled = true;\n    };\n  }, [variant, loadedData]);\n\n  return state;\n}\n\ninterface PreviewVariantRuntimeProps extends PreviewRuntimeOptions {\n  children: (state: PreviewRuntimeState) => ReactNode;\n}\n\n/**\n * Render-prop component wrapper around `usePreviewVariantRuntime`.\n */\nexport function PreviewVariantRuntime({\n  variant,\n  loadedData,\n  children,\n}: PreviewVariantRuntimeProps) {\n  const state = usePreviewVariantRuntime({ variant, loadedData });\n  return <>{children(state)}</>;\n}\n"],"mappings":";AAAA,SAAS,WAAW,gBAAgC;AA8I3C;AAtHT,IAAM,cAAmC;AAAA,EACvC,SAAS;AAAA,EACT,WAAW;AAAA,EACX,OAAO;AAAA,EACP,YAAY;AACd;AAEA,SAAS,QAAQ,OAAuB;AACtC,SAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AACjE;AAMA,eAAsB,sBACpB,SACA,YAC8C;AAC9C,QAAM,aAAa,CAAC,CAAC,WAAW,QAAQ,SAAS;AACjD,MAAI,CAAC,YAAY;AACf,WAAO;AAAA,EACT;AAEA,QAAM,UAAU,MAAM,QAAQ,IAAI,QAAQ,IAAI,CAAC,WAAW,OAAO,CAAC,CAAC;AACnE,QAAM,oBAAoB,QAAQ;AAAA,IAChC,CAAC,KAAK,YAAY,EAAE,GAAG,KAAK,GAAG,OAAO;AAAA,IACtC,CAAC;AAAA,EACH;AAEA,SAAO,aAAa,EAAE,GAAG,mBAAmB,GAAG,WAAW,IAAI;AAChE;AAMA,eAAsB,2BACpB,SAC8B;AAC9B,QAAM,EAAE,SAAS,WAAW,IAAI;AAChC,MAAI,CAAC,SAAS;AACZ,WAAO;AAAA,EACT;AAEA,MAAI;AACF,UAAM,mBAAmB,MAAM,sBAAsB,QAAQ,SAAS,UAAU;AAChF,UAAM,UAAU,QAAQ,OAAO,EAAE,YAAY,iBAAiB,CAAC;AAC/D,WAAO;AAAA,MACL;AAAA,MACA,WAAW;AAAA,MACX,OAAO;AAAA,MACP,YAAY;AAAA,IACd;AAAA,EACF,SAAS,OAAO;AACd,WAAO;AAAA,MACL,SAAS;AAAA,MACT,WAAW;AAAA,MACX,OAAO,QAAQ,KAAK;AAAA,MACpB,YAAY;AAAA,IACd;AAAA,EACF;AACF;AAKO,SAAS,yBACd,SACqB;AACrB,QAAM,EAAE,SAAS,WAAW,IAAI;AAChC,QAAM,CAAC,OAAO,QAAQ,IAAI,SAA8B,WAAW;AAEnE,YAAU,MAAM;AACd,QAAI,YAAY;AAEhB,QAAI,CAAC,SAAS;AACZ,eAAS,WAAW;AACpB,aAAO,MAAM;AACX,oBAAY;AAAA,MACd;AAAA,IACF;AAEA,UAAM,aAAa,CAAC,CAAC,QAAQ,WAAW,QAAQ,QAAQ,SAAS;AACjE,aAAS;AAAA,MACP,SAAS;AAAA,MACT,WAAW;AAAA,MACX,OAAO;AAAA,MACP,YAAY;AAAA,IACd,CAAC;AAED,+BAA2B,EAAE,SAAS,WAAW,CAAC,EAAE,KAAK,CAAC,cAAc;AACtE,UAAI,CAAC,WAAW;AACd,iBAAS,SAAS;AAAA,MACpB;AAAA,IACF,CAAC;AAED,WAAO,MAAM;AACX,kBAAY;AAAA,IACd;AAAA,EACF,GAAG,CAAC,SAAS,UAAU,CAAC;AAExB,SAAO;AACT;AASO,SAAS,sBAAsB;AAAA,EACpC;AAAA,EACA;AAAA,EACA;AACF,GAA+B;AAC7B,QAAM,QAAQ,yBAAyB,EAAE,SAAS,WAAW,CAAC;AAC9D,SAAO,gCAAG,mBAAS,KAAK,GAAE;AAC5B;","names":[]}
+{"version":3,"sources":["../src/preview-runtime.tsx"],"sourcesContent":["import { useEffect, useRef, useState, type ReactNode } from \"react\";\nimport type { VariantLoader, VariantRenderOptions } from \"./types.js\";\n\n/**\n * Minimal contract for rendering a preview variant.\n * Compatible with fragment variants and Storybook-adapted variants.\n */\nexport interface PreviewVariantLike {\n  render: (options?: VariantRenderOptions) => ReactNode;\n  loaders?: VariantLoader[];\n}\n\nexport interface PreviewRuntimeState {\n  content: ReactNode | null;\n  isLoading: boolean;\n  error: Error | null;\n  loadedData?: Record<string, unknown>;\n}\n\nexport interface PreviewRuntimeOptions {\n  variant?: PreviewVariantLike | null;\n  loadedData?: Record<string, unknown>;\n}\n\nconst EMPTY_STATE: PreviewRuntimeState = {\n  content: null,\n  isLoading: false,\n  error: null,\n  loadedData: undefined,\n};\n\nconst LOADING_STATE: PreviewRuntimeState = {\n  content: null,\n  isLoading: true,\n  error: null,\n  loadedData: undefined,\n};\n\nconst LOADED_DATA_COMPARISON_MAX_DEPTH = 32;\nconst LOADED_DATA_COMPARISON_MAX_OBJECTS = 1_000;\nconst LOADED_DATA_COMPARISON_MAX_PROPERTIES = 4_000;\n\nconst LOADED_DATA_COMPARISON_ERROR = new Error(\n  \"Preview loadedData could not be compared safely. Pass a stable object reference, or use \" +\n    `JSON-like data within ${LOADED_DATA_COMPARISON_MAX_DEPTH} levels, ` +\n    `${LOADED_DATA_COMPARISON_MAX_OBJECTS} objects, and ` +\n    `${LOADED_DATA_COMPARISON_MAX_PROPERTIES} property inspections.`\n);\n\nconst LOADED_DATA_COMPARISON_ERROR_STATE: PreviewRuntimeState = {\n  content: null,\n  isLoading: false,\n  error: LOADED_DATA_COMPARISON_ERROR,\n  loadedData: undefined,\n};\n\ninterface PreviewRuntimeResolution {\n  variant: PreviewVariantLike | null;\n  loadedData?: Record<string, unknown>;\n  state: PreviewRuntimeState;\n}\n\nfunction toError(error: unknown): Error {\n  return error instanceof Error ? error : new Error(String(error));\n}\n\ntype LoadedDataComparison = \"equal\" | \"different\" | \"indeterminate\";\nconst NO_PENDING_LOADED_DATA = Symbol(\"no-pending-loaded-data\");\n\ninterface LoadedDataComparisonContext {\n  comparedObjects: number;\n  inspectedProperties: number;\n  leftToRight: WeakMap<object, object>;\n  rightToLeft: WeakMap<object, object>;\n}\n\nfunction isPlainRecord(value: object): value is Record<string, unknown> {\n  const prototype = Object.getPrototypeOf(value);\n  return prototype === Object.prototype || prototype === null;\n}\n\nfunction compareLoadedDataProperties(\n  left: object,\n  right: object,\n  depth: number,\n  context: LoadedDataComparisonContext\n): LoadedDataComparison {\n  let leftPropertyCount = 0;\n  for (const key in left) {\n    if (context.inspectedProperties >= LOADED_DATA_COMPARISON_MAX_PROPERTIES) {\n      return \"indeterminate\";\n    }\n    context.inspectedProperties += 1;\n\n    if (!Object.prototype.hasOwnProperty.call(left, key)) continue;\n    leftPropertyCount += 1;\n    if (!Object.prototype.hasOwnProperty.call(right, key)) return \"different\";\n\n    const leftDescriptor = Object.getOwnPropertyDescriptor(left, key);\n    const rightDescriptor = Object.getOwnPropertyDescriptor(right, key);\n    if (\n      !leftDescriptor ||\n      !rightDescriptor ||\n      !(\"value\" in leftDescriptor) ||\n      !(\"value\" in rightDescriptor)\n    ) {\n      return \"indeterminate\";\n    }\n\n    const comparison = compareLoadedDataValue(\n      leftDescriptor.value,\n      rightDescriptor.value,\n      depth + 1,\n      context\n    );\n    if (comparison !== \"equal\") return comparison;\n  }\n\n  let rightPropertyCount = 0;\n  for (const key in right) {\n    if (context.inspectedProperties >= LOADED_DATA_COMPARISON_MAX_PROPERTIES) {\n      return \"indeterminate\";\n    }\n    context.inspectedProperties += 1;\n    if (Object.prototype.hasOwnProperty.call(right, key)) rightPropertyCount += 1;\n  }\n\n  return leftPropertyCount === rightPropertyCount ? \"equal\" : \"different\";\n}\n\nfunction compareLoadedDataValue(\n  left: unknown,\n  right: unknown,\n  depth: number,\n  context: LoadedDataComparisonContext\n): LoadedDataComparison {\n  if (Object.is(left, right)) return \"equal\";\n\n  const leftType = typeof left;\n  const rightType = typeof right;\n  if (leftType !== rightType || left === null || right === null) return \"different\";\n  if (leftType === \"function\" || leftType === \"symbol\") return \"indeterminate\";\n  if (leftType !== \"object\") return \"different\";\n\n  const leftObject = left as object;\n  const rightObject = right as object;\n  const pairedRight = context.leftToRight.get(leftObject);\n  const pairedLeft = context.rightToLeft.get(rightObject);\n  if (pairedRight || pairedLeft) {\n    return pairedRight === rightObject && pairedLeft === leftObject ? \"equal\" : \"different\";\n  }\n\n  if (depth >= LOADED_DATA_COMPARISON_MAX_DEPTH) return \"indeterminate\";\n  if (context.comparedObjects >= LOADED_DATA_COMPARISON_MAX_OBJECTS) {\n    return \"indeterminate\";\n  }\n\n  const leftIsArray = Array.isArray(leftObject);\n  const rightIsArray = Array.isArray(rightObject);\n  if (leftIsArray !== rightIsArray) return \"different\";\n  if (leftIsArray && (leftObject as unknown[]).length !== (rightObject as unknown[]).length) {\n    return \"different\";\n  }\n  if (!leftIsArray) {\n    const leftIsPlainRecord = isPlainRecord(leftObject);\n    const rightIsPlainRecord = isPlainRecord(rightObject);\n    if (leftIsPlainRecord !== rightIsPlainRecord) return \"different\";\n    if (!leftIsPlainRecord) return \"indeterminate\";\n  }\n\n  context.comparedObjects += 1;\n  context.leftToRight.set(leftObject, rightObject);\n  context.rightToLeft.set(rightObject, leftObject);\n\n  return compareLoadedDataProperties(leftObject, rightObject, depth, context);\n}\n\nfunction compareLoadedData(\n  left: Record<string, unknown> | undefined,\n  right: Record<string, unknown> | undefined\n): LoadedDataComparison {\n  try {\n    return compareLoadedDataValue(left, right, 0, {\n      comparedObjects: 0,\n      inspectedProperties: 0,\n      leftToRight: new WeakMap(),\n      rightToLeft: new WeakMap(),\n    });\n  } catch {\n    // Host data must not make render fail when an accessor or proxy cannot be inspected safely.\n    return \"indeterminate\";\n  }\n}\n\ninterface StableLoadedDataResult {\n  loadedData: Record<string, unknown> | undefined;\n  comparisonError: Error | null;\n}\n\nfunction useStableLoadedData(\n  loadedData: Record<string, unknown> | undefined\n): StableLoadedDataResult {\n  const stableLoadedData = useRef(loadedData);\n  const pendingLoadedData = useRef<\n    Record<string, unknown> | undefined | typeof NO_PENDING_LOADED_DATA\n  >(NO_PENDING_LOADED_DATA);\n  const comparison = compareLoadedData(stableLoadedData.current, loadedData);\n\n  if (comparison === \"equal\") {\n    pendingLoadedData.current = NO_PENDING_LOADED_DATA;\n    return { loadedData: stableLoadedData.current, comparisonError: null };\n  }\n\n  if (comparison === \"different\" || pendingLoadedData.current === loadedData) {\n    stableLoadedData.current = loadedData;\n    pendingLoadedData.current = NO_PENDING_LOADED_DATA;\n    return { loadedData, comparisonError: null };\n  }\n\n  pendingLoadedData.current = loadedData;\n  return {\n    loadedData: stableLoadedData.current,\n    comparisonError: LOADED_DATA_COMPARISON_ERROR,\n  };\n}\n\n/**\n * Execute all variant loaders and merge their payloads.\n * `loadedData` is applied last so host-level overrides win.\n */\nexport async function executeVariantLoaders(\n  loaders: VariantLoader[] | undefined,\n  loadedData?: Record<string, unknown>\n): Promise<Record<string, unknown> | undefined> {\n  const hasLoaders = !!loaders && loaders.length > 0;\n  if (!hasLoaders) {\n    return loadedData;\n  }\n\n  const results = await Promise.all(loaders.map((loader) => loader()));\n  const mergedFromLoaders = results.reduce<Record<string, unknown>>(\n    (acc, result) => ({ ...acc, ...result }),\n    {}\n  );\n\n  return loadedData ? { ...mergedFromLoaders, ...loadedData } : mergedFromLoaders;\n}\n\n/**\n * Resolve a full runtime state (loader execution + render) in one async call.\n * This is useful for testing and for hook/component orchestration.\n */\nexport async function resolvePreviewRuntimeState(\n  options: PreviewRuntimeOptions\n): Promise<PreviewRuntimeState> {\n  const { variant, loadedData } = options;\n  if (!variant) {\n    return EMPTY_STATE;\n  }\n\n  try {\n    const mergedLoadedData = await executeVariantLoaders(variant.loaders, loadedData);\n    const content = variant.render({ loadedData: mergedLoadedData });\n    return {\n      content,\n      isLoading: false,\n      error: null,\n      loadedData: mergedLoadedData,\n    };\n  } catch (error) {\n    return {\n      content: null,\n      isLoading: false,\n      error: toError(error),\n      loadedData: undefined,\n    };\n  }\n}\n\n/**\n * Hook for rendering a preview variant with loader support.\n */\nexport function usePreviewVariantRuntime(options: PreviewRuntimeOptions): PreviewRuntimeState {\n  const { variant } = options;\n  const { loadedData, comparisonError } = useStableLoadedData(options.loadedData);\n  const [resolution, setResolution] = useState<PreviewRuntimeResolution>({\n    variant: null,\n    loadedData: undefined,\n    state: EMPTY_STATE,\n  });\n\n  useEffect(() => {\n    let cancelled = false;\n\n    if (!variant) {\n      setResolution({ variant: null, loadedData, state: EMPTY_STATE });\n      return () => {\n        cancelled = true;\n      };\n    }\n\n    if (comparisonError) {\n      setResolution({ variant, loadedData, state: LOADED_DATA_COMPARISON_ERROR_STATE });\n      return () => {\n        cancelled = true;\n      };\n    }\n\n    setResolution({ variant, loadedData, state: LOADING_STATE });\n\n    resolvePreviewRuntimeState({ variant, loadedData }).then((nextState) => {\n      if (!cancelled) {\n        setResolution({ variant, loadedData, state: nextState });\n      }\n    });\n\n    return () => {\n      cancelled = true;\n    };\n  }, [variant, loadedData, comparisonError]);\n\n  if (!variant) {\n    return EMPTY_STATE;\n  }\n\n  if (comparisonError) {\n    return LOADED_DATA_COMPARISON_ERROR_STATE;\n  }\n\n  if (resolution.variant !== variant || resolution.loadedData !== loadedData) {\n    return LOADING_STATE;\n  }\n\n  return resolution.state;\n}\n\ninterface PreviewVariantRuntimeProps extends PreviewRuntimeOptions {\n  children: (state: PreviewRuntimeState) => ReactNode;\n}\n\n/**\n * Render-prop component wrapper around `usePreviewVariantRuntime`.\n */\nexport function PreviewVariantRuntime({\n  variant,\n  loadedData,\n  children,\n}: PreviewVariantRuntimeProps) {\n  const state = usePreviewVariantRuntime({ variant, loadedData });\n  return <>{children(state)}</>;\n}\n"],"mappings":"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","names":[]}

package/dist/react-types.d.ts

@@ -1,8 +1,7 @@
 import { ComponentType, ReactNode, JSX } from 'react';
-export { F as FragmentDefinition, b as FragmentDefinitionV2 } from './governance-CLk_wkP9.js';
+export { F as FragmentDefinition, a as FragmentDefinitionV2 } from './governance-hOPXGbbs.js';
 import 'zod';
 import './topology/index.js';
-import './types-xJ2xyp_G.js';
 
 /**
  * React-specific types for Fragments.