@columnus/shared 0.1.47

package/dist/displayTemplateGenerator.d.ts

@@ -0,0 +1,11 @@
+import type { Manifest } from "./schemaTypes.ts";
+export type TemplateValidationError = {
+    table: string;
+    kind: "id" | "preview";
+    message: string;
+};
+export declare function validateDisplayTemplates(manifest: Manifest): TemplateValidationError[];
+/** Wrap single-line `return expr;` in String() so generated fns satisfy Promise<string>. */
+export declare function normalizeDisplayTemplateBody(body: string): string;
+export declare function normalizeManifestDisplayTemplates(manifest: Manifest): Manifest;
+export declare function generateDisplayValuesTs(manifest: Manifest): string;

package/dist/displayTemplateGenerator.js

@@ -0,0 +1,98 @@
+// packages/@columnus/shared/src/displayTemplateGenerator.ts
+var BANNER = `// AUTO-GENERATED by Columnus. Do not edit by hand \u2014
+// changes here will be overwritten when Columnus next saves the schema.
+// biome-ignore-all lint/correctness/noUnusedFunctionParameters: lookup is used by template bodies
+`;
+var WRAPPER_PREFIX = 'async (row: Record<string, unknown>, lookup: import("./_lib/displayTypes.js").DisplayLookup): Promise<string> => ';
+function validateDisplayTemplates(manifest) {
+  const errors = [];
+  for (const table of manifest.tables) {
+    const templates = table.displayTemplates;
+    if (!templates) continue;
+    if (templates.id) {
+      const err = validateTemplateBody(templates.id);
+      if (err) errors.push({ table: table.name, kind: "id", message: err });
+    }
+    if (templates.preview) {
+      const err = validateTemplateBody(templates.preview);
+      if (err) errors.push({ table: table.name, kind: "preview", message: err });
+    }
+  }
+  return errors;
+}
+function unwrapTemplateBody(editorValue) {
+  const normalized = editorValue.replace(/\r\n/g, "\n").trimEnd();
+  const wrappedPatterns = [
+    /^\/\/\/ <reference path="[^"]+" \/>\nasync function (?:__template|displayTemplate)\([^)]*\)(?:: Promise<string>)? \{\n?([\s\S]*?)\n\}\n?$/,
+    /^async function (?:__template|displayTemplate)\([^)]*\)(?:: Promise<string>)? \{\n?([\s\S]*?)\n\}\n?$/,
+    /^async\s*\([^)]*\)\s*=>\s*\{\n?([\s\S]*?)\n\}\n?$/
+  ];
+  for (const pattern of wrappedPatterns) {
+    const match = normalized.match(pattern);
+    if (match) return (match[1] ?? "").replace(/^\n/, "").replace(/\n$/, "");
+  }
+  return editorValue;
+}
+function validateTemplateBody(body) {
+  const unwrapped = unwrapTemplateBody(body);
+  try {
+    const AsyncFunction = Object.getPrototypeOf(async () => {
+    }).constructor;
+    new AsyncFunction("row", "lookup", unwrapped);
+    return null;
+  } catch (err) {
+    return err.message;
+  }
+}
+function normalizeDisplayTemplateBody(body) {
+  return body.replace(/\breturn\s+([^;\n]+);/g, (match, expr) => {
+    const trimmed = expr.trim();
+    if (/^String\s*\(/.test(trimmed)) return match;
+    return `return String(${trimmed});`;
+  });
+}
+function normalizeManifestDisplayTemplates(manifest) {
+  return {
+    tables: manifest.tables.map((table) => {
+      const templates = table.displayTemplates;
+      if (!templates) return table;
+      return {
+        ...table,
+        displayTemplates: {
+          id: templates.id ? normalizeDisplayTemplateBody(templates.id) : void 0,
+          preview: templates.preview ? normalizeDisplayTemplateBody(templates.preview) : void 0
+        }
+      };
+    })
+  };
+}
+function renderTemplateFn(body) {
+  const unwrapped = unwrapTemplateBody(body);
+  return `${WRAPPER_PREFIX}{
+${normalizeDisplayTemplateBody(unwrapped)}
+}`;
+}
+function generateDisplayValuesTs(manifest) {
+  const entries = [...manifest.tables].filter((t) => t.displayTemplates?.id || t.displayTemplates?.preview).sort((a, b) => a.name.localeCompare(b.name));
+  const tableBlocks = entries.map((t) => {
+    const parts = [];
+    if (t.displayTemplates?.id) {
+      parts.push(`    id: ${renderTemplateFn(t.displayTemplates.id)},`);
+    }
+    if (t.displayTemplates?.preview) {
+      parts.push(`    preview: ${renderTemplateFn(t.displayTemplates.preview)},`);
+    }
+    return `  ${JSON.stringify(t.name)}: {
+${parts.join("\n")}
+  },`;
+  });
+  const registry = tableBlocks.length > 0 ? `export const displayTemplates: import("./_lib/displayTypes.js").DisplayTemplateRegistry = {
+${tableBlocks.join("\n")}
+};` : `export const displayTemplates: import("./_lib/displayTypes.js").DisplayTemplateRegistry = {};`;
+  return `${BANNER}${registry}
+`;
+}
+
+export { generateDisplayValuesTs, normalizeDisplayTemplateBody, normalizeManifestDisplayTemplates, validateDisplayTemplates };
+//# sourceMappingURL=displayTemplateGenerator.js.map
+//# sourceMappingURL=displayTemplateGenerator.js.map

package/dist/displayTemplateGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/displayTemplateGenerator.ts"],"names":[],"mappings":";AAEA,IAAM,MAAA,GAAS,CAAA;AAAA;AAAA;AAAA,CAAA;AAKf,IAAM,cAAA,GACJ,mHAAA;AAQK,SAAS,yBAAyB,QAAA,EAA+C;AACtF,EAAA,MAAM,SAAoC,EAAC;AAC3C,EAAA,KAAA,MAAW,KAAA,IAAS,SAAS,MAAA,EAAQ;AACnC,IAAA,MAAM,YAAY,KAAA,CAAM,gBAAA;AACxB,IAAA,IAAI,CAAC,SAAA,EAAW;AAChB,IAAA,IAAI,UAAU,EAAA,EAAI;AAChB,MAAA,MAAM,GAAA,GAAM,oBAAA,CAAqB,SAAA,CAAU,EAAE,CAAA;AAC7C,MAAA,IAAI,GAAA,EAAK,MAAA,CAAO,IAAA,CAAK,EAAE,KAAA,EAAO,KAAA,CAAM,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,OAAA,EAAS,GAAA,EAAK,CAAA;AAAA,IACtE;AACA,IAAA,IAAI,UAAU,OAAA,EAAS;AACrB,MAAA,MAAM,GAAA,GAAM,oBAAA,CAAqB,SAAA,CAAU,OAAO,CAAA;AAClD,MAAA,IAAI,GAAA,EAAK,MAAA,CAAO,IAAA,CAAK,EAAE,KAAA,EAAO,KAAA,CAAM,IAAA,EAAM,IAAA,EAAM,SAAA,EAAW,OAAA,EAAS,GAAA,EAAK,CAAA;AAAA,IAC3E;AAAA,EACF;AACA,EAAA,OAAO,MAAA;AACT;AAEA,SAAS,mBAAmB,WAAA,EAA6B;AACvD,EAAA,MAAM,aAAa,WAAA,CAAY,OAAA,CAAQ,OAAA,EAAS,IAAI,EAAE,OAAA,EAAQ;AAE9D,EAAA,MAAM,eAAA,GAAkB;AAAA,IACtB,2IAAA;AAAA,IACA,uGAAA;AAAA,IACA;AAAA,GACF;AAEA,EAAA,KAAA,MAAW,WAAW,eAAA,EAAiB;AACrC,IAAA,MAAM,KAAA,GAAQ,UAAA,CAAW,KAAA,CAAM,OAAO,CAAA;AACtC,IAAA,IAAI,KAAA,EAAO,OAAA,CAAQ,KAAA,CAAM,CAAC,CAAA,IAAK,EAAA,EAAI,OAAA,CAAQ,KAAA,EAAO,EAAE,CAAA,CAAE,OAAA,CAAQ,KAAA,EAAO,EAAE,CAAA;AAAA,EACzE;AAEA,EAAA,OAAO,WAAA;AACT;AAEA,SAAS,qBAAqB,IAAA,EAA6B;AACzD,EAAA,MAAM,SAAA,GAAY,mBAAmB,IAAI,CAAA;AACzC,EAAA,IAAI;AAEF,IAAA,MAAM,aAAA,GAAgB,MAAA,CAAO,cAAA,CAAe,YAAY;AAAA,IAAC,CAAC,CAAA,CAAE,WAAA;AAE5D,IAAA,IAAI,aAAA,CAAc,KAAA,EAAO,QAAA,EAAU,SAAS,CAAA;AAC5C,IAAA,OAAO,IAAA;AAAA,EACT,SAAS,GAAA,EAAK;AACZ,IAAA,OAAQ,GAAA,CAAc,OAAA;AAAA,EACxB;AACF;AAGO,SAAS,6BAA6B,IAAA,EAAsB;AACjE,EAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,wBAAA,EAA0B,CAAC,OAAO,IAAA,KAAiB;AACrE,IAAA,MAAM,OAAA,GAAU,KAAK,IAAA,EAAK;AAC1B,IAAA,IAAI,cAAA,CAAe,IAAA,CAAK,OAAO,CAAA,EAAG,OAAO,KAAA;AACzC,IAAA,OAAO,iBAAiB,OAAO,CAAA,EAAA,CAAA;AAAA,EACjC,CAAC,CAAA;AACH;AAEO,SAAS,kCAAkC,QAAA,EAA8B;AAC9E,EAAA,OAAO;AAAA,IACL,MAAA,EAAQ,QAAA,CAAS,MAAA,CAAO,GAAA,CAAI,CAAC,KAAA,KAAU;AACrC,MAAA,MAAM,YAAY,KAAA,CAAM,gBAAA;AACxB,MAAA,IAAI,CAAC,WAAW,OAAO,KAAA;AACvB,MAAA,OAAO;AAAA,QACL,GAAG,KAAA;AAAA,QACH,gBAAA,EAAkB;AAAA,UAChB,IAAI,SAAA,CAAU,EAAA,GAAK,4BAAA,CAA6B,SAAA,CAAU,EAAE,CAAA,GAAI,MAAA;AAAA,UAChE,SAAS,SAAA,CAAU,OAAA,GAAU,4BAAA,CAA6B,SAAA,CAAU,OAAO,CAAA,GAAI;AAAA;AACjF,OACF;AAAA,IACF,CAAC;AAAA,GACH;AACF;AAEA,SAAS,iBAAiB,IAAA,EAAsB;AAC9C,EAAA,MAAM,SAAA,GAAY,mBAAmB,IAAI,CAAA;AACzC,EAAA,OAAO,GAAG,cAAc,CAAA;AAAA,EAAM,4BAAA,CAA6B,SAAS,CAAC;AAAA,CAAA,CAAA;AACvE;AAEO,SAAS,wBAAwB,QAAA,EAA4B;AAClE,EAAA,MAAM,OAAA,GAAU,CAAC,GAAG,QAAA,CAAS,MAAM,EAChC,MAAA,CAAO,CAAC,CAAA,KAAM,CAAA,CAAE,gBAAA,EAAkB,EAAA,IAAM,EAAE,gBAAA,EAAkB,OAAO,CAAA,CACnE,IAAA,CAAK,CAAC,CAAA,EAAG,CAAA,KAAM,CAAA,CAAE,IAAA,CAAK,aAAA,CAAc,CAAA,CAAE,IAAI,CAAC,CAAA;AAE9C,EAAA,MAAM,WAAA,GAAc,OAAA,CAAQ,GAAA,CAAI,CAAC,CAAA,KAAM;AACrC,IAAA,MAAM,QAAkB,EAAC;AACzB,IAAA,IAAI,CAAA,CAAE,kBAAkB,EAAA,EAAI;AAC1B,MAAA,KAAA,CAAM,KAAK,CAAA,QAAA,EAAW,gBAAA,CAAiB,EAAE,gBAAA,CAAiB,EAAE,CAAC,CAAA,CAAA,CAAG,CAAA;AAAA,IAClE;AACA,IAAA,IAAI,CAAA,CAAE,kBAAkB,OAAA,EAAS;AAC/B,MAAA,KAAA,CAAM,KAAK,CAAA,aAAA,EAAgB,gBAAA,CAAiB,EAAE,gBAAA,CAAiB,OAAO,CAAC,CAAA,CAAA,CAAG,CAAA;AAAA,IAC5E;AACA,IAAA,OAAO,CAAA,EAAA,EAAK,IAAA,CAAK,SAAA,CAAU,CAAA,CAAE,IAAI,CAAC,CAAA;AAAA,EAAQ,KAAA,CAAM,IAAA,CAAK,IAAI,CAAC;AAAA,IAAA,CAAA;AAAA,EAC5D,CAAC,CAAA;AAED,EAAA,MAAM,QAAA,GACJ,WAAA,CAAY,MAAA,GAAS,CAAA,GACjB,CAAA;AAAA,EAAgG,WAAA,CAAY,IAAA,CAAK,IAAI,CAAC;AAAA,EAAA,CAAA,GACtH,CAAA,6FAAA,CAAA;AAEN,EAAA,OAAO,CAAA,EAAG,MAAM,CAAA,EAAG,QAAQ;AAAA,CAAA;AAC7B","file":"displayTemplateGenerator.js","sourcesContent":["import type { Manifest } from \"./schemaTypes.ts\";\n\nconst BANNER = `// AUTO-GENERATED by Columnus. Do not edit by hand —\n// changes here will be overwritten when Columnus next saves the schema.\n// biome-ignore-all lint/correctness/noUnusedFunctionParameters: lookup is used by template bodies\n`;\n\nconst WRAPPER_PREFIX =\n  'async (row: Record<string, unknown>, lookup: import(\"./_lib/displayTypes.js\").DisplayLookup): Promise<string> => ';\n\nexport type TemplateValidationError = {\n  table: string;\n  kind: \"id\" | \"preview\";\n  message: string;\n};\n\nexport function validateDisplayTemplates(manifest: Manifest): TemplateValidationError[] {\n  const errors: TemplateValidationError[] = [];\n  for (const table of manifest.tables) {\n    const templates = table.displayTemplates;\n    if (!templates) continue;\n    if (templates.id) {\n      const err = validateTemplateBody(templates.id);\n      if (err) errors.push({ table: table.name, kind: \"id\", message: err });\n    }\n    if (templates.preview) {\n      const err = validateTemplateBody(templates.preview);\n      if (err) errors.push({ table: table.name, kind: \"preview\", message: err });\n    }\n  }\n  return errors;\n}\n\nfunction unwrapTemplateBody(editorValue: string): string {\n  const normalized = editorValue.replace(/\\r\\n/g, \"\\n\").trimEnd();\n\n  const wrappedPatterns = [\n    /^\\/\\/\\/ <reference path=\"[^\"]+\" \\/>\\nasync function (?:__template|displayTemplate)\\([^)]*\\)(?:: Promise<string>)? \\{\\n?([\\s\\S]*?)\\n\\}\\n?$/,\n    /^async function (?:__template|displayTemplate)\\([^)]*\\)(?:: Promise<string>)? \\{\\n?([\\s\\S]*?)\\n\\}\\n?$/,\n    /^async\\s*\\([^)]*\\)\\s*=>\\s*\\{\\n?([\\s\\S]*?)\\n\\}\\n?$/,\n  ] as const;\n\n  for (const pattern of wrappedPatterns) {\n    const match = normalized.match(pattern);\n    if (match) return (match[1] ?? \"\").replace(/^\\n/, \"\").replace(/\\n$/, \"\");\n  }\n\n  return editorValue;\n}\n\nfunction validateTemplateBody(body: string): string | null {\n  const unwrapped = unwrapTemplateBody(body);\n  try {\n    // Templates are async function bodies — validate with AsyncFunction so await works.\n    const AsyncFunction = Object.getPrototypeOf(async () => {}).constructor as typeof Function;\n    // eslint-disable-next-line no-new-func\n    new AsyncFunction(\"row\", \"lookup\", unwrapped);\n    return null;\n  } catch (err) {\n    return (err as Error).message;\n  }\n}\n\n/** Wrap single-line `return expr;` in String() so generated fns satisfy Promise<string>. */\nexport function normalizeDisplayTemplateBody(body: string): string {\n  return body.replace(/\\breturn\\s+([^;\\n]+);/g, (match, expr: string) => {\n    const trimmed = expr.trim();\n    if (/^String\\s*\\(/.test(trimmed)) return match;\n    return `return String(${trimmed});`;\n  });\n}\n\nexport function normalizeManifestDisplayTemplates(manifest: Manifest): Manifest {\n  return {\n    tables: manifest.tables.map((table) => {\n      const templates = table.displayTemplates;\n      if (!templates) return table;\n      return {\n        ...table,\n        displayTemplates: {\n          id: templates.id ? normalizeDisplayTemplateBody(templates.id) : undefined,\n          preview: templates.preview ? normalizeDisplayTemplateBody(templates.preview) : undefined,\n        },\n      };\n    }),\n  };\n}\n\nfunction renderTemplateFn(body: string): string {\n  const unwrapped = unwrapTemplateBody(body);\n  return `${WRAPPER_PREFIX}{\\n${normalizeDisplayTemplateBody(unwrapped)}\\n}`;\n}\n\nexport function generateDisplayValuesTs(manifest: Manifest): string {\n  const entries = [...manifest.tables]\n    .filter((t) => t.displayTemplates?.id || t.displayTemplates?.preview)\n    .sort((a, b) => a.name.localeCompare(b.name));\n\n  const tableBlocks = entries.map((t) => {\n    const parts: string[] = [];\n    if (t.displayTemplates?.id) {\n      parts.push(`    id: ${renderTemplateFn(t.displayTemplates.id)},`);\n    }\n    if (t.displayTemplates?.preview) {\n      parts.push(`    preview: ${renderTemplateFn(t.displayTemplates.preview)},`);\n    }\n    return `  ${JSON.stringify(t.name)}: {\\n${parts.join(\"\\n\")}\\n  },`;\n  });\n\n  const registry =\n    tableBlocks.length > 0\n      ? `export const displayTemplates: import(\"./_lib/displayTypes.js\").DisplayTemplateRegistry = {\\n${tableBlocks.join(\"\\n\")}\\n};`\n      : `export const displayTemplates: import(\"./_lib/displayTypes.js\").DisplayTemplateRegistry = {};`;\n\n  return `${BANNER}${registry}\\n`;\n}\n"]}

