@kubuild/core 0.7.0 → 0.8.0

package/dist/document/command-tree-utils.d.ts

@@ -52,9 +52,30 @@ export interface ClonedSubtreeResult {
     clonedNode: Node;
     idMap: Map<string, string>;
 }
+/**
+ * Keys (in step payloads, legacy `props.action.payload`, and node props) whose string value
+ * is a reference to another node's id. When a subtree is cloned with fresh ids, references
+ * that point at a node *inside* that subtree are rewritten to the clone's new id; references
+ * to nodes outside the subtree are left untouched.
+ */
+export declare const NODE_ID_REFERENCE_KEYS: ReadonlySet<string>;
+/**
+ * Rewrites node-id references inside a single (already cloned) node so they follow `idMap`.
+ * Covers action pipeline step payloads (incl. onSuccess/onError branches), `formConfig.formId`,
+ * id-reference props (e.g. `modalId`, `formId`), `#anchor` hrefs, and the legacy `props.action`
+ * payload. Mutates the node in place; callers must pass a clone they own.
+ */
+export declare function remapNodeReferences(node: Node, idMap: ReadonlyMap<string, string>): void;
+/**
+ * Deep-clones a node subtree assigning every node a fresh id via `idGen`, preserving every
+ * other `Node` field (props, styles, animation, actions, formConfig, and any future field),
+ * then rewrites intra-subtree node-id references (see {@link remapNodeReferences}).
+ */
+export declare function cloneNodeTreeWithFreshIds(root: Node, idGen: (oldId: string, node: Node) => string): ClonedSubtreeResult;
 /**
  * Recursively clone a node and its entire subtree, generating fresh unique IDs
- * for every node while preserving types, props, and responsive styles.
+ * for every node while preserving every other node field (props, styles, animation,
+ * actions, formConfig) and remapping intra-subtree node-id references.
  */
 export declare function cloneTreeWithNewIds(root: Node, idGenerator?: (oldId: string) => string, existingIds?: Set<string>): ClonedSubtreeResult;
 //# sourceMappingURL=command-tree-utils.d.ts.map

package/dist/document/command-tree-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-tree-utils.d.ts","sourceRoot":"","sources":["../../src/document/command-tree-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAkB,MAAM,iBAAiB,CAAC;AAEvD;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAEtC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,IAAI,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAUlF;AA0BD,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,OAAO,GAAG,kBAAkB,GAAG,cAAc,CAAC;AAE3F;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,mBAAmB,GAC7B,MAAM,GAAG,IAAI,CAkBf;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAcvE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAc3E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,CAgBrE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAgB5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAExD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAenF;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,IAAI,CAAC;IACjB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,EACV,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,EACvC,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACxB,mBAAmB,CAyBrB"}
+{"version":3,"file":"command-tree-utils.d.ts","sourceRoot":"","sources":["../../src/document/command-tree-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAmC,MAAM,iBAAiB,CAAC;AAExE;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAEtC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,IAAI,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAUlF;AA0BD,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,OAAO,GAAG,kBAAkB,GAAG,cAAc,CAAC;AAE3F;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,mBAAmB,GAC7B,MAAM,GAAG,IAAI,CAkBf;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAcvE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAc3E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,CAgBrE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAgB5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAExD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAenF;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,IAAI,CAAC;IACjB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5B;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,MAAM,CAQrD,CAAC;AAsCH;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAsBxF;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,KAAK,MAAM,GAC3C,mBAAmB,CAuBrB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,EACV,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,EACvC,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACxB,mBAAmB,CAGrB"}

package/dist/document/commands.d.ts

@@ -1,5 +1,5 @@
-import { PageDocument, Node, ResponsiveStyles, StyleDefinition, AnimationConfig, ActionPipeline, FormConfig } from '@kubuild/schema';
-export type DocumentChangeType = 'NODE_INSERTED' | 'NODE_MOVED' | 'PROPS_UPDATED' | 'STYLE_UPDATED' | 'ANIMATION_UPDATED' | 'ACTIONS_UPDATED' | 'FORM_CONFIG_UPDATED' | 'NODE_REMOVED' | 'NODE_DUPLICATED' | 'NODE_WRAPPED' | 'NODE_UNGROUPED' | 'NODE_REPLACED';
+import { PageDocument, Node, ResponsiveStyles, StyleDefinition, AnimationConfig, ActionPipeline, FormConfig, Theme } from '@kubuild/schema';
+export type DocumentChangeType = 'NODE_INSERTED' | 'NODE_MOVED' | 'PROPS_UPDATED' | 'STYLE_UPDATED' | 'ANIMATION_UPDATED' | 'ACTIONS_UPDATED' | 'FORM_CONFIG_UPDATED' | 'NODE_REMOVED' | 'NODE_DUPLICATED' | 'NODE_WRAPPED' | 'NODE_UNGROUPED' | 'NODE_REPLACED' | 'THEME_UPDATED';
 export interface DocumentChangeEvent {
     type: DocumentChangeType;
     timestamp: string;
@@ -184,4 +184,21 @@ export declare function ungroupNodeFrame(document: PageDocument, params: Ungroup
  * Returns a new PageDocument and a NODE_REPLACED event.
  */
 export declare function replaceNode(document: PageDocument, params: ReplaceNodeParams): CommandResult;
+export interface UpdateThemeParams {
+    /**
+     * Token changes. With `merge` (default) each group is merged token-by-token and a token
+     * set to `null` is removed; without `merge` the theme is replaced. `null` removes the
+     * whole theme.
+     */
+    theme: {
+        [G in keyof Theme]?: Record<string, string | number | null> | null;
+    } | null;
+    merge?: boolean;
+}
+/**
+ * Update the document-level design tokens (`PageDocument.theme`, STORA-551).
+ * The result is validated with `ThemeSchema`, so unsafe keys/values (CSS injection) throw.
+ * Returns a new PageDocument and a THEME_UPDATED event keyed to the root node.
+ */
+export declare function updateTheme(document: PageDocument, params: UpdateThemeParams): CommandResult;
 //# sourceMappingURL=commands.d.ts.map

package/dist/document/commands.d.ts.map

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

package/dist/index.cjs

@@ -30,6 +30,7 @@ __export(index_exports, {
   DocumentHistoryManager: () => DocumentHistoryManager,
   HistoryEngine: () => HistoryEngine,
   MigrationRegistry: () => MigrationRegistry,
+  NODE_ID_REFERENCE_KEYS: () => NODE_ID_REFERENCE_KEYS,
   RuntimeStateStore: () => RuntimeStateStore,
   addArtboard: () => addArtboard,
   applyFieldTransform: () => applyFieldTransform,
@@ -37,7 +38,9 @@ __export(index_exports, {
   buildSampleVariablesFromCatalog: () => buildSampleVariablesFromCatalog,
   calculateChecksum: () => calculateChecksum,
   canMigrate: () => canMigrate,
+  canonicalizeTextPropsInPlace: () => canonicalizeTextPropsInPlace,
   checkZipBomb: () => checkZipBomb,
+  cloneNodeTreeWithFreshIds: () => cloneNodeTreeWithFreshIds,
   cloneTemplateAsPage: () => cloneTemplateAsPage,
   cloneTreeWithNewIds: () => cloneTreeWithNewIds,
   collectArtboardReferenceNodes: () => collectArtboardReferenceNodes,
@@ -114,6 +117,7 @@ __export(index_exports, {
   previewImportPackage: () => previewImportPackage,
   remapAssetReferences: () => remapAssetReferences,
   remapDocumentAssetReferences: () => remapDocumentAssetReferences,
+  remapNodeReferences: () => remapNodeReferences,
   removeArtboard: () => removeArtboard,
   removeNode: () => removeNode,
   renameArtboard: () => renameArtboard,
@@ -141,6 +145,7 @@ __export(index_exports, {
   updateFormConfig: () => updateFormConfig,
   updateProps: () => updateProps,
   updateStyle: () => updateStyle,
+  updateTheme: () => updateTheme,
   validateDocument: () => validateDocument,
   validateDocumentSecurity: () => validateDocumentSecurity,
   validateFieldValue: () => validateFieldValue,
@@ -472,26 +477,84 @@ function defaultIdGenerator(oldId, existingIds) {
   }
   return candidate;
 }
-function cloneTreeWithNewIds(root, idGenerator, existingIds) {
+var NODE_ID_REFERENCE_KEYS = /* @__PURE__ */ new Set([
+  "modalId",
+  "modalNodeId",
+  "targetModalId",
+  "targetNodeId",
+  "nodeId",
+  "formId",
+  "targetId"
+]);
+var ANCHOR_REFERENCE_KEYS = /* @__PURE__ */ new Set(["url", "href"]);
+function remapReferenceValue(key, value, idMap) {
+  if (typeof value !== "string") return value;
+  if (NODE_ID_REFERENCE_KEYS.has(key)) {
+    return idMap.get(value) ?? idMap.get(value.trim()) ?? value;
+  }
+  if (ANCHOR_REFERENCE_KEYS.has(key) && value.startsWith("#")) {
+    const mapped = idMap.get(value.slice(1));
+    return mapped ? `#${mapped}` : value;
+  }
+  return value;
+}
+function remapReferenceRecord(record, idMap) {
+  for (const [key, value] of Object.entries(record)) {
+    record[key] = remapReferenceValue(key, value, idMap);
+  }
+}
+function remapStepReferences(steps, idMap) {
+  if (!Array.isArray(steps)) return;
+  for (const step of steps) {
+    if (step.payload && typeof step.payload === "object") {
+      remapReferenceRecord(step.payload, idMap);
+    }
+    remapStepReferences(step.onSuccess, idMap);
+    remapStepReferences(step.onError, idMap);
+  }
+}
+function remapNodeReferences(node, idMap) {
+  if (node.props && typeof node.props === "object") {
+    remapReferenceRecord(node.props, idMap);
+    const legacyAction = node.props.action;
+    if (legacyAction && typeof legacyAction === "object" && legacyAction.payload && typeof legacyAction.payload === "object" && !Array.isArray(legacyAction.payload)) {
+      remapReferenceRecord(legacyAction.payload, idMap);
+    }
+  }
+  if (node.formConfig && typeof node.formConfig.formId === "string") {
+    node.formConfig.formId = idMap.get(node.formConfig.formId) ?? node.formConfig.formId;
+  }
+  if (Array.isArray(node.actions)) {
+    for (const pipeline of node.actions) {
+      remapStepReferences(pipeline.steps, idMap);
+    }
+  }
+}
+function cloneNodeTreeWithFreshIds(root, idGen) {
   const idMap = /* @__PURE__ */ new Map();
-  const idGen = idGenerator || ((oldId) => defaultIdGenerator(oldId, existingIds));
+  const clonedNodes = [];
   function cloneRecursive(node) {
-    const newId = idGen(node.id);
+    const newId = idGen(node.id, node);
     idMap.set(node.id, newId);
-    const clonedProps = node.props ? deepClone(node.props) : void 0;
-    const clonedStyles = node.styles ? deepClone(node.styles) : void 0;
-    const clonedChildren = node.children ? node.children.map((child) => cloneRecursive(child)) : [];
-    return {
+    const { children, ...rest } = node;
+    const cloned = {
+      ...deepClone(rest),
       id: newId,
-      type: node.type,
-      ...clonedProps ? { props: clonedProps } : {},
-      ...clonedStyles ? { styles: clonedStyles } : {},
-      children: clonedChildren
+      children: children ? children.map((child) => cloneRecursive(child)) : []
     };
+    clonedNodes.push(cloned);
+    return cloned;
   }
   const clonedNode = cloneRecursive(root);
+  for (const cloned of clonedNodes) {
+    remapNodeReferences(cloned, idMap);
+  }
   return { clonedNode, idMap };
 }
+function cloneTreeWithNewIds(root, idGenerator, existingIds) {
+  const idGen = idGenerator || ((oldId) => defaultIdGenerator(oldId, existingIds));
+  return cloneNodeTreeWithFreshIds(root, (oldId) => idGen(oldId));
+}
 
 // src/document/commands.ts
 var import_schema3 = require("@kubuild/schema");
@@ -1033,6 +1096,53 @@ function replaceNode(document, params) {
     }
   };
 }
+function updateTheme(document, params) {
+  const { theme, merge = true } = params;
+  const newDoc = deepClone(document);
+  const previousTheme = newDoc.theme ? deepClone(newDoc.theme) : void 0;
+  if (theme === null) {
+    delete newDoc.theme;
+  } else {
+    const next = {};
+    for (const group of import_schema3.THEME_TOKEN_GROUPS) {
+      const base = merge ? { ...previousTheme?.[group] ?? {} } : {};
+      const patch = theme[group];
+      if (patch === null) {
+        continue;
+      }
+      if (patch) {
+        for (const [key, value] of Object.entries(patch)) {
+          if (value === null) {
+            delete base[key];
+          } else {
+            base[key] = value;
+          }
+        }
+      }
+      if (Object.keys(base).length > 0) {
+        next[group] = base;
+      }
+    }
+    const parsed = import_schema3.ThemeSchema.parse(next);
+    if (Object.keys(parsed).length > 0) {
+      newDoc.theme = parsed;
+    } else {
+      delete newDoc.theme;
+    }
+  }
+  return {
+    document: newDoc,
+    event: {
+      type: "THEME_UPDATED",
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      nodeId: newDoc.document.id,
+      payload: {
+        theme: newDoc.theme,
+        previousTheme
+      }
+    }
+  };
+}
 
 // src/document/artboards.ts
 var import_schema4 = require("@kubuild/schema");
@@ -4396,6 +4506,56 @@ defaultMigrationRegistry.register({
     return migrated;
   }
 });
+function canonicalizeTextPropsInPlace(root, basePath = "document") {
+  const changed = [];
+  const walk2 = (value, path) => {
+    if (!value || typeof value !== "object" || Array.isArray(value)) return;
+    const node = value;
+    const props = node.props;
+    const rule = typeof node.type === "string" ? (0, import_schema9.getCanonicalTextPropRule)(node.type) : void 0;
+    if (rule && props && typeof props === "object" && !Array.isArray(props)) {
+      const record = props;
+      const presentAliases = rule.aliases.filter((alias) => record[alias] !== void 0);
+      if (presentAliases.length > 0) {
+        const displayedKey = rule.legacyReadOrder.find((key) => record[key] !== void 0);
+        if (node.type === "text" && displayedKey === "content" && record.as === void 0 && record.tag === void 0) {
+          record.as = "p";
+        }
+        if (displayedKey !== void 0 && displayedKey !== rule.canonical) {
+          record[rule.canonical] = record[displayedKey];
+        }
+        for (const alias of presentAliases) {
+          delete record[alias];
+          changed.push(`${path}.props.${alias}`);
+        }
+      }
+    }
+    if (Array.isArray(node.children)) {
+      node.children.forEach((child, index) => walk2(child, `${path}.children.${index}`));
+    }
+  };
+  walk2(root, basePath);
+  return changed;
+}
+defaultMigrationRegistry.register({
+  fromVersion: "1.1.0",
+  toVersion: "1.2.0",
+  description: "Rename deprecated text prop aliases to canonical names (heading/text/paragraph/link/badge/blockquote -> text, button -> label)",
+  migrate: (rawDoc, context) => {
+    const migrated = deepClone(rawDoc);
+    migrated.version = "1.2.0";
+    const changed = canonicalizeTextPropsInPlace(migrated.document);
+    if (changed.length > 0) {
+      context.warn({
+        code: "PROP_ALIAS_MIGRATED",
+        message: "Deprecated text prop aliases were renamed to their canonical names.",
+        step: "1.1.0->1.2.0",
+        paths: changed
+      });
+    }
+    return migrated;
+  }
+});
 function canMigrate(sourceVersion, targetVersion = import_schema9.CURRENT_SCHEMA_VERSION, registry = defaultMigrationRegistry) {
   if (!sourceVersion || !targetVersion) return false;
   if (sourceVersion === targetVersion) return true;
@@ -4500,6 +4660,16 @@ function migrateDocument(rawDocument, options = {}) {
     };
   }
   if (dryRun) {
+    const simulatedWarnings = [];
+    try {
+      let simulated = deepClone(doc);
+      for (let i = 0; i < path.length - 1; i++) {
+        const step = registry.getStep(path[i], path[i + 1]);
+        if (!step) break;
+        simulated = step.migrate(simulated, { warn: (w) => simulatedWarnings.push(w) });
+      }
+    } catch {
+    }
     return {
       success: true,
       diagnostic: {
@@ -4508,7 +4678,8 @@ function migrateDocument(rawDocument, options = {}) {
         targetVersion,
         migrationPath: path,
         stepsApplied: path.length - 1,
-        dryRun: true
+        dryRun: true,
+        ...simulatedWarnings.length > 0 ? { warnings: simulatedWarnings } : {}
       }
     };
   }
@@ -5324,6 +5495,18 @@ var importStoraPackage = importPackage;
 
 // src/io/load-project.ts
 var import_schema11 = require("@kubuild/schema");
+function migrateProjectArtboards(project) {
+  let changed = false;
+  const artboards = project.artboards.map((artboard) => {
+    const version = artboard.document.version;
+    if (version === import_schema11.CURRENT_SCHEMA_VERSION || !canMigrate(version)) return artboard;
+    const migration = migrateDocument(artboard.document);
+    if (!migration.success || !migration.document) return artboard;
+    changed = true;
+    return { ...artboard, document: migration.document };
+  });
+  return changed ? { ...project, artboards } : project;
+}
 var DEFAULT_PAGE_ARTBOARD_ID = "artboard-page-1";
 function wrapPageDocumentAsProject(document, options = {}) {
   const artboardId = options.artboardId ?? DEFAULT_PAGE_ARTBOARD_ID;
@@ -5373,7 +5556,7 @@ function loadProjectDocument(raw) {
     }
     return {
       success: true,
-      project: parsed.data,
+      project: migrateProjectArtboards(parsed.data),
       wrappedFromLegacyPage: false,
       errors: []
     };
@@ -5843,18 +6026,7 @@ function compareManifestsSemantically(expected, actual, options = {}) {
 
 // src/io/template-utils.ts
 var import_schema12 = require("@kubuild/schema");
-var CORE_BUILTIN_COMPONENTS = /* @__PURE__ */ new Set([
-  "page",
-  "section",
-  "container",
-  "columns",
-  "column",
-  "heading",
-  "text",
-  "image",
-  "button",
-  "collection"
-]);
+var CORE_BUILTIN_COMPONENTS = new Set(import_schema12.BUILTIN_COMPONENT_TYPES);
 function validateTemplate(value) {
   const parseResult = import_schema12.TemplateRecordSchema.safeParse(value);
   if (parseResult.success) {
@@ -5965,22 +6137,6 @@ function saveDraftAsTemplate(draft, metadata, options = {}) {
     custom: metadata.custom ? deepClone(metadata.custom) : void 0
   });
 }
-function cloneTreeWithFreshIds(root, idGen) {
-  function cloneRec(node) {
-    const newId = idGen(node.id, node);
-    const clonedProps = node.props ? deepClone(node.props) : void 0;
-    const clonedStyles = node.styles ? deepClone(node.styles) : void 0;
-    const clonedChildren = node.children ? node.children.map((child) => cloneRec(child)) : [];
-    return {
-      id: newId,
-      type: node.type,
-      ...clonedProps ? { props: clonedProps } : {},
-      ...clonedStyles ? { styles: clonedStyles } : {},
-      children: clonedChildren
-    };
-  }
-  return cloneRec(root);
-}
 function cloneTemplateAsPage(templateOrDoc, options = {}) {
   let sourceDoc;
   let templateOrigin = null;
@@ -6016,7 +6172,7 @@ function cloneTemplateAsPage(templateOrDoc, options = {}) {
     return candidate;
   };
   const idGen = options.idGenerator || defaultIdGen;
-  const clonedRootNode = cloneTreeWithFreshIds(sourceDoc.document, idGen);
+  const { clonedNode: clonedRootNode } = cloneNodeTreeWithFreshIds(sourceDoc.document, idGen);
   const rootPageNode = {
     ...clonedRootNode,
     type: "page"
@@ -6424,6 +6580,7 @@ function isFormValid(errors) {
   DocumentHistoryManager,
   HistoryEngine,
   MigrationRegistry,
+  NODE_ID_REFERENCE_KEYS,
   RuntimeStateStore,
   addArtboard,
   applyFieldTransform,
@@ -6431,7 +6588,9 @@ function isFormValid(errors) {
   buildSampleVariablesFromCatalog,
   calculateChecksum,
   canMigrate,
+  canonicalizeTextPropsInPlace,
   checkZipBomb,
+  cloneNodeTreeWithFreshIds,
   cloneTemplateAsPage,
   cloneTreeWithNewIds,
   collectArtboardReferenceNodes,
@@ -6508,6 +6667,7 @@ function isFormValid(errors) {
   previewImportPackage,
   remapAssetReferences,
   remapDocumentAssetReferences,
+  remapNodeReferences,
   removeArtboard,
   removeNode,
   renameArtboard,
@@ -6535,6 +6695,7 @@ function isFormValid(errors) {
   updateFormConfig,
   updateProps,
   updateStyle,
+  updateTheme,
   validateDocument,
   validateDocumentSecurity,
   validateFieldValue,