@kubuild/core 0.7.0 → 0.8.0

package/dist/index.js

@@ -316,26 +316,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
 import {
@@ -343,7 +401,9 @@ import {
   ResponsiveStylesSchema,
   AnimationConfigSchema,
   ActionPipelineSchema,
-  FormConfigSchema
+  FormConfigSchema,
+  ThemeSchema,
+  THEME_TOKEN_GROUPS
 } from "@kubuild/schema";
 function insertNode(document, params) {
   const { parentId, node, index } = params;
@@ -883,6 +943,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 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 = 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
 import {
@@ -4094,7 +4201,8 @@ import {
 // src/io/migration.ts
 import {
   CURRENT_SCHEMA_VERSION as CURRENT_SCHEMA_VERSION4,
-  SCHEMA_NAME as SCHEMA_NAME5
+  SCHEMA_NAME as SCHEMA_NAME5,
+  getCanonicalTextPropRule
 } from "@kubuild/schema";
 var MigrationRegistry = class {
   steps = /* @__PURE__ */ new Map();
@@ -4267,6 +4375,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" ? 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 = CURRENT_SCHEMA_VERSION4, registry = defaultMigrationRegistry) {
   if (!sourceVersion || !targetVersion) return false;
   if (sourceVersion === targetVersion) return true;
@@ -4371,6 +4529,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: {
@@ -4379,7 +4547,8 @@ function migrateDocument(rawDocument, options = {}) {
         targetVersion,
         migrationPath: path,
         stepsApplied: path.length - 1,
-        dryRun: true
+        dryRun: true,
+        ...simulatedWarnings.length > 0 ? { warnings: simulatedWarnings } : {}
       }
     };
   }
@@ -5198,8 +5367,21 @@ import {
   ProjectDocumentSchema,
   PROJECT_SCHEMA_NAME as PROJECT_SCHEMA_NAME2,
   CURRENT_PROJECT_SCHEMA_VERSION as CURRENT_PROJECT_SCHEMA_VERSION2,
+  CURRENT_SCHEMA_VERSION as CURRENT_SCHEMA_VERSION6,
   looksLikeProjectDocument
 } from "@kubuild/schema";
+function migrateProjectArtboards(project) {
+  let changed = false;
+  const artboards = project.artboards.map((artboard) => {
+    const version = artboard.document.version;
+    if (version === CURRENT_SCHEMA_VERSION6 || !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;
@@ -5249,7 +5431,7 @@ function loadProjectDocument(raw) {
     }
     return {
       success: true,
-      project: parsed.data,
+      project: migrateProjectArtboards(parsed.data),
       wrappedFromLegacyPage: false,
       errors: []
     };
@@ -5720,21 +5902,11 @@ function compareManifestsSemantically(expected, actual, options = {}) {
 // src/io/template-utils.ts
 import {
   TemplateRecordSchema,
+  BUILTIN_COMPONENT_TYPES,
   collectNodeIds as collectNodeIds2,
   isTemplateRecord
 } from "@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(BUILTIN_COMPONENT_TYPES);
 function validateTemplate(value) {
   const parseResult = TemplateRecordSchema.safeParse(value);
   if (parseResult.success) {
@@ -5845,22 +6017,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;
@@ -5896,7 +6052,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"
@@ -6307,6 +6463,7 @@ export {
   DocumentHistoryManager,
   HistoryEngine,
   MigrationRegistry,
+  NODE_ID_REFERENCE_KEYS,
   RuntimeStateStore,
   addArtboard,
   applyFieldTransform,
@@ -6314,7 +6471,9 @@ export {
   buildSampleVariablesFromCatalog,
   calculateChecksum,
   canMigrate,
+  canonicalizeTextPropsInPlace,
   checkZipBomb,
+  cloneNodeTreeWithFreshIds,
   cloneTemplateAsPage,
   cloneTreeWithNewIds,
   collectArtboardReferenceNodes,
@@ -6391,6 +6550,7 @@ export {
   previewImportPackage,
   remapAssetReferences,
   remapDocumentAssetReferences,
+  remapNodeReferences,
   removeArtboard,
   removeNode,
   renameArtboard,
@@ -6418,6 +6578,7 @@ export {
   updateFormConfig,
   updateProps,
   updateStyle,
+  updateTheme,
   validateDocument,
   validateDocumentSecurity,
   validateFieldValue,