package/dist/displayTypes.d.ts

@@ -0,0 +1,10 @@
+export type DisplayLookupResult = {
+    id?: string;
+    preview?: string;
+};
+export type DisplayLookup = (table: string, id: string) => Promise<DisplayLookupResult | null>;
+export type DisplayTemplateFn = (row: Record<string, unknown>, lookup: DisplayLookup) => Promise<string>;
+export type DisplayTemplateRegistry = Record<string, {
+    id?: DisplayTemplateFn;
+    preview?: DisplayTemplateFn;
+}>;

package/dist/displayTypes.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=displayTypes.js.map
+//# sourceMappingURL=displayTypes.js.map

package/dist/displayTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"displayTypes.js"}

package/dist/dotenv.d.ts

@@ -0,0 +1,8 @@
+/** Parse a dotenv-style file into key/value pairs (no variable expansion). */
+export declare function loadEnvFile(filePath: string): Record<string, string>;
+/** Merge a dotenv file into `process.env` (default: only keys not already set). */
+export declare function applyEnvFile(filePath: string, opts?: {
+    onlyIfUnset?: boolean;
+}): void;
+/** Set or append keys in a dotenv file (preserves unrelated lines and comments). */
+export declare function upsertEnvFile(filePath: string, updates: Record<string, string>): void;

package/dist/dotenv.js

@@ -0,0 +1,61 @@
+import { readFileSync, writeFileSync } from 'fs';
+
+// packages/@columnus/shared/src/dotenv.ts
+function loadEnvFile(filePath) {
+  try {
+    const raw = readFileSync(filePath, "utf8");
+    const result = {};
+    for (const line of raw.split("\n")) {
+      const trimmed = line.trim();
+      if (!trimmed || trimmed.startsWith("#")) continue;
+      const eq = trimmed.indexOf("=");
+      if (eq <= 0) continue;
+      const key = trimmed.slice(0, eq).trim();
+      let value = trimmed.slice(eq + 1).trim();
+      if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+        value = value.slice(1, -1);
+      }
+      result[key] = value;
+    }
+    return result;
+  } catch {
+    return {};
+  }
+}
+function applyEnvFile(filePath, opts) {
+  const onlyIfUnset = opts?.onlyIfUnset ?? true;
+  for (const [key, value] of Object.entries(loadEnvFile(filePath))) {
+    if (!onlyIfUnset || process.env[key] === void 0) {
+      process.env[key] = value;
+    }
+  }
+}
+function upsertEnvFile(filePath, updates) {
+  let lines = [];
+  try {
+    lines = readFileSync(filePath, "utf8").split("\n");
+  } catch {
+  }
+  const updatedKeys = /* @__PURE__ */ new Set();
+  const out = lines.map((line) => {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) return line;
+    const eq = trimmed.indexOf("=");
+    if (eq <= 0) return line;
+    const key = trimmed.slice(0, eq).trim();
+    if (!(key in updates)) return line;
+    updatedKeys.add(key);
+    return `${key}=${updates[key]}`;
+  });
+  for (const [key, value] of Object.entries(updates)) {
+    if (!updatedKeys.has(key)) {
+      out.push(`${key}=${value}`);
+    }
+  }
+  const body = out.join("\n").replace(/\n?$/, "\n");
+  writeFileSync(filePath, body, "utf8");
+}
+
+export { applyEnvFile, loadEnvFile, upsertEnvFile };
+//# sourceMappingURL=dotenv.js.map
+//# sourceMappingURL=dotenv.js.map

package/dist/dotenv.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/dotenv.ts"],"names":[],"mappings":"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","file":"dotenv.js","sourcesContent":["import { readFileSync, writeFileSync } from \"node:fs\";\n\n/** Parse a dotenv-style file into key/value pairs (no variable expansion). */\nexport function loadEnvFile(filePath: string): Record<string, string> {\n  try {\n    const raw = readFileSync(filePath, \"utf8\");\n    const result: Record<string, string> = {};\n    for (const line of raw.split(\"\\n\")) {\n      const trimmed = line.trim();\n      if (!trimmed || trimmed.startsWith(\"#\")) continue;\n      const eq = trimmed.indexOf(\"=\");\n      if (eq <= 0) continue;\n      const key = trimmed.slice(0, eq).trim();\n      let value = trimmed.slice(eq + 1).trim();\n      if (\n        (value.startsWith('\"') && value.endsWith('\"')) ||\n        (value.startsWith(\"'\") && value.endsWith(\"'\"))\n      ) {\n        value = value.slice(1, -1);\n      }\n      result[key] = value;\n    }\n    return result;\n  } catch {\n    return {};\n  }\n}\n\n/** Merge a dotenv file into `process.env` (default: only keys not already set). */\nexport function applyEnvFile(filePath: string, opts?: { onlyIfUnset?: boolean }): void {\n  const onlyIfUnset = opts?.onlyIfUnset ?? true;\n  for (const [key, value] of Object.entries(loadEnvFile(filePath))) {\n    if (!onlyIfUnset || process.env[key] === undefined) {\n      process.env[key] = value;\n    }\n  }\n}\n\n/** Set or append keys in a dotenv file (preserves unrelated lines and comments). */\nexport function upsertEnvFile(filePath: string, updates: Record<string, string>): void {\n  let lines: string[] = [];\n  try {\n    lines = readFileSync(filePath, \"utf8\").split(\"\\n\");\n  } catch {\n    // new file\n  }\n\n  const updatedKeys = new Set<string>();\n  const out = lines.map((line) => {\n    const trimmed = line.trim();\n    if (!trimmed || trimmed.startsWith(\"#\")) return line;\n    const eq = trimmed.indexOf(\"=\");\n    if (eq <= 0) return line;\n    const key = trimmed.slice(0, eq).trim();\n    if (!(key in updates)) return line;\n    updatedKeys.add(key);\n    return `${key}=${updates[key]}`;\n  });\n\n  for (const [key, value] of Object.entries(updates)) {\n    if (!updatedKeys.has(key)) {\n      out.push(`${key}=${value}`);\n    }\n  }\n\n  const body = out.join(\"\\n\").replace(/\\n?$/, \"\\n\");\n  writeFileSync(filePath, body, \"utf8\");\n}\n"]}

package/dist/erdLayout.d.ts

@@ -0,0 +1,27 @@
+export type ErdLayoutDoc = Record<string, {
+    x: number;
+    y: number;
+}>;
+/** Alias used by the client layer — same shape as ErdLayoutDoc. */
+export type ErdLayout = ErdLayoutDoc;
+/** Strict parse for writes — throws on malformed JSON. */
+export declare function parseErdLayoutOrThrow(layoutJson: string): ErdLayoutDoc;
+/** Best-effort parse for reads/promotion — corrupt stored layout must not block saves. */
+export declare function parseErdLayoutOrEmpty(json: string | undefined): ErdLayoutDoc;
+export declare function serializeErdLayout(layout: ErdLayoutDoc): string;
+export declare function mergeErdLayouts(canonical: ErdLayoutDoc, draft?: ErdLayoutDoc): ErdLayoutDoc;
+export declare function pruneErdLayout(layout: ErdLayoutDoc, tableNames: Iterable<string>): ErdLayoutDoc;
+export declare function mergeDraftErdLayoutIntoCanonical(row: {
+    erdLayoutJson?: string;
+    draftErdLayoutJson?: string;
+}): {
+    erdLayoutJson?: string;
+    draftErdLayoutJson: undefined;
+};
+export declare function promoteErdLayoutOnSave(row: {
+    erdLayoutJson?: string;
+    draftErdLayoutJson?: string;
+} | null, tableNames: Iterable<string>): {
+    erdLayoutJson?: string;
+    draftErdLayoutJson: undefined;
+};

package/dist/erdLayout.js

@@ -0,0 +1,78 @@
+// packages/@columnus/shared/src/erdLayout.ts
+function walkLayoutEntries(raw) {
+  const out = {};
+  for (const [name, value] of Object.entries(raw)) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) continue;
+    const x = value.x;
+    const y = value.y;
+    if (typeof x === "number" && Number.isFinite(x) && typeof y === "number" && Number.isFinite(y)) {
+      out[name] = { x, y };
+    }
+  }
+  return out;
+}
+function parseErdLayoutOrThrow(layoutJson) {
+  let raw;
+  try {
+    raw = JSON.parse(layoutJson);
+  } catch {
+    throw new Error("erd layout is not valid JSON");
+  }
+  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+    throw new Error("erd layout must be an object");
+  }
+  return walkLayoutEntries(raw);
+}
+function parseErdLayoutOrEmpty(json) {
+  if (!json) return {};
+  try {
+    return parseErdLayoutOrThrow(json);
+  } catch {
+    return {};
+  }
+}
+function serializeErdLayout(layout) {
+  return JSON.stringify(layout);
+}
+function mergeErdLayouts(canonical, draft) {
+  if (!draft || Object.keys(draft).length === 0) return { ...canonical };
+  return { ...canonical, ...draft };
+}
+function pruneErdLayout(layout, tableNames) {
+  const allowed = new Set(tableNames);
+  const out = {};
+  for (const [name, pos] of Object.entries(layout)) {
+    if (allowed.has(name)) out[name] = pos;
+  }
+  return out;
+}
+function layoutJsonFromDoc(layout) {
+  return Object.keys(layout).length > 0 ? serializeErdLayout(layout) : void 0;
+}
+function mergeDraftErdLayoutIntoCanonical(row) {
+  if (!row.draftErdLayoutJson) return { draftErdLayoutJson: void 0 };
+  const merged = mergeErdLayouts(
+    parseErdLayoutOrEmpty(row.erdLayoutJson),
+    parseErdLayoutOrEmpty(row.draftErdLayoutJson)
+  );
+  return {
+    erdLayoutJson: layoutJsonFromDoc(merged),
+    draftErdLayoutJson: void 0
+  };
+}
+function promoteErdLayoutOnSave(row, tableNames) {
+  if (!row) return { draftErdLayoutJson: void 0 };
+  const merged = mergeErdLayouts(
+    parseErdLayoutOrEmpty(row.erdLayoutJson),
+    parseErdLayoutOrEmpty(row.draftErdLayoutJson)
+  );
+  const pruned = pruneErdLayout(merged, tableNames);
+  return {
+    erdLayoutJson: layoutJsonFromDoc(pruned),
+    draftErdLayoutJson: void 0
+  };
+}
+
+export { mergeDraftErdLayoutIntoCanonical, mergeErdLayouts, parseErdLayoutOrEmpty, parseErdLayoutOrThrow, promoteErdLayoutOnSave, pruneErdLayout, serializeErdLayout };
+//# sourceMappingURL=erdLayout.js.map
+//# sourceMappingURL=erdLayout.js.map

package/dist/erdLayout.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/erdLayout.ts"],"names":[],"mappings":"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","file":"erdLayout.js","sourcesContent":["export type ErdLayoutDoc = Record<string, { x: number; y: number }>;\n\n/** Alias used by the client layer — same shape as ErdLayoutDoc. */\nexport type ErdLayout = ErdLayoutDoc;\n\nfunction walkLayoutEntries(raw: Record<string, unknown>): ErdLayoutDoc {\n  const out: ErdLayoutDoc = {};\n  for (const [name, value] of Object.entries(raw)) {\n    if (typeof value !== \"object\" || value === null || Array.isArray(value)) continue;\n    const x = (value as { x?: unknown }).x;\n    const y = (value as { y?: unknown }).y;\n    if (\n      typeof x === \"number\" &&\n      Number.isFinite(x) &&\n      typeof y === \"number\" &&\n      Number.isFinite(y)\n    ) {\n      out[name] = { x, y };\n    }\n  }\n  return out;\n}\n\n/** Strict parse for writes — throws on malformed JSON. */\nexport function parseErdLayoutOrThrow(layoutJson: string): ErdLayoutDoc {\n  let raw: unknown;\n  try {\n    raw = JSON.parse(layoutJson);\n  } catch {\n    throw new Error(\"erd layout is not valid JSON\");\n  }\n  if (typeof raw !== \"object\" || raw === null || Array.isArray(raw)) {\n    throw new Error(\"erd layout must be an object\");\n  }\n  return walkLayoutEntries(raw as Record<string, unknown>);\n}\n\n/** Best-effort parse for reads/promotion — corrupt stored layout must not block saves. */\nexport function parseErdLayoutOrEmpty(json: string | undefined): ErdLayoutDoc {\n  if (!json) return {};\n  try {\n    return parseErdLayoutOrThrow(json);\n  } catch {\n    return {};\n  }\n}\n\nexport function serializeErdLayout(layout: ErdLayoutDoc): string {\n  return JSON.stringify(layout);\n}\n\nexport function mergeErdLayouts(canonical: ErdLayoutDoc, draft?: ErdLayoutDoc): ErdLayoutDoc {\n  if (!draft || Object.keys(draft).length === 0) return { ...canonical };\n  return { ...canonical, ...draft };\n}\n\nexport function pruneErdLayout(layout: ErdLayoutDoc, tableNames: Iterable<string>): ErdLayoutDoc {\n  const allowed = new Set(tableNames);\n  const out: ErdLayoutDoc = {};\n  for (const [name, pos] of Object.entries(layout)) {\n    if (allowed.has(name)) out[name] = pos;\n  }\n  return out;\n}\n\nfunction layoutJsonFromDoc(layout: ErdLayoutDoc): string | undefined {\n  return Object.keys(layout).length > 0 ? serializeErdLayout(layout) : undefined;\n}\n\nexport function mergeDraftErdLayoutIntoCanonical(row: {\n  erdLayoutJson?: string;\n  draftErdLayoutJson?: string;\n}): { erdLayoutJson?: string; draftErdLayoutJson: undefined } {\n  if (!row.draftErdLayoutJson) return { draftErdLayoutJson: undefined };\n  const merged = mergeErdLayouts(\n    parseErdLayoutOrEmpty(row.erdLayoutJson),\n    parseErdLayoutOrEmpty(row.draftErdLayoutJson),\n  );\n  return {\n    erdLayoutJson: layoutJsonFromDoc(merged),\n    draftErdLayoutJson: undefined,\n  };\n}\n\nexport function promoteErdLayoutOnSave(\n  row: { erdLayoutJson?: string; draftErdLayoutJson?: string } | null,\n  tableNames: Iterable<string>,\n): { erdLayoutJson?: string; draftErdLayoutJson: undefined } {\n  if (!row) return { draftErdLayoutJson: undefined };\n  const merged = mergeErdLayouts(\n    parseErdLayoutOrEmpty(row.erdLayoutJson),\n    parseErdLayoutOrEmpty(row.draftErdLayoutJson),\n  );\n  const pruned = pruneErdLayout(merged, tableNames);\n  return {\n    erdLayoutJson: layoutJsonFromDoc(pruned),\n    draftErdLayoutJson: undefined,\n  };\n}\n"]}

package/dist/fieldTypeFormat.d.ts

@@ -0,0 +1,5 @@
+import type { FieldType } from "./schemaTypes.ts";
+export declare function formatCanonicalFieldType(type: FieldType): string;
+export declare function formatErdCompactFieldType(type: FieldType): string;
+export declare function formatEditorSummaryFieldType(type: FieldType): string;
+export declare function formatMatchLabelFieldType(type: FieldType): string;

package/dist/fieldTypeFormat.js

@@ -0,0 +1,63 @@
+// packages/@columnus/shared/src/fieldTypeFormat.ts
+function formatCanonicalFieldType(type) {
+  switch (type.kind) {
+    case "id":
+      return `id(${type.table})`;
+    case "literal":
+      return `"${type.value}"`;
+    case "array":
+      return `array<${formatCanonicalFieldType(type.element)}>`;
+    case "object":
+      return "object";
+    case "union":
+      return type.options.map(formatCanonicalFieldType).join(" | ");
+    default:
+      return type.kind;
+  }
+}
+function formatErdCompactFieldType(type) {
+  if (type.kind === "union" && type.options.length >= 2 && type.options.every((option) => option.kind === "literal")) {
+    return `enum(${type.options.length})`;
+  }
+  if (type.kind === "union" && type.options.length >= 3) {
+    return `union(${type.options.length})`;
+  }
+  if (type.kind === "array") {
+    return `array<${formatErdCompactFieldType(type.element)}>`;
+  }
+  return formatCanonicalFieldType(type);
+}
+function formatEditorSummaryFieldType(type) {
+  switch (type.kind) {
+    case "id":
+      return `id<${type.table || "?"}>`;
+    case "literal":
+      return typeof type.value === "string" ? `"${type.value}"` : String(type.value);
+    case "array":
+      return `${formatEditorSummaryFieldType(type.element)}[]`;
+    case "object": {
+      const names = type.fields.map((field) => field.name + (field.optional ? "?" : ""));
+      if (names.length === 0) return "{}";
+      if (names.length <= 3) return `{ ${names.join(", ")} }`;
+      return `{ ${names.slice(0, 3).join(", ")}, +${names.length - 3} }`;
+    }
+    case "union":
+      if (type.options.length <= 3) {
+        return type.options.map(formatEditorSummaryFieldType).join(" | ");
+      }
+      return `${type.options.slice(0, 2).map(formatEditorSummaryFieldType).join(" | ")} | +${type.options.length - 2}`;
+    default:
+      return type.kind;
+  }
+}
+function formatMatchLabelFieldType(type) {
+  if (type.kind === "id") return `id \u2192 ${type.table}`;
+  if (type.kind === "array" && type.element.kind === "id") {
+    return `id[] \u2192 ${type.element.table}`;
+  }
+  return type.kind;
+}
+
+export { formatCanonicalFieldType, formatEditorSummaryFieldType, formatErdCompactFieldType, formatMatchLabelFieldType };
+//# sourceMappingURL=fieldTypeFormat.js.map
+//# sourceMappingURL=fieldTypeFormat.js.map

package/dist/fieldTypeFormat.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fieldTypeFormat.ts"],"names":[],"mappings":"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","file":"fieldTypeFormat.js","sourcesContent":["import type { FieldType } from \"./schemaTypes.ts\";\n\nexport function formatCanonicalFieldType(type: FieldType): string {\n  switch (type.kind) {\n    case \"id\":\n      return `id(${type.table})`;\n    case \"literal\":\n      return `\"${type.value}\"`;\n    case \"array\":\n      return `array<${formatCanonicalFieldType(type.element)}>`;\n    case \"object\":\n      return \"object\";\n    case \"union\":\n      return type.options.map(formatCanonicalFieldType).join(\" | \");\n    default:\n      return type.kind;\n  }\n}\n\nexport function formatErdCompactFieldType(type: FieldType): string {\n  if (\n    type.kind === \"union\" &&\n    type.options.length >= 2 &&\n    type.options.every((option) => option.kind === \"literal\")\n  ) {\n    return `enum(${type.options.length})`;\n  }\n  if (type.kind === \"union\" && type.options.length >= 3) {\n    return `union(${type.options.length})`;\n  }\n  if (type.kind === \"array\") {\n    return `array<${formatErdCompactFieldType(type.element)}>`;\n  }\n  return formatCanonicalFieldType(type);\n}\n\nexport function formatEditorSummaryFieldType(type: FieldType): string {\n  switch (type.kind) {\n    case \"id\":\n      return `id<${type.table || \"?\"}>`;\n    case \"literal\":\n      return typeof type.value === \"string\" ? `\"${type.value}\"` : String(type.value);\n    case \"array\":\n      return `${formatEditorSummaryFieldType(type.element)}[]`;\n    case \"object\": {\n      const names = type.fields.map((field) => field.name + (field.optional ? \"?\" : \"\"));\n      if (names.length === 0) return \"{}\";\n      if (names.length <= 3) return `{ ${names.join(\", \")} }`;\n      return `{ ${names.slice(0, 3).join(\", \")}, +${names.length - 3} }`;\n    }\n    case \"union\":\n      if (type.options.length <= 3) {\n        return type.options.map(formatEditorSummaryFieldType).join(\" | \");\n      }\n      return `${type.options.slice(0, 2).map(formatEditorSummaryFieldType).join(\" | \")} | +${type.options.length - 2}`;\n    default:\n      return type.kind;\n  }\n}\n\nexport function formatMatchLabelFieldType(type: FieldType): string {\n  if (type.kind === \"id\") return `id → ${type.table}`;\n  if (type.kind === \"array\" && type.element.kind === \"id\") {\n    return `id[] → ${type.element.table}`;\n  }\n  return type.kind;\n}\n"]}

package/dist/fieldTypeMeta.d.ts

@@ -0,0 +1,50 @@
+import type { FieldType } from "./schemaTypes.ts";
+/** Manifest field type discriminator — every `FieldType["kind"]`. */
+export type FieldTypeKind = FieldType["kind"];
+/** Kinds offered in schema editors (stable picker order). */
+export declare const FIELD_TYPE_SELECT_KINDS: readonly ["string", "markdown", "number", "boolean", "bigint", "null", "any", "bytes", "file", "image", "date", "datetime", "id", "literal", "array", "object", "union"];
+/** Lucide icon component names for each field kind (resolved in UI). */
+export declare const FIELD_TYPE_KIND_ICONS: {
+    readonly string: "Type";
+    readonly markdown: "FileText";
+    readonly number: "Hash";
+    readonly boolean: "ToggleLeft";
+    readonly bigint: "Binary";
+    readonly null: "CircleSlash";
+    readonly any: "Asterisk";
+    readonly bytes: "FileCode2";
+    readonly file: "File";
+    readonly image: "Image";
+    readonly date: "Calendar";
+    readonly datetime: "CalendarClock";
+    readonly id: "Link2";
+    readonly literal: "Quote";
+    readonly array: "List";
+    readonly object: "Braces";
+    readonly union: "GitBranch";
+};
+/** Human-readable labels for schema UI (kind ids stay in manifest JSON). */
+export declare const FIELD_TYPE_KIND_LABELS: {
+    readonly string: "Text";
+    readonly markdown: "Rich text";
+    readonly number: "Number";
+    readonly boolean: "Boolean";
+    readonly bigint: "Big integer";
+    readonly null: "Null";
+    readonly any: "Any value";
+    readonly bytes: "Bytes";
+    readonly file: "File";
+    readonly image: "Image";
+    readonly date: "Date";
+    readonly datetime: "Date & time";
+    readonly id: "Reference";
+    readonly literal: "Literal";
+    readonly array: "List";
+    readonly object: "Object";
+    readonly union: "Union";
+};
+export type FieldTypeKindIconName = (typeof FIELD_TYPE_KIND_ICONS)[FieldTypeKind];
+export declare function fieldTypeKindLabel(kind: FieldTypeKind): string;
+export declare function fieldTypeKindIconName(kind: FieldTypeKind): FieldTypeKindIconName;
+/** Short UI label for a field type (summaries, badges). */
+export declare function briefFieldTypeLabel(type: FieldType): string;

package/dist/fieldTypeMeta.js

@@ -0,0 +1,84 @@
+// packages/@columnus/shared/src/fieldTypeMeta.ts
+var FIELD_TYPE_SELECT_KINDS = [
+  "string",
+  "markdown",
+  "number",
+  "boolean",
+  "bigint",
+  "null",
+  "any",
+  "bytes",
+  "file",
+  "image",
+  "date",
+  "datetime",
+  "id",
+  "literal",
+  "array",
+  "object",
+  "union"
+];
+var FIELD_TYPE_KIND_ICONS = {
+  string: "Type",
+  markdown: "FileText",
+  number: "Hash",
+  boolean: "ToggleLeft",
+  bigint: "Binary",
+  null: "CircleSlash",
+  any: "Asterisk",
+  bytes: "FileCode2",
+  file: "File",
+  image: "Image",
+  date: "Calendar",
+  datetime: "CalendarClock",
+  id: "Link2",
+  literal: "Quote",
+  array: "List",
+  object: "Braces",
+  union: "GitBranch"
+};
+var FIELD_TYPE_KIND_LABELS = {
+  string: "Text",
+  markdown: "Rich text",
+  number: "Number",
+  boolean: "Boolean",
+  bigint: "Big integer",
+  null: "Null",
+  any: "Any value",
+  bytes: "Bytes",
+  file: "File",
+  image: "Image",
+  date: "Date",
+  datetime: "Date & time",
+  id: "Reference",
+  literal: "Literal",
+  array: "List",
+  object: "Object",
+  union: "Union"
+};
+function fieldTypeKindLabel(kind) {
+  return FIELD_TYPE_KIND_LABELS[kind];
+}
+function fieldTypeKindIconName(kind) {
+  return FIELD_TYPE_KIND_ICONS[kind];
+}
+function briefFieldTypeLabel(type) {
+  switch (type.kind) {
+    case "id":
+      return type.table ? `${FIELD_TYPE_KIND_LABELS.id} \u2192 ${type.table}` : FIELD_TYPE_KIND_LABELS.id;
+    case "literal":
+      return FIELD_TYPE_KIND_LABELS.literal;
+    case "array":
+      return `${briefFieldTypeLabel(type.element)}[]`;
+    case "object":
+      return `${FIELD_TYPE_KIND_LABELS.object} (${type.fields.length})`;
+    case "union":
+      return `${FIELD_TYPE_KIND_LABELS.union} (${type.options.length})`;
+    default:
+      return fieldTypeKindLabel(type.kind);
+  }
+}
+
+export { FIELD_TYPE_KIND_ICONS, FIELD_TYPE_KIND_LABELS, FIELD_TYPE_SELECT_KINDS, briefFieldTypeLabel, fieldTypeKindIconName, fieldTypeKindLabel };
+//# sourceMappingURL=fieldTypeMeta.js.map
+//# sourceMappingURL=fieldTypeMeta.js.map

package/dist/fieldTypeMeta.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fieldTypeMeta.ts"],"names":[],"mappings":";AAMO,IAAM,uBAAA,GAA0B;AAAA,EACrC,QAAA;AAAA,EACA,UAAA;AAAA,EACA,QAAA;AAAA,EACA,SAAA;AAAA,EACA,QAAA;AAAA,EACA,MAAA;AAAA,EACA,KAAA;AAAA,EACA,OAAA;AAAA,EACA,MAAA;AAAA,EACA,OAAA;AAAA,EACA,MAAA;AAAA,EACA,UAAA;AAAA,EACA,IAAA;AAAA,EACA,SAAA;AAAA,EACA,OAAA;AAAA,EACA,QAAA;AAAA,EACA;AACF;AAGO,IAAM,qBAAA,GAAwB;AAAA,EACnC,MAAA,EAAQ,MAAA;AAAA,EACR,QAAA,EAAU,UAAA;AAAA,EACV,MAAA,EAAQ,MAAA;AAAA,EACR,OAAA,EAAS,YAAA;AAAA,EACT,MAAA,EAAQ,QAAA;AAAA,EACR,IAAA,EAAM,aAAA;AAAA,EACN,GAAA,EAAK,UAAA;AAAA,EACL,KAAA,EAAO,WAAA;AAAA,EACP,IAAA,EAAM,MAAA;AAAA,EACN,KAAA,EAAO,OAAA;AAAA,EACP,IAAA,EAAM,UAAA;AAAA,EACN,QAAA,EAAU,eAAA;AAAA,EACV,EAAA,EAAI,OAAA;AAAA,EACJ,OAAA,EAAS,OAAA;AAAA,EACT,KAAA,EAAO,MAAA;AAAA,EACP,MAAA,EAAQ,QAAA;AAAA,EACR,KAAA,EAAO;AACT;AAGO,IAAM,sBAAA,GAAyB;AAAA,EACpC,MAAA,EAAQ,MAAA;AAAA,EACR,QAAA,EAAU,WAAA;AAAA,EACV,MAAA,EAAQ,QAAA;AAAA,EACR,OAAA,EAAS,SAAA;AAAA,EACT,MAAA,EAAQ,aAAA;AAAA,EACR,IAAA,EAAM,MAAA;AAAA,EACN,GAAA,EAAK,WAAA;AAAA,EACL,KAAA,EAAO,OAAA;AAAA,EACP,IAAA,EAAM,MAAA;AAAA,EACN,KAAA,EAAO,OAAA;AAAA,EACP,IAAA,EAAM,MAAA;AAAA,EACN,QAAA,EAAU,aAAA;AAAA,EACV,EAAA,EAAI,WAAA;AAAA,EACJ,OAAA,EAAS,SAAA;AAAA,EACT,KAAA,EAAO,MAAA;AAAA,EACP,MAAA,EAAQ,QAAA;AAAA,EACR,KAAA,EAAO;AACT;AAIO,SAAS,mBAAmB,IAAA,EAA6B;AAC9D,EAAA,OAAO,uBAAuB,IAAI,CAAA;AACpC;AAEO,SAAS,sBAAsB,IAAA,EAA4C;AAChF,EAAA,OAAO,sBAAsB,IAAI,CAAA;AACnC;AAGO,SAAS,oBAAoB,IAAA,EAAyB;AAC3D,EAAA,QAAQ,KAAK,IAAA;AAAM,IACjB,KAAK,IAAA;AACH,MAAA,OAAO,IAAA,CAAK,QACR,CAAA,EAAG,sBAAA,CAAuB,EAAE,CAAA,QAAA,EAAM,IAAA,CAAK,KAAK,CAAA,CAAA,GAC5C,sBAAA,CAAuB,EAAA;AAAA,IAC7B,KAAK,SAAA;AACH,MAAA,OAAO,sBAAA,CAAuB,OAAA;AAAA,IAChC,KAAK,OAAA;AACH,MAAA,OAAO,CAAA,EAAG,mBAAA,CAAoB,IAAA,CAAK,OAAO,CAAC,CAAA,EAAA,CAAA;AAAA,IAC7C,KAAK,QAAA;AACH,MAAA,OAAO,GAAG,sBAAA,CAAuB,MAAM,CAAA,EAAA,EAAK,IAAA,CAAK,OAAO,MAAM,CAAA,CAAA,CAAA;AAAA,IAChE,KAAK,OAAA;AACH,MAAA,OAAO,GAAG,sBAAA,CAAuB,KAAK,CAAA,EAAA,EAAK,IAAA,CAAK,QAAQ,MAAM,CAAA,CAAA,CAAA;AAAA,IAChE;AACE,MAAA,OAAO,kBAAA,CAAmB,KAAK,IAAI,CAAA;AAAA;AAEzC","file":"fieldTypeMeta.js","sourcesContent":["import type { FieldType } from \"./schemaTypes.ts\";\n\n/** Manifest field type discriminator — every `FieldType[\"kind\"]`. */\nexport type FieldTypeKind = FieldType[\"kind\"];\n\n/** Kinds offered in schema editors (stable picker order). */\nexport const FIELD_TYPE_SELECT_KINDS = [\n  \"string\",\n  \"markdown\",\n  \"number\",\n  \"boolean\",\n  \"bigint\",\n  \"null\",\n  \"any\",\n  \"bytes\",\n  \"file\",\n  \"image\",\n  \"date\",\n  \"datetime\",\n  \"id\",\n  \"literal\",\n  \"array\",\n  \"object\",\n  \"union\",\n] as const satisfies readonly FieldTypeKind[];\n\n/** Lucide icon component names for each field kind (resolved in UI). */\nexport const FIELD_TYPE_KIND_ICONS = {\n  string: \"Type\",\n  markdown: \"FileText\",\n  number: \"Hash\",\n  boolean: \"ToggleLeft\",\n  bigint: \"Binary\",\n  null: \"CircleSlash\",\n  any: \"Asterisk\",\n  bytes: \"FileCode2\",\n  file: \"File\",\n  image: \"Image\",\n  date: \"Calendar\",\n  datetime: \"CalendarClock\",\n  id: \"Link2\",\n  literal: \"Quote\",\n  array: \"List\",\n  object: \"Braces\",\n  union: \"GitBranch\",\n} as const satisfies Record<FieldTypeKind, string>;\n\n/** Human-readable labels for schema UI (kind ids stay in manifest JSON). */\nexport const FIELD_TYPE_KIND_LABELS = {\n  string: \"Text\",\n  markdown: \"Rich text\",\n  number: \"Number\",\n  boolean: \"Boolean\",\n  bigint: \"Big integer\",\n  null: \"Null\",\n  any: \"Any value\",\n  bytes: \"Bytes\",\n  file: \"File\",\n  image: \"Image\",\n  date: \"Date\",\n  datetime: \"Date & time\",\n  id: \"Reference\",\n  literal: \"Literal\",\n  array: \"List\",\n  object: \"Object\",\n  union: \"Union\",\n} as const satisfies Record<FieldTypeKind, string>;\n\nexport type FieldTypeKindIconName = (typeof FIELD_TYPE_KIND_ICONS)[FieldTypeKind];\n\nexport function fieldTypeKindLabel(kind: FieldTypeKind): string {\n  return FIELD_TYPE_KIND_LABELS[kind];\n}\n\nexport function fieldTypeKindIconName(kind: FieldTypeKind): FieldTypeKindIconName {\n  return FIELD_TYPE_KIND_ICONS[kind];\n}\n\n/** Short UI label for a field type (summaries, badges). */\nexport function briefFieldTypeLabel(type: FieldType): string {\n  switch (type.kind) {\n    case \"id\":\n      return type.table\n        ? `${FIELD_TYPE_KIND_LABELS.id} → ${type.table}`\n        : FIELD_TYPE_KIND_LABELS.id;\n    case \"literal\":\n      return FIELD_TYPE_KIND_LABELS.literal;\n    case \"array\":\n      return `${briefFieldTypeLabel(type.element)}[]`;\n    case \"object\":\n      return `${FIELD_TYPE_KIND_LABELS.object} (${type.fields.length})`;\n    case \"union\":\n      return `${FIELD_TYPE_KIND_LABELS.union} (${type.options.length})`;\n    default:\n      return fieldTypeKindLabel(type.kind);\n  }\n}\n"]}

package/dist/fieldValueEqual.d.ts

@@ -0,0 +1,4 @@
+/** True when two stored field values are equivalent (missing ≡ undefined). */
+export declare function fieldValuesEqual(a: unknown, b: unknown): boolean;
+/** Drop patch keys whose values match the server row baseline. */
+export declare function filterChangedPatchFields(patch: Record<string, unknown>, baseline: Record<string, unknown> | undefined): Record<string, unknown>;

package/dist/fieldValueEqual.js

@@ -0,0 +1,58 @@
+// packages/@columnus/shared/src/fieldValueEqual.ts
+function bytesToBase64(bytes) {
+  let s = "";
+  for (const b of bytes) s += String.fromCharCode(b);
+  return btoa(s);
+}
+function jsonReplacer(_key, value) {
+  if (typeof value === "bigint") return `${value.toString()}n`;
+  if (value instanceof Uint8Array) return { __bytes__: bytesToBase64(value) };
+  return value;
+}
+function normalizeForCompare(value) {
+  if (value === void 0 || value === null) return void 0;
+  return value;
+}
+function stableJsonEqual(a, b) {
+  try {
+    return JSON.stringify(a, jsonReplacer) === JSON.stringify(b, jsonReplacer);
+  } catch {
+    return false;
+  }
+}
+function fieldValuesEqual(a, b) {
+  const na = normalizeForCompare(a);
+  const nb = normalizeForCompare(b);
+  if (Object.is(na, nb)) return true;
+  if (na === void 0 && nb === void 0) return true;
+  const ta = typeof na;
+  const tb = typeof nb;
+  if (ta !== tb) {
+    if (ta === "bigint" && tb === "string") {
+      const naBig = na;
+      const nbStr = nb;
+      return `${naBig.toString()}n` === nbStr || naBig.toString() === nbStr.replace(/n$/, "");
+    }
+    if (ta === "string" && tb === "bigint") {
+      const naStr = na;
+      const nbBig = nb;
+      return `${nbBig.toString()}n` === naStr || nbBig.toString() === naStr.replace(/n$/, "");
+    }
+    return false;
+  }
+  if (ta === "object" && na !== null && nb !== null) {
+    return stableJsonEqual(na, nb);
+  }
+  return false;
+}
+function filterChangedPatchFields(patch, baseline) {
+  const out = {};
+  for (const [key, value] of Object.entries(patch)) {
+    if (!fieldValuesEqual(value, baseline?.[key])) out[key] = value;
+  }
+  return out;
+}
+
+export { fieldValuesEqual, filterChangedPatchFields };
+//# sourceMappingURL=fieldValueEqual.js.map
+//# sourceMappingURL=fieldValueEqual.js.map