@contractspec/lib.contracts 1.56.1 → 1.58.0

package/dist/client/react/index.js

@@ -1,8 +1,1376 @@
-'use client';
+// @bun
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = import.meta.require;
 
-import { createEngineWithDefaults, createFeatureModule, registerFeature, renderFeaturePresentation } from "./feature-render.js";
-import { createFormRenderer } from "./form-render.js";
-import { shadcnDriver } from "./drivers/shadcn.js";
-import { rnReusablesDriver } from "./drivers/rn-reusables.js";
+// src/registry-utils.ts
+var exports_registry_utils = {};
+__export(exports_registry_utils, {
+  groupByToArray: () => groupByToArray,
+  groupByMultiple: () => groupByMultiple,
+  groupBy: () => groupBy,
+  getUniqueTags: () => getUniqueTags,
+  getUniqueOwners: () => getUniqueOwners,
+  getUniqueDomains: () => getUniqueDomains,
+  filterBy: () => filterBy,
+  GroupingStrategies: () => GroupingStrategies
+});
+function filterBy(items, filter) {
+  return items.filter((item) => {
+    if (filter.tags?.length) {
+      const hasMatchingTag = filter.tags.some((tag) => item.meta.tags?.includes(tag));
+      if (!hasMatchingTag)
+        return false;
+    }
+    if (filter.owners?.length) {
+      const hasMatchingOwner = filter.owners.some((owner) => item.meta.owners?.includes(owner));
+      if (!hasMatchingOwner)
+        return false;
+    }
+    if (filter.stability?.length) {
+      if (!filter.stability.includes(item.meta.stability ?? "stable")) {
+        return false;
+      }
+    }
+    if (filter.domain) {
+      const itemDomain = GroupingStrategies.byDomain(item);
+      if (itemDomain !== filter.domain)
+        return false;
+    }
+    if (filter.keyPattern) {
+      const name = item.meta.key ?? item.meta.key ?? "";
+      const pattern = filter.keyPattern.replace(/\*/g, ".*").replace(/\?/g, ".");
+      const regex = new RegExp(`^${pattern}$`, "i");
+      if (!regex.test(name))
+        return false;
+    }
+    return true;
+  });
+}
+function groupBy(items, keyFn) {
+  const groups = new Map;
+  for (const item of items) {
+    const key = keyFn(item);
+    const existing = groups.get(key);
+    if (existing) {
+      existing.push(item);
+    } else {
+      groups.set(key, [item]);
+    }
+  }
+  return groups;
+}
+function groupByToArray(items, keyFn) {
+  const map = groupBy(items, keyFn);
+  return Array.from(map.entries()).map(([key, items2]) => ({ key, items: items2 }));
+}
+function groupByMultiple(items, keysFn) {
+  const groups = new Map;
+  for (const item of items) {
+    const keys = keysFn(item);
+    for (const key of keys) {
+      const existing = groups.get(key);
+      if (existing) {
+        existing.push(item);
+      } else {
+        groups.set(key, [item]);
+      }
+    }
+  }
+  return groups;
+}
+function getUniqueTags(items) {
+  const tags = new Set;
+  for (const item of items) {
+    for (const tag of item.meta.tags ?? []) {
+      tags.add(tag);
+    }
+  }
+  return Array.from(tags).sort();
+}
+function getUniqueOwners(items) {
+  const owners = new Set;
+  for (const item of items) {
+    for (const owner of item.meta.owners ?? []) {
+      owners.add(owner);
+    }
+  }
+  return Array.from(owners).sort();
+}
+function getUniqueDomains(items) {
+  const domains = new Set;
+  for (const item of items) {
+    domains.add(GroupingStrategies.byDomain(item));
+  }
+  return Array.from(domains).sort();
+}
+var GroupingStrategies;
+var init_registry_utils = __esm(() => {
+  GroupingStrategies = {
+    byTag: (item) => item.meta.tags?.[0] ?? "untagged",
+    byAllTags: (item) => item.meta.tags?.length ? item.meta.tags : ["untagged"],
+    byOwner: (item) => item.meta.owners?.[0] ?? "unowned",
+    byDomain: (item) => {
+      const name = item.meta.key ?? item.meta.key ?? "";
+      return name.split(".")[0] ?? "default";
+    },
+    byStability: (item) => item.meta.stability ?? "stable",
+    byUrlPath: (level) => (item) => {
+      if (!item.path)
+        return "root";
+      const segments = item.path.split("/").filter(Boolean);
+      return segments.slice(0, level).join("/") || "root";
+    }
+  };
+});
 
-export { createEngineWithDefaults, createFeatureModule, createFormRenderer, registerFeature, renderFeaturePresentation, rnReusablesDriver, shadcnDriver };
+// src/registry.ts
+init_registry_utils();
+import { compareVersions } from "compare-versions";
+var keyOfSpecContract = (spec) => `${spec.meta.key}.v${spec.meta.version}`;
+
+class SpecContractRegistry {
+  contractType;
+  items = new Map;
+  constructor(contractType, items) {
+    this.contractType = contractType;
+    if (items) {
+      items.forEach((p) => this.register(p));
+    }
+  }
+  register(p) {
+    const key = keyOfSpecContract(p);
+    if (this.items.has(key))
+      throw new Error(`Duplicate contract \`${this.contractType}\` ${key}`);
+    this.items.set(key, p);
+    return this;
+  }
+  count() {
+    return this.items.size;
+  }
+  list() {
+    return [...this.items.values()];
+  }
+  get(key, version) {
+    if (version != null)
+      return this.items.get(`${key}.v${version}`);
+    let candidate;
+    for (const [k, p] of this.items.entries()) {
+      if (!k.startsWith(`${key}.v`))
+        continue;
+      if (!candidate || compareVersions(p.meta.version, candidate.meta.version) > 0) {
+        candidate = p;
+      }
+    }
+    return candidate;
+  }
+  has(key, version) {
+    return !!this.get(key, version);
+  }
+  filter(criteria) {
+    return filterBy(this.list(), criteria);
+  }
+  listByTag(tag) {
+    return this.list().filter((p) => p.meta.tags?.includes(tag));
+  }
+  listByOwner(owner) {
+    return this.list().filter((p) => p.meta.owners?.includes(owner));
+  }
+  groupBy(keyFn) {
+    return groupBy(this.list(), keyFn);
+  }
+  getUniqueTags() {
+    return getUniqueTags(this.list());
+  }
+}
+
+// src/schema-to-markdown.ts
+import { isSchemaModel } from "@contractspec/lib.schema";
+function schemaToMarkdown(schema, data, options = {}) {
+  const { format = "auto", title, description, maxDepth = 2 } = options;
+  const lines = [];
+  if (title) {
+    lines.push(`# ${title}`, "");
+  }
+  if (description) {
+    lines.push(`> ${description}`, "");
+  }
+  const effectiveFormat = format === "auto" ? Array.isArray(data) ? "table" : "detail" : format;
+  if (effectiveFormat === "table" && Array.isArray(data)) {
+    lines.push(schemaToMarkdownTable(schema, data, options));
+  } else if (effectiveFormat === "list" && Array.isArray(data)) {
+    lines.push(schemaToMarkdownList(schema, data, options));
+  } else if (!Array.isArray(data) && data !== null && typeof data === "object") {
+    lines.push(schemaToMarkdownDetail(schema, data, { ...options, maxDepth }));
+  } else {
+    lines.push(`**Data:** ${String(data)}`, "");
+  }
+  return lines.join(`
+`);
+}
+function schemaToMarkdownTable(schema, items, options = {}) {
+  const { maxItems = 100, includeFields, excludeFields = [] } = options;
+  const fields = getFieldMeta(schema, includeFields, excludeFields);
+  if (fields.length === 0 || items.length === 0) {
+    return `_No data available_
+`;
+  }
+  const limitedItems = items.slice(0, maxItems);
+  const lines = [];
+  const headers = fields.map((f) => f.label);
+  lines.push(`| ${headers.join(" | ")} |`);
+  lines.push(`| ${headers.map(() => "---").join(" | ")} |`);
+  for (const item of limitedItems) {
+    const row = fields.map((f) => formatCellValue(getFieldValue(item, f.name)));
+    lines.push(`| ${row.join(" | ")} |`);
+  }
+  if (items.length > maxItems) {
+    lines.push("", `_Showing ${maxItems} of ${items.length} items_`);
+  }
+  lines.push("");
+  return lines.join(`
+`);
+}
+function schemaToMarkdownList(schema, items, options = {}) {
+  const {
+    maxItems = 50,
+    summaryFields,
+    includeFields,
+    excludeFields = []
+  } = options;
+  const fields = getFieldMeta(schema, includeFields, excludeFields);
+  const displayFields = summaryFields ? fields.filter((f) => summaryFields.includes(f.name)) : fields.slice(0, 3);
+  if (displayFields.length === 0 || items.length === 0) {
+    return `_No data available_
+`;
+  }
+  const limitedItems = items.slice(0, maxItems);
+  const lines = [];
+  for (const item of limitedItems) {
+    const primaryValue = formatCellValue(getFieldValue(item, displayFields[0]?.name ?? "id"));
+    const secondaryValues = displayFields.slice(1).map((f) => `${f.label}: ${formatCellValue(getFieldValue(item, f.name))}`).join(" \xB7 ");
+    const itemLine = secondaryValues ? `- **${primaryValue}** (${secondaryValues})` : `- **${primaryValue}**`;
+    lines.push(itemLine);
+  }
+  if (items.length > maxItems) {
+    lines.push("", `_Showing ${maxItems} of ${items.length} items_`);
+  }
+  lines.push("");
+  return lines.join(`
+`);
+}
+function schemaToMarkdownDetail(schema, item, options = {}) {
+  const { includeFields, excludeFields = [], maxDepth = 2 } = options;
+  if (item === null || typeof item !== "object") {
+    return `_No data available_
+`;
+  }
+  const fields = getFieldMeta(schema, includeFields, excludeFields);
+  if (fields.length === 0) {
+    return `_No fields to display_
+`;
+  }
+  const lines = [];
+  for (const field of fields) {
+    const value = getFieldValue(item, field.name);
+    const formattedValue = formatDetailValue(value, maxDepth, 0);
+    lines.push(`**${field.label}:** ${formattedValue}`);
+  }
+  lines.push("");
+  return lines.join(`
+`);
+}
+function schemaToMarkdownSummary(items, options = {}) {
+  const { numericFields = [], countByField } = options;
+  const lines = [];
+  lines.push(`**Total Items:** ${items.length}`);
+  for (const fieldName of numericFields) {
+    const values = items.map((item) => getFieldValue(item, fieldName)).filter((v) => typeof v === "number");
+    if (values.length > 0) {
+      const sum = values.reduce((a, b) => a + b, 0);
+      const avg = sum / values.length;
+      const min = Math.min(...values);
+      const max = Math.max(...values);
+      lines.push(`**${formatFieldName(fieldName)}:** Sum: ${formatNumber(sum)}, Avg: ${formatNumber(avg)}, Min: ${formatNumber(min)}, Max: ${formatNumber(max)}`);
+    }
+  }
+  if (countByField) {
+    const counts = {};
+    for (const item of items) {
+      const value = String(getFieldValue(item, countByField) ?? "Unknown");
+      counts[value] = (counts[value] ?? 0) + 1;
+    }
+    lines.push("", `**By ${formatFieldName(countByField)}:**`);
+    for (const [value, count] of Object.entries(counts)) {
+      lines.push(`- ${value}: ${count}`);
+    }
+  }
+  lines.push("");
+  return lines.join(`
+`);
+}
+function getFieldMeta(schema, includeFields, excludeFields = []) {
+  if (!isSchemaModel(schema)) {
+    return [];
+  }
+  const schemaFields = schema.config.fields;
+  const fieldNames = Object.keys(schemaFields);
+  const filteredFields = fieldNames.filter((name) => {
+    if (excludeFields.includes(name))
+      return false;
+    if (includeFields && !includeFields.includes(name))
+      return false;
+    return true;
+  });
+  return filteredFields.map((name) => {
+    const fieldConfig = schemaFields[name];
+    const isNested = Boolean(fieldConfig?.type && typeof fieldConfig.type === "object" && "config" in fieldConfig.type && typeof fieldConfig.type.config?.fields === "object");
+    return {
+      name,
+      label: formatFieldName(name),
+      isOptional: fieldConfig?.isOptional ?? false,
+      isArray: fieldConfig?.isArray === true,
+      isNested
+    };
+  });
+}
+function getFieldValue(item, fieldName) {
+  if (item === null || typeof item !== "object")
+    return;
+  const obj = item;
+  if (fieldName.includes(".")) {
+    const parts = fieldName.split(".");
+    let current = obj;
+    for (const part of parts) {
+      if (current === null || typeof current !== "object")
+        return;
+      current = current[part];
+    }
+    return current;
+  }
+  return obj[fieldName];
+}
+function formatCellValue(value) {
+  if (value === null || value === undefined)
+    return "-";
+  if (typeof value === "boolean")
+    return value ? "\u2713" : "\u2717";
+  if (typeof value === "number")
+    return formatNumber(value);
+  if (value instanceof Date)
+    return formatDate(value);
+  if (typeof value === "string" && isISODate(value))
+    return formatDate(new Date(value));
+  if (Array.isArray(value))
+    return `[${value.length} items]`;
+  if (typeof value === "object")
+    return "[Object]";
+  const str = String(value);
+  return str.length > 50 ? `${str.slice(0, 47)}...` : str.replace(/\|/g, "\\|");
+}
+function formatDetailValue(value, maxDepth, currentDepth) {
+  if (value === null || value === undefined)
+    return "_none_";
+  if (typeof value === "boolean")
+    return value ? "Yes" : "No";
+  if (typeof value === "number")
+    return formatNumber(value);
+  if (value instanceof Date)
+    return formatDate(value);
+  if (typeof value === "string" && isISODate(value))
+    return formatDate(new Date(value));
+  if (Array.isArray(value)) {
+    if (value.length === 0)
+      return "_empty list_";
+    if (currentDepth >= maxDepth)
+      return `[${value.length} items]`;
+    if (value.length <= 5 && value.every((v) => typeof v !== "object")) {
+      return value.map((v) => formatCellValue(v)).join(", ");
+    }
+    return `[${value.length} items]`;
+  }
+  if (typeof value === "object") {
+    if (currentDepth >= maxDepth)
+      return "[Object]";
+    const keys = Object.keys(value);
+    return `{${keys.length} fields}`;
+  }
+  return String(value);
+}
+function formatFieldName(name) {
+  return name.replace(/([a-z])([A-Z])/g, "$1 $2").replace(/_/g, " ").replace(/^\w/, (c) => c.toUpperCase());
+}
+function formatNumber(value) {
+  if (Math.abs(value) >= 1000) {
+    return new Intl.NumberFormat("en-US", {
+      maximumFractionDigits: 2
+    }).format(value);
+  }
+  if (Number.isInteger(value)) {
+    return String(value);
+  }
+  return value.toFixed(2);
+}
+function formatDate(date) {
+  return date.toLocaleDateString("en-US", {
+    year: "numeric",
+    month: "short",
+    day: "numeric"
+  });
+}
+function isISODate(str) {
+  if (!/^\d{4}-\d{2}-\d{2}/.test(str))
+    return false;
+  const date = new Date(str);
+  return !isNaN(date.getTime());
+}
+
+// src/presentations/transform-engine.ts
+import React from "react";
+import TurndownService from "turndown";
+var turndown = new TurndownService;
+function renderTextNode(node) {
+  const text = node.text ?? "";
+  if (!node.marks || node.marks.length === 0)
+    return text;
+  return node.marks.reduce((acc, mark) => {
+    switch (mark.type) {
+      case "bold":
+        return `**${acc}**`;
+      case "italic":
+        return `*${acc}*`;
+      case "underline":
+        return `__${acc}__`;
+      case "strike":
+        return `~~${acc}~~`;
+      case "code":
+        return `\`${acc}\``;
+      case "link": {
+        const href = mark.attrs?.href ?? "";
+        return href ? `[${acc}](${href})` : acc;
+      }
+      default:
+        return acc;
+    }
+  }, text);
+}
+function renderInline(nodes) {
+  if (!nodes?.length)
+    return "";
+  return nodes.map((child) => renderNode(child)).join("");
+}
+function renderList(nodes, ordered = false) {
+  if (!nodes?.length)
+    return "";
+  let counter = 1;
+  return nodes.map((item) => {
+    const body = renderInline(item.content ?? []);
+    if (!body)
+      return "";
+    const prefix = ordered ? `${counter++}. ` : "- ";
+    return `${prefix}${body}`;
+  }).filter(Boolean).join(`
+`);
+}
+function renderNode(node) {
+  switch (node.type) {
+    case "doc":
+      return renderInline(node.content);
+    case "paragraph": {
+      const text = renderInline(node.content);
+      return text.trim().length ? text : "";
+    }
+    case "heading": {
+      const levelAttr = node.attrs?.level;
+      const levelVal = typeof levelAttr === "number" ? levelAttr : 1;
+      const level = Math.min(Math.max(levelVal, 1), 6);
+      return `${"#".repeat(level)} ${renderInline(node.content)}`.trim();
+    }
+    case "bullet_list":
+      return renderList(node.content, false);
+    case "ordered_list":
+      return renderList(node.content, true);
+    case "list_item":
+      return renderInline(node.content);
+    case "blockquote": {
+      const body = renderInline(node.content);
+      return body.split(`
+`).map((line) => `> ${line}`).join(`
+`);
+    }
+    case "code_block": {
+      const body = renderInline(node.content);
+      return body ? `\`\`\`
+${body}
+\`\`\`` : "";
+    }
+    case "horizontal_rule":
+      return "---";
+    case "hard_break":
+      return `
+`;
+    case "text":
+      return renderTextNode(node);
+    default:
+      if (node.text)
+        return renderTextNode(node);
+      return "";
+  }
+}
+function blockNoteToMarkdown(docJson) {
+  if (typeof docJson === "string")
+    return docJson;
+  if (docJson && typeof docJson === "object" && "html" in docJson) {
+    const html = String(docJson.html);
+    return turndown.turndown(html);
+  }
+  const root = docJson;
+  if (root?.type === "doc" || root?.content) {
+    const blocks = (root.content ?? []).map((n) => renderNode(n)).filter(Boolean);
+    return blocks.join(`
+
+`).trim();
+  }
+  try {
+    return JSON.stringify(docJson, null, 2);
+  } catch {
+    return String(docJson);
+  }
+}
+
+class TransformEngine {
+  renderers = new Map;
+  validators = [];
+  register(renderer) {
+    const arr = this.renderers.get(renderer.target) ?? [];
+    arr.push(renderer);
+    this.renderers.set(renderer.target, arr);
+    return this;
+  }
+  prependRegister(renderer) {
+    const arr = this.renderers.get(renderer.target) ?? [];
+    arr.unshift(renderer);
+    this.renderers.set(renderer.target, arr);
+    return this;
+  }
+  addValidator(v) {
+    this.validators.push(v);
+    return this;
+  }
+  async render(target, desc, ctx) {
+    if (!desc.targets.includes(target))
+      throw new Error(`Target ${target} not declared for ${desc.meta.key}.v${desc.meta.version}`);
+    for (const v of this.validators)
+      await v.validate(desc, target, ctx);
+    const arr = this.renderers.get(target) ?? [];
+    for (const r of arr) {
+      try {
+        const out = await r.render(desc, ctx);
+        return out;
+      } catch (_e) {}
+    }
+    throw new Error(`No renderer available for ${target}`);
+  }
+}
+function createDefaultTransformEngine() {
+  const engine = new TransformEngine;
+  const applyPii = (desc, obj) => {
+    const clone = JSON.parse(JSON.stringify(obj));
+    const paths = desc.policy?.pii ?? [];
+    const setAtPath = (root, path) => {
+      const segs = path.replace(/^\//, "").replace(/\[(\d+)\]/g, ".$1").split(".").filter(Boolean);
+      let cur = root;
+      for (let i = 0;i < segs.length - 1; i++) {
+        const k = segs[i];
+        if (!k)
+          continue;
+        if (cur && typeof cur === "object" && k in cur) {
+          cur = cur[k];
+        } else
+          return;
+      }
+      const last = segs[segs.length - 1];
+      if (cur && typeof cur === "object" && last && last in cur)
+        cur[last] = "[REDACTED]";
+    };
+    for (const p of paths)
+      setAtPath(clone, p);
+    return clone;
+  };
+  engine.register({
+    target: "markdown",
+    async render(desc, ctx) {
+      let data = ctx?.data;
+      if (!data && ctx?.fetchData) {
+        data = await ctx.fetchData();
+      }
+      if (desc.source.type === "component" && desc.source.props && data !== undefined) {
+        const isArray = Array.isArray(data);
+        const isSimpleObject = !isArray && typeof data === "object" && data !== null && !Object.values(data).some((v) => Array.isArray(v) || typeof v === "object" && v !== null);
+        if (isArray || isSimpleObject) {
+          const body = schemaToMarkdown(desc.source.props, data, {
+            title: desc.meta.description ?? desc.meta.key,
+            description: `${desc.meta.key} v${desc.meta.version}`
+          });
+          return { mimeType: "text/markdown", body };
+        }
+        throw new Error(`Complex data structure for ${desc.meta.key} - expecting custom renderer`);
+      }
+      if (desc.source.type === "blocknotejs") {
+        const markdown = blockNoteToMarkdown(desc.source.docJson);
+        const redacted = applyPii(desc, { text: markdown });
+        return { mimeType: "text/markdown", body: String(redacted.text) };
+      }
+      if (desc.source.type === "component" && data !== undefined) {
+        throw new Error(`No schema (source.props) available for ${desc.meta.key} - expecting custom renderer`);
+      }
+      if (desc.source.type === "component") {
+        const header = `# ${desc.meta.key} v${desc.meta.version}`;
+        const about = desc.meta.description ? `
+
+${desc.meta.description}` : "";
+        const tags = desc.meta.tags && desc.meta.tags.length ? `
+
+Tags: ${desc.meta.tags.join(", ")}` : "";
+        const owners = desc.meta.owners && desc.meta.owners.length ? `
+
+Owners: ${desc.meta.owners.join(", ")}` : "";
+        const comp = `
+
+Component: \`${desc.source.componentKey}\``;
+        const policy = desc.policy?.pii?.length ? `
+
+Redacted paths: ${desc.policy.pii.map((p) => `\`${p}\``).join(", ")}` : "";
+        const body = `${header}${about}${tags}${owners}${comp}${policy}`;
+        return { mimeType: "text/markdown", body };
+      }
+      throw new Error("unsupported");
+    }
+  });
+  engine.register({
+    target: "application/json",
+    async render(desc) {
+      const payload = applyPii(desc, { meta: desc.meta, source: desc.source });
+      return {
+        mimeType: "application/json",
+        body: JSON.stringify(payload, null, 2)
+      };
+    }
+  });
+  engine.register({
+    target: "application/xml",
+    async render(desc) {
+      const json = applyPii(desc, { meta: desc.meta, source: desc.source });
+      const body = `<presentation name="${desc.meta.key}" version="${desc.meta.version}"><json>${encodeURIComponent(JSON.stringify(json))}</json></presentation>`;
+      return { mimeType: "application/xml", body };
+    }
+  });
+  return engine;
+}
+function registerDefaultReactRenderer(engine) {
+  engine.register({
+    target: "react",
+    async render(desc) {
+      if (desc.source.type === "component") {
+        const props = desc.source.props ? desc.source.props.getZod().safeParse({}).success ? {} : undefined : undefined;
+        return {
+          kind: "react_component",
+          componentKey: desc.source.componentKey,
+          props
+        };
+      }
+      return {
+        kind: "blocknotejs",
+        docJson: desc.source.docJson,
+        blockConfig: desc.source.blockConfig
+      };
+    }
+  });
+  return engine;
+}
+function registerBasicValidation(engine) {
+  engine.addValidator({
+    validate(desc) {
+      if (!desc.meta.description || desc.meta.description.length < 3)
+        throw new Error(`Presentation ${desc.meta.key}.v${desc.meta.version} missing meta.description`);
+    }
+  });
+  return engine;
+}
+function registerReactToMarkdownRenderer(engine, componentMap) {
+  const turndownService = new TurndownService({
+    headingStyle: "atx",
+    codeBlockStyle: "fenced",
+    bulletListMarker: "-"
+  });
+  turndownService.addRule("link", {
+    filter: "a",
+    replacement: (content, node) => {
+      const href = node.href;
+      if (href && content) {
+        return `[${content}](${href})`;
+      }
+      return content || "";
+    }
+  });
+  engine.prependRegister({
+    target: "markdown",
+    async render(desc, _ctx) {
+      if (desc.source.type !== "component") {
+        throw new Error("React-to-markdown renderer only handles component presentations");
+      }
+      const { renderToStaticMarkup } = await import("react-dom/server");
+      const Component = componentMap[desc.source.componentKey];
+      if (!Component) {
+        throw new Error(`Component ${desc.source.componentKey} not found in componentMap`);
+      }
+      let html;
+      try {
+        const element = React.createElement(Component, desc.source.props ? {} : undefined);
+        html = renderToStaticMarkup(element);
+      } catch (error) {
+        throw new Error(`Failed to render component ${desc.source.componentKey}: ${error instanceof Error ? error.message : "Unknown error"}`);
+      }
+      let markdown;
+      try {
+        markdown = turndownService.turndown(html);
+      } catch (error) {
+        throw new Error(`Failed to convert HTML to markdown: ${error instanceof Error ? error.message : "Unknown error"}`);
+      }
+      if (desc.policy?.pii && desc.policy.pii.length > 0) {
+        const redacted = markdown.replace(/\[REDACTED\]/g, "[REDACTED]");
+        return { mimeType: "text/markdown", body: redacted };
+      }
+      return { mimeType: "text/markdown", body: markdown };
+    }
+  });
+  return engine;
+}
+
+// src/presentations/presentations.ts
+var definePresentation = (spec) => {
+  return spec;
+};
+
+// src/presentations/registry.ts
+class PresentationRegistry extends SpecContractRegistry {
+  constructor(items) {
+    super("presentation", items);
+  }
+}
+// src/client/react/feature-render.ts
+import React2 from "react";
+function createEngineWithDefaults() {
+  return registerBasicValidation(registerDefaultReactRenderer(createDefaultTransformEngine()));
+}
+async function renderFeaturePresentation(engine, target, desc, options) {
+  if (target === "react") {
+    const rd = await engine.render("react", desc);
+    if (rd.kind === "react_component") {
+      const map = options?.componentMap ?? {};
+      const C = map[rd.componentKey];
+      if (!C)
+        return null;
+      const merged = {
+        ...rd.props ?? {},
+        ...options?.reactProps ?? {}
+      };
+      return React2.createElement(C, merged);
+    }
+    if (rd.kind === "blocknotejs") {
+      if (options?.renderBlockNote)
+        return options.renderBlockNote(rd.docJson, rd.blockConfig);
+      return React2.createElement("div", {}, "[BlockNote renderer not configured]");
+    }
+    return null;
+  }
+  if (target === "markdown")
+    return engine.render(target, desc);
+  if (target === "application/json")
+    return engine.render(target, desc);
+  if (target === "application/xml")
+    return engine.render(target, desc);
+  return null;
+}
+function createFeatureModule(meta, refs) {
+  return { meta, ...refs };
+}
+function registerFeature(registry2, feature) {
+  registry2.register(feature);
+  return registry2;
+}
+
+// src/forms/forms.ts
+import { compareVersions as compareVersions2 } from "compare-versions";
+function formKey(meta) {
+  return `${meta.key}.v${meta.version}`;
+}
+
+class FormRegistry {
+  items = new Map;
+  register(spec) {
+    const key = formKey(spec.meta);
+    if (this.items.has(key))
+      throw new Error(`Duplicate form ${key}`);
+    this.items.set(key, spec);
+    return this;
+  }
+  list() {
+    return [...this.items.values()];
+  }
+  get(key, version) {
+    if (version != null)
+      return this.items.get(`${key}.v${version}`);
+    let candidate;
+    for (const [k, v] of this.items.entries()) {
+      if (v.meta.key !== key)
+        continue;
+      if (!candidate || compareVersions2(v.meta.version, candidate.meta.version) > 0) {
+        candidate = v;
+      }
+    }
+    return candidate;
+  }
+  filter(criteria) {
+    const { filterBy: filterBy2 } = (init_registry_utils(), __toCommonJS(exports_registry_utils));
+    return filterBy2(this.list(), criteria);
+  }
+  listByTag(tag) {
+    return this.list().filter((f) => f.meta.tags?.includes(tag));
+  }
+  listByOwner(owner) {
+    return this.list().filter((f) => f.meta.owners?.includes(owner));
+  }
+  groupBy(keyFn) {
+    const { groupBy: groupBy2 } = (init_registry_utils(), __toCommonJS(exports_registry_utils));
+    return groupBy2(this.list(), keyFn);
+  }
+  getUniqueTags() {
+    const { getUniqueTags: getUniqueTags2 } = (init_registry_utils(), __toCommonJS(exports_registry_utils));
+    return getUniqueTags2(this.list());
+  }
+}
+function getAtPath(values, path) {
+  if (!path)
+    return;
+  const segs = path.replace(/\[(\d+)\]/g, ".$1").split(".").filter(Boolean);
+  let cur = values;
+  for (const s of segs) {
+    if (cur == null)
+      return;
+    if (cur && typeof cur === "object" && s in cur) {
+      cur = cur[s];
+    } else {
+      return;
+    }
+  }
+  return cur;
+}
+function evalPredicate(values, pred) {
+  if (!pred)
+    return true;
+  if (pred.not)
+    return !evalPredicate(values, pred.not);
+  if (pred.all && pred.all.length)
+    return pred.all.every((p) => evalPredicate(values, p));
+  if (pred.anyOf && pred.anyOf.length)
+    return pred.anyOf.some((p) => evalPredicate(values, p));
+  if (pred.when) {
+    const { path, op = "truthy", value } = pred.when;
+    const v = getAtPath(values, path);
+    switch (op) {
+      case "equals":
+        return v === value;
+      case "notEquals":
+        return v !== value;
+      case "in":
+        return Array.isArray(value) && value.includes(v);
+      case "notIn":
+        return Array.isArray(value) && !value.includes(v);
+      case "gt":
+        return Number(v) > Number(value);
+      case "gte":
+        return Number(v) >= Number(value);
+      case "lt":
+        return Number(v) < Number(value);
+      case "lte":
+        return Number(v) <= Number(value);
+      case "empty":
+        return v == null || (Array.isArray(v) ? v.length === 0 : String(v).length === 0);
+      case "lengthGt":
+        return (Array.isArray(v) || typeof v === "string") && v.length > Number(value ?? 0);
+      case "lengthGte":
+        return (Array.isArray(v) || typeof v === "string") && v.length >= Number(value ?? 0);
+      case "lengthLt":
+        return (Array.isArray(v) || typeof v === "string") && v.length < Number(value ?? 0);
+      case "lengthLte":
+        return (Array.isArray(v) || typeof v === "string") && v.length <= Number(value ?? 0);
+      case "truthy":
+      default:
+        return Boolean(v);
+    }
+  }
+  return true;
+}
+function buildZodWithRelations(spec, handlers) {
+  const base = spec.model.getZod();
+  return base.superRefine((values, ctx) => {
+    const visit = (field, parentPath) => {
+      const path = field.name ? parentPath ? `${parentPath}.${field.name}` : field.name : parentPath ?? "";
+      if (field.requiredWhen) {
+        const should = evalPredicate(values, field.requiredWhen);
+        if (should) {
+          const v = getAtPath(values, path);
+          const empty = v == null || typeof v === "string" && v.trim().length === 0 || Array.isArray(v) && v.length === 0;
+          if (empty)
+            ctx.addIssue({
+              code: "custom",
+              path: path.split("."),
+              message: "required"
+            });
+        }
+      }
+      if (field.kind === "array") {
+        const arr = getAtPath(values, path);
+        if (field.min != null && Array.isArray(arr) && arr.length < field.min) {
+          ctx.addIssue({
+            code: "custom",
+            path: path.split("."),
+            message: `min:${field.min}`
+          });
+        }
+        if (field.max != null && Array.isArray(arr) && arr.length > field.max) {
+          ctx.addIssue({
+            code: "custom",
+            path: path.split("."),
+            message: `max:${field.max}`
+          });
+        }
+        visit(field.of, path);
+      } else if (field.kind === "group") {
+        for (const child of field.fields)
+          visit(child, path);
+      }
+    };
+    for (const f of spec.fields)
+      visit(f);
+    if (spec.constraints && handlers) {
+      for (const c of spec.constraints) {
+        const fn = handlers[c.key];
+        if (!fn)
+          continue;
+        const res = fn(values, c.paths, c.args);
+        if (!res.ok) {
+          ctx.addIssue({
+            code: "custom",
+            path: (res.path ?? c.paths[0] ?? "").split(".").filter(Boolean),
+            message: res.message ?? c.messageI18n
+          });
+        }
+      }
+    }
+  });
+}
+function defineFormSpec(spec) {
+  return spec;
+}
+// src/client/react/form-render.tsx
+import React3, { useEffect, useMemo, useState } from "react";
+import {
+  Controller,
+  useFieldArray,
+  useForm
+} from "react-hook-form";
+import { zodResolver } from "@hookform/resolvers/zod";
+import { jsxDEV, Fragment } from "react/jsx-dev-runtime";
+"use client";
+function toOptionsArray(src) {
+  if (!src)
+    return;
+  if (Array.isArray(src))
+    return { kind: "static", options: src };
+  return src;
+}
+function getAtPath2(values, path) {
+  if (!path)
+    return;
+  const segs = path.replace(/\[(\d+)\]/g, ".$1").split(".").filter(Boolean);
+  let cur = values;
+  for (const s of segs) {
+    if (cur == null)
+      return;
+    cur = cur[s];
+  }
+  return cur;
+}
+function makeDepsKey(values, deps) {
+  if (!deps || deps.length === 0)
+    return "[]";
+  try {
+    return JSON.stringify(deps.map((d) => getAtPath2(values, d)));
+  } catch {
+    return "[]";
+  }
+}
+function useResolvedOptions(values, source, resolvers) {
+  const [opts, setOpts] = useState([]);
+  const depKey = useMemo(() => {
+    if (!source)
+      return "nil";
+    if (source.kind === "static")
+      return JSON.stringify(source.options ?? []);
+    return makeDepsKey(values, source.deps);
+  }, [source, values]);
+  useEffect(() => {
+    let mounted = true;
+    const run = async () => {
+      if (!source)
+        return setOpts([]);
+      if (source.kind === "static")
+        return setOpts([...source.options ?? []]);
+      const fn = resolvers?.[source.resolverKey];
+      if (!fn)
+        return setOpts([]);
+      const res = await fn(values, source.args);
+      if (mounted)
+        setOpts([...res ?? []]);
+    };
+    run();
+    return () => {
+      mounted = false;
+    };
+  }, [
+    depKey,
+    source && source.kind === "resolver" ? source.resolverKey : undefined
+  ]);
+  return opts;
+}
+function fieldPath(parent, name, arrayIndex) {
+  if (!name)
+    return parent ?? "";
+  const child = typeof arrayIndex === "number" ? `${name.replace(/^\$index$/, String(arrayIndex))}` : name;
+  return parent ? `${parent}${typeof arrayIndex === "number" ? `.${arrayIndex}` : ""}.${child}`.replace(/\.+/g, ".") : child;
+}
+function createFormRenderer(base) {
+  const conf = base;
+  const { driver } = conf;
+  function InternalForm(props) {
+    const { spec, options, merged } = props;
+    const baseZod = useMemo(() => buildZodWithRelations(spec), [spec]);
+    const form = useForm({
+      ...merged.formOptions,
+      resolver: zodResolver(baseZod),
+      defaultValues: options?.defaultValues
+    });
+    const values = form.watch();
+    const renderOne = (f, parent, arrayIndex) => {
+      const DriverField = driver.Field;
+      const DriverLabel = driver.FieldLabel;
+      const DriverDesc = driver.FieldDescription;
+      const DriverError = driver.FieldError;
+      const name = fieldPath(parent, f.name, arrayIndex);
+      const visible = evalPredicate(values, f.visibleWhen);
+      const enabled = evalPredicate(values, f.enabledWhen);
+      const invalid = Boolean(form.getFieldState(name)?.invalid);
+      if (!visible)
+        return null;
+      const id = name?.replace(/\./g, "-");
+      const commonWrapProps = {
+        "data-invalid": invalid,
+        hidden: !visible,
+        disabled: !enabled
+      };
+      const labelNode = f.labelI18n ? /* @__PURE__ */ jsxDEV(DriverLabel, {
+        htmlFor: id,
+        children: f.labelI18n
+      }, undefined, false, undefined, this) : null;
+      const descNode = f.descriptionI18n ? /* @__PURE__ */ jsxDEV(DriverDesc, {
+        children: f.descriptionI18n
+      }, undefined, false, undefined, this) : null;
+      if (f.kind === "group") {
+        const children = f.fields.map((c, i) => /* @__PURE__ */ jsxDEV(React3.Fragment, {
+          children: renderOne(c, name, arrayIndex)
+        }, `${name}-${i}`, false, undefined, this));
+        return /* @__PURE__ */ jsxDEV(DriverField, {
+          ...commonWrapProps,
+          children: [
+            labelNode,
+            children,
+            descNode
+          ]
+        }, undefined, true, undefined, this);
+      }
+      if (f.kind === "array") {
+        return renderArray(f, parent);
+      }
+      return /* @__PURE__ */ jsxDEV(Controller, {
+        name,
+        control: form.control,
+        render: ({ field, fieldState }) => {
+          const err = fieldState.error ? [fieldState.error] : [];
+          const ariaInvalid = fieldState.invalid || undefined;
+          if (f.kind === "text") {
+            const textField = f;
+            const Input = driver.Input;
+            return /* @__PURE__ */ jsxDEV(DriverField, {
+              ...commonWrapProps,
+              children: [
+                labelNode,
+                /* @__PURE__ */ jsxDEV(Input, {
+                  id,
+                  "aria-invalid": ariaInvalid,
+                  placeholder: f.placeholderI18n,
+                  autoComplete: textField.autoComplete,
+                  inputMode: textField.inputMode,
+                  maxLength: textField.maxLength,
+                  minLength: textField.minLength,
+                  disabled: !enabled,
+                  ...field,
+                  ...f.uiProps
+                }, undefined, false, undefined, this),
+                descNode,
+                fieldState.invalid ? /* @__PURE__ */ jsxDEV(DriverError, {
+                  errors: err
+                }, undefined, false, undefined, this) : null
+              ]
+            }, undefined, true, undefined, this);
+          }
+          if (f.kind === "textarea") {
+            const textareaField = f;
+            const Textarea = driver.Textarea;
+            return /* @__PURE__ */ jsxDEV(DriverField, {
+              ...commonWrapProps,
+              children: [
+                labelNode,
+                /* @__PURE__ */ jsxDEV(Textarea, {
+                  id,
+                  "aria-invalid": ariaInvalid,
+                  placeholder: f.placeholderI18n,
+                  rows: textareaField.rows,
+                  maxLength: textareaField.maxLength,
+                  disabled: !enabled,
+                  ...field,
+                  ...f.uiProps
+                }, undefined, false, undefined, this),
+                descNode,
+                fieldState.invalid ? /* @__PURE__ */ jsxDEV(DriverError, {
+                  errors: err
+                }, undefined, false, undefined, this) : null
+              ]
+            }, undefined, true, undefined, this);
+          }
+          if (f.kind === "select") {
+            const selectField = f;
+            const Select = driver.Select;
+            const src = toOptionsArray(selectField.options);
+            const opts = useResolvedOptions(values, src, merged.resolvers);
+            return /* @__PURE__ */ jsxDEV(DriverField, {
+              ...commonWrapProps,
+              children: [
+                labelNode,
+                /* @__PURE__ */ jsxDEV(Select, {
+                  id,
+                  name,
+                  "aria-invalid": ariaInvalid,
+                  disabled: !enabled,
+                  value: field.value,
+                  onChange: (v) => field.onChange(v),
+                  options: opts,
+                  ...f.uiProps
+                }, undefined, false, undefined, this),
+                descNode,
+                fieldState.invalid ? /* @__PURE__ */ jsxDEV(DriverError, {
+                  errors: err
+                }, undefined, false, undefined, this) : null
+              ]
+            }, undefined, true, undefined, this);
+          }
+          if (f.kind === "checkbox") {
+            const Checkbox = driver.Checkbox;
+            return /* @__PURE__ */ jsxDEV(DriverField, {
+              ...commonWrapProps,
+              children: [
+                labelNode,
+                /* @__PURE__ */ jsxDEV(Checkbox, {
+                  id,
+                  name,
+                  disabled: !enabled,
+                  checked: !!field.value,
+                  onCheckedChange: (v) => field.onChange(v),
+                  ...f.uiProps
+                }, undefined, false, undefined, this),
+                descNode,
+                fieldState.invalid ? /* @__PURE__ */ jsxDEV(DriverError, {
+                  errors: err
+                }, undefined, false, undefined, this) : null
+              ]
+            }, undefined, true, undefined, this);
+          }
+          if (f.kind === "radio") {
+            const radioField = f;
+            const RadioGroup = driver.RadioGroup;
+            const src = toOptionsArray(radioField.options);
+            const opts = useResolvedOptions(values, src, merged.resolvers);
+            return /* @__PURE__ */ jsxDEV(DriverField, {
+              ...commonWrapProps,
+              children: [
+                labelNode,
+                /* @__PURE__ */ jsxDEV(RadioGroup, {
+                  id,
+                  name,
+                  disabled: !enabled,
+                  value: field.value,
+                  onValueChange: (v) => field.onChange(v),
+                  options: opts,
+                  ...f.uiProps
+                }, undefined, false, undefined, this),
+                descNode,
+                fieldState.invalid ? /* @__PURE__ */ jsxDEV(DriverError, {
+                  errors: err
+                }, undefined, false, undefined, this) : null
+              ]
+            }, undefined, true, undefined, this);
+          }
+          if (f.kind === "switch") {
+            const Switch = driver.Switch;
+            return /* @__PURE__ */ jsxDEV(DriverField, {
+              ...commonWrapProps,
+              children: [
+                labelNode,
+                /* @__PURE__ */ jsxDEV(Switch, {
+                  id,
+                  name,
+                  disabled: !enabled,
+                  checked: !!field.value,
+                  onCheckedChange: (v) => field.onChange(v),
+                  ...f.uiProps
+                }, undefined, false, undefined, this),
+                descNode,
+                fieldState.invalid ? /* @__PURE__ */ jsxDEV(DriverError, {
+                  errors: err
+                }, undefined, false, undefined, this) : null
+              ]
+            }, undefined, true, undefined, this);
+          }
+          return /* @__PURE__ */ jsxDEV(Fragment, {}, undefined, false, undefined, this);
+        }
+      }, name, false, undefined, this);
+    };
+    const renderArray = (f, parent) => {
+      const name = fieldPath(parent, f.name);
+      const { fields, append, remove } = useFieldArray({
+        control: form.control,
+        name
+      });
+      const canAdd = f.max == null || fields.length < f.max;
+      const canRemove = (idx) => (f.min == null ? fields.length > 0 : fields.length > f.min) && idx >= 0;
+      const Button2 = driver.Button;
+      const Label = driver.FieldLabel;
+      return /* @__PURE__ */ jsxDEV("div", {
+        children: [
+          f.labelI18n ? /* @__PURE__ */ jsxDEV(Label, {
+            children: f.labelI18n
+          }, undefined, false, undefined, this) : null,
+          fields.map((row, idx) => /* @__PURE__ */ jsxDEV("div", {
+            children: [
+              renderOne(f.of, name, idx),
+              canRemove(idx) ? /* @__PURE__ */ jsxDEV(Button2, {
+                type: "button",
+                variant: "ghost",
+                size: "sm",
+                onClick: () => remove(idx),
+                children: "Remove"
+              }, undefined, false, undefined, this) : null
+            ]
+          }, row.id ?? idx, true, undefined, this)),
+          canAdd ? /* @__PURE__ */ jsxDEV(Button2, {
+            type: "button",
+            variant: "outline",
+            size: "sm",
+            onClick: () => append({}),
+            children: "Add"
+          }, undefined, false, undefined, this) : null
+        ]
+      }, name, true, undefined, this);
+    };
+    const onSubmit = async (data) => {
+      const actionKey = spec.actions?.[0]?.key ?? "submit";
+      if (merged.onSubmitOverride) {
+        return merged.onSubmitOverride(data, actionKey);
+      }
+    };
+    const Button = driver.Button;
+    return /* @__PURE__ */ jsxDEV("form", {
+      onSubmit: form.handleSubmit(onSubmit),
+      children: [
+        (spec.fields || []).map((f, i) => /* @__PURE__ */ jsxDEV(React3.Fragment, {
+          children: renderOne(f)
+        }, i, false, undefined, this)),
+        spec.actions && spec.actions.length ? /* @__PURE__ */ jsxDEV("div", {
+          children: spec.actions.map((a) => /* @__PURE__ */ jsxDEV(Button, {
+            type: "submit",
+            children: a.labelI18n
+          }, a.key, false, undefined, this))
+        }, undefined, false, undefined, this) : null
+      ]
+    }, undefined, true, undefined, this);
+  }
+  return {
+    render: (spec, options) => /* @__PURE__ */ jsxDEV(InternalForm, {
+      spec,
+      options,
+      merged: {
+        ...conf,
+        ...options?.overrides ?? {}
+      }
+    }, undefined, false, undefined, this)
+  };
+}
+
+// src/client/react/drivers/shadcn.ts
+function shadcnDriver(slots) {
+  return slots;
+}
+
+// src/client/react/drivers/rn-reusables.ts
+function rnReusablesDriver(slots) {
+  return slots;
+}
+
+// src/client/react/index.ts
+"use client";
+export {
+  shadcnDriver,
+  rnReusablesDriver,
+  renderFeaturePresentation,
+  registerFeature,
+  createFormRenderer,
+  createFeatureModule,
+  createEngineWithDefaults
+};