@hanzo/ui 8.0.27 → 8.0.28

package/dist/framework/core.js

@@ -1,4 +1,21 @@
-'use client';
-export { BUILDER_FIELD_TYPES, CANCELLED, DRAFT, PROJECT_FIELD, REDACTED_MARKER, SUBMITTED, autonameSource, blankField, cardFields, createFrameworkClient, createMediaUploader, docTypeToFields, enrichLinks, fieldNameFromLabel, fieldNeedsOptions, fieldTypeLabel, fieldsFromDocType, hasProjectField, humanize, imageDimensions, isDraft, isMediaDoctype, isRef, isValidDoctypeName, joinKey, linkFields, listHiddenFields, listQuery, listedFieldNames, loadLinkOptions, looksLikeImage, makeFieldOptions, mediaDocPayload, mediaFileField, mediaKey, mediaRef, moduleDoctypes, moveField, newDraft, newKey, parseRef, rows, savePayload, slugify, starterFields, statusField, titleOf, toDocField, toDocType, toRecord, validateBuilder } from '../chunk-P2QU5MN5.js';
-//# sourceMappingURL=core.js.map
+// @hanzo/ui/framework/core — the CONTRACT half of the DocType layer, component-free.
+//
+// The wire types, the engine client, the metadata↔render mapping, the builder
+// projection, and the media/object-store model. It imports NO React and NO
+// @hanzo/gui, and its only @hanzo/data references are `import type` (erased at
+// build) — so a host's data layer, a server route, or a plain node test can bind
+// the engine WITHOUT loading a component tree.
+//
+//   import { createFrameworkClient } from '@hanzo/ui/framework/core'   // transport
+//   import { CollectionsBrowser }    from '@hanzo/ui/framework'        // + the views
+//
+// Two entries because they are two different things, not two ways to the same
+// thing: `@hanzo/ui/framework` re-exports everything here, so a UI host imports one
+// module and nothing is duplicated.
+export * from './types.js';
+export * from './client.js';
+export * from './fields.js';
+export * from './builder-logic.js';
+export * from './media.js';
+export * from './data.js';
 //# sourceMappingURL=core.js.map

package/dist/framework/core.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"core.js"}
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/framework/core.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,EAAE;AACF,8EAA8E;AAC9E,2EAA2E;AAC3E,+EAA+E;AAC/E,iFAAiF;AACjF,+CAA+C;AAC/C,EAAE;AACF,oFAAoF;AACpF,sFAAsF;AACtF,EAAE;AACF,8EAA8E;AAC9E,oFAAoF;AACpF,oCAAoC;AACpC,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA"}

package/dist/framework/data.cjs

@@ -0,0 +1,41 @@
+'use client';"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadLinkOptions = loadLinkOptions;
+exports.makeFieldOptions = makeFieldOptions;
+const fields_1 = require("./fields.cjs");
+/** The picker options for every Link field of `dt`: value = target id, label = its title. */
+async function loadLinkOptions(client, dt) {
+    const links = (0, fields_1.linkFields)(dt);
+    const out = {};
+    await Promise.all(links.map(async (f) => {
+        const target = f.options;
+        if (!target)
+            return;
+        // A target the caller can't read (403) → no options → the field falls back
+        // to a raw-id input (honest, never a fabricated candidate list).
+        const [tdt, docs] = await Promise.all([
+            client.doctypes.get(target).catch(() => null),
+            client.records.list(target, { limit: 200 }).catch(() => []),
+        ]);
+        out[f.fieldname] = docs.map((d) => ({
+            value: String(d.name),
+            label: tdt ? (0, fields_1.titleOf)(d, tdt) : String(d.name),
+        }));
+    }));
+    return out;
+}
+/**
+ * The `fieldOptions` callback @hanzo/data's views take: relation fields get their
+ * loaded target records; select fields get the choices declared in metadata (so
+ * the table cell and the form input agree). Everything else → undefined.
+ */
+function makeFieldOptions(linkOptions) {
+    return (field) => {
+        if (field.type === 'relation')
+            return linkOptions[field.name] ?? [];
+        if (field.type === 'select' || field.type === 'multiSelect') {
+            return field.metadata?.options;
+        }
+        return undefined;
+    };
+}

package/dist/framework/data.d.ts

@@ -6,8 +6,8 @@
  * the mobile card list and the record detail — no per-view duplication.
  */
 import type { SelectOption, FieldDefinition } from '@hanzo/data';
-import type { DocType } from './types';
-import type { FrameworkClient } from './client';
+import type { DocType } from './types.js';
+import type { FrameworkClient } from './client.js';
 /** The picker options for every Link field of `dt`: value = target id, label = its title. */
 export declare function loadLinkOptions(client: FrameworkClient, dt: DocType): Promise<Record<string, SelectOption[]>>;
 /**
@@ -16,3 +16,4 @@ export declare function loadLinkOptions(client: FrameworkClient, dt: DocType): P
  * the table cell and the form input agree). Everything else → undefined.
  */
 export declare function makeFieldOptions(linkOptions: Record<string, SelectOption[]>): (field: FieldDefinition) => SelectOption[] | undefined;
+//# sourceMappingURL=data.d.ts.map

package/dist/framework/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../src/framework/data.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAG/C,6FAA6F;AAC7F,wBAAsB,eAAe,CACnC,MAAM,EAAE,eAAe,EACvB,EAAE,EAAE,OAAO,GACV,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CAoBzC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,GAC1C,CAAC,KAAK,EAAE,eAAe,KAAK,YAAY,EAAE,GAAG,SAAS,CAQxD"}

package/dist/framework/data.js

@@ -0,0 +1,38 @@
+'use client';import { linkFields, titleOf } from './fields.js';
+/** The picker options for every Link field of `dt`: value = target id, label = its title. */
+export async function loadLinkOptions(client, dt) {
+    const links = linkFields(dt);
+    const out = {};
+    await Promise.all(links.map(async (f) => {
+        const target = f.options;
+        if (!target)
+            return;
+        // A target the caller can't read (403) → no options → the field falls back
+        // to a raw-id input (honest, never a fabricated candidate list).
+        const [tdt, docs] = await Promise.all([
+            client.doctypes.get(target).catch(() => null),
+            client.records.list(target, { limit: 200 }).catch(() => []),
+        ]);
+        out[f.fieldname] = docs.map((d) => ({
+            value: String(d.name),
+            label: tdt ? titleOf(d, tdt) : String(d.name),
+        }));
+    }));
+    return out;
+}
+/**
+ * The `fieldOptions` callback @hanzo/data's views take: relation fields get their
+ * loaded target records; select fields get the choices declared in metadata (so
+ * the table cell and the form input agree). Everything else → undefined.
+ */
+export function makeFieldOptions(linkOptions) {
+    return (field) => {
+        if (field.type === 'relation')
+            return linkOptions[field.name] ?? [];
+        if (field.type === 'select' || field.type === 'multiSelect') {
+            return field.metadata?.options;
+        }
+        return undefined;
+    };
+}
+//# sourceMappingURL=data.js.map

package/dist/framework/data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.js","sourceRoot":"","sources":["../../src/framework/data.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAE9C,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAuB,EACvB,EAAW;IAEX,MAAM,KAAK,GAAG,UAAU,CAAC,EAAE,CAAC,CAAA;IAC5B,MAAM,GAAG,GAAmC,EAAE,CAAA;IAC9C,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QACpB,MAAM,MAAM,GAAG,CAAC,CAAC,OAAO,CAAA;QACxB,IAAI,CAAC,MAAM;YAAE,OAAM;QACnB,2EAA2E;QAC3E,iEAAiE;QACjE,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACpC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;YAC7C,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;SAC5D,CAAC,CAAA;QACF,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAClC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;YACrB,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;SAC9C,CAAC,CAAC,CAAA;IACL,CAAC,CAAC,CACH,CAAA;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,WAA2C;IAE3C,OAAO,CAAC,KAAK,EAAE,EAAE;QACf,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU;YAAE,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;QACnE,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAC5D,OAAQ,KAAK,CAAC,QAAqD,EAAE,OAAO,CAAA;QAC9E,CAAC;QACD,OAAO,SAAS,CAAA;IAClB,CAAC,CAAA;AACH,CAAC"}

package/dist/framework/fields.cjs

@@ -0,0 +1,358 @@
+'use client';"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROJECT_FIELD = void 0;
+exports.humanize = humanize;
+exports.autonameSource = autonameSource;
+exports.docTypeToFields = docTypeToFields;
+exports.statusField = statusField;
+exports.listHiddenFields = listHiddenFields;
+exports.cardFields = cardFields;
+exports.listedFieldNames = listedFieldNames;
+exports.isMediaDoctype = isMediaDoctype;
+exports.mediaFileField = mediaFileField;
+exports.mediaDocPayload = mediaDocPayload;
+exports.moduleDoctypes = moduleDoctypes;
+exports.hasProjectField = hasProjectField;
+exports.isDraft = isDraft;
+exports.titleOf = titleOf;
+exports.slugify = slugify;
+exports.isValidDoctypeName = isValidDoctypeName;
+exports.toRecord = toRecord;
+exports.enrichLinks = enrichLinks;
+exports.linkFields = linkFields;
+exports.newDraft = newDraft;
+exports.savePayload = savePayload;
+const types_1 = require("./types.cjs");
+/**
+ * Frappe fieldtype → @hanzo/data field type. 1:1 cases; the value shape each
+ * needs is handled in `toRecord`/`savePayload` (currency object, boolean, etc).
+ * Attach is a single asset URL → `url` (a clickable link + text input); a Table /
+ * JSON renders as raw JSON (honest — no silent wrong guess). Password → `text`
+ * (write-only; the value is never surfaced, only set).
+ */
+const TYPE_MAP = {
+    Data: 'text',
+    SmallText: 'text',
+    Text: 'longText',
+    LongText: 'longText',
+    RichText: 'richText',
+    Int: 'number',
+    Float: 'number',
+    Currency: 'currency',
+    Check: 'boolean',
+    Date: 'date',
+    Datetime: 'dateTime',
+    Select: 'select',
+    Link: 'relation',
+    Table: 'json',
+    Attach: 'url',
+    JSON: 'json',
+    Password: 'text',
+};
+const ACRONYMS = new Set(['id', 'url', 'seo', 'api', 'ip']);
+/** `first_name` / `firstName` → "First Name"; known acronyms upper-cased. */
+function humanize(name) {
+    return name
+        .replace(/[_-]+/g, ' ')
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .trim()
+        .split(/\s+/)
+        .filter(Boolean)
+        .map((w) => (ACRONYMS.has(w.toLowerCase()) ? w.toUpperCase() : w.charAt(0).toUpperCase() + w.slice(1)))
+        .join(' ');
+}
+/** Select field's newline-separated choices → @hanzo/data options (blank dropped). */
+function selectOptions(options) {
+    return (options ?? '')
+        .split('\n')
+        .map((s) => s.replace(/\r$/, '').trim())
+        .filter(Boolean)
+        .map((v) => ({ value: v, label: v }));
+}
+/** Per-field @hanzo/data metadata (select options, currency code, relation target). */
+function metadataFor(f) {
+    switch (f.fieldtype) {
+        case 'Select':
+            return { options: selectOptions(f.options) };
+        case 'Currency':
+            return { currencyCode: 'USD' };
+        case 'Int':
+            return { decimals: 0 };
+        case 'Link':
+            return { objectName: f.options };
+        default:
+            return undefined;
+    }
+}
+/** The autoname source field for a `field:xxx` rule (`""` otherwise). */
+function autonameSource(dt) {
+    const a = (dt.autoname ?? '').trim();
+    return a.startsWith('field:') ? a.slice('field:'.length).trim() : '';
+}
+/**
+ * Map a DocType's fields to the ordered `FieldDefinition[]` every @hanzo/data view
+ * renders from. Hidden fields are dropped; the engine's readOnly is honored; and
+ * when editing an existing record the autoname source (e.g. `slug`) is made
+ * read-only because it IS the document's immutable URL key.
+ */
+function docTypeToFields(dt, opts = {}) {
+    const src = autonameSource(dt);
+    return (dt.fields ?? [])
+        .filter((f) => !f.hidden)
+        .map((f) => {
+        const readOnly = f.readOnly || (opts.editing && f.fieldname === src) || undefined;
+        const metadata = metadataFor(f);
+        return {
+            name: f.fieldname,
+            label: f.label || humanize(f.fieldname),
+            type: TYPE_MAP[f.fieldtype] ?? 'text',
+            ...(metadata ? { metadata } : {}),
+            ...(readOnly ? { readOnly: true } : {}),
+        };
+    });
+}
+/** The status field a publishable content type uses (a Select including "Published"). */
+function statusField(dt) {
+    const f = (dt.fields ?? []).find((x) => x.fieldtype === 'Select' && x.fieldname === 'status' && (x.options ?? '').includes('Published'));
+    return f ? f.fieldname : '';
+}
+/**
+ * Field names hidden from the table grid: everything NOT flagged `inListView`
+ * (when the DocType flags any). This is the engine's own column projection —
+ * an ERP Sales Order declares 4 list columns out of 12 fields, so honoring it is
+ * what keeps a wide DocType from becoming a horizontally-scrolling wall.
+ */
+function listHiddenFields(dt) {
+    const anyListed = (dt.fields ?? []).some((f) => f.inListView);
+    if (!anyListed)
+        return [];
+    return (dt.fields ?? []).filter((f) => !f.inListView && !f.hidden).map((f) => f.fieldname);
+}
+/**
+ * The fields shown on a MOBILE card, in order: the DocType's declared list columns
+ * (`inListView`), else the first few visible fields. The title is rendered by the
+ * card itself, so it is excluded here. Capped, because a card is a summary — the
+ * full record is one tap away.
+ */
+function cardFields(dt, fields, max = 4) {
+    const title = dt.titleField ?? '';
+    const listed = new Set(listedFieldNames(dt));
+    const pick = listed.size ? fields.filter((f) => listed.has(f.name)) : fields;
+    return pick.filter((f) => f.name !== title).slice(0, max);
+}
+/** The `inListView` field names (empty when the DocType flags none). */
+function listedFieldNames(dt) {
+    return (dt.fields ?? []).filter((f) => f.inListView && !f.hidden).map((f) => f.fieldname);
+}
+/** True when a DocType is a media/asset library (a required Attach) → grid view. */
+function isMediaDoctype(dt) {
+    return (dt.fields ?? []).some((f) => f.fieldtype === 'Attach' && f.reqd);
+}
+/** The primary Attach field name (the asset URL) of a media doctype. */
+function mediaFileField(dt) {
+    const f = (dt.fields ?? []).find((x) => x.fieldtype === 'Attach' && x.reqd) ??
+        (dt.fields ?? []).find((x) => x.fieldtype === 'Attach');
+    return f ? f.fieldname : '';
+}
+/**
+ * The create body for a media document — METADATA-DRIVEN, not a hardcoded CMS
+ * schema. The file lands on the DocType's own Attach field, the filename on its
+ * declared `titleField` (else `title` if it has one), and each optional fact
+ * (`mime`/`size`/`width`/`height`) is written ONLY when the DocType actually
+ * declares that field. A media collection that names its label `caption` gets a
+ * captioned row instead of an untitled one, and a lane whose media DocType has no
+ * dimensions never ships dead keys.
+ */
+function mediaDocPayload(dt, facts) {
+    const declared = new Set((dt.fields ?? []).map((f) => f.fieldname));
+    const out = {};
+    const fileField = mediaFileField(dt);
+    if (fileField)
+        out[fileField] = facts.fileRef;
+    const titleF = dt.titleField && declared.has(dt.titleField) ? dt.titleField : declared.has('title') ? 'title' : '';
+    if (titleF && titleF !== fileField)
+        out[titleF] = facts.filename;
+    const optional = [
+        ['mime', facts.mime],
+        ['size', facts.size],
+        ['width', facts.width],
+        ['height', facts.height],
+    ];
+    for (const [k, v] of optional)
+        if (declared.has(k) && k !== fileField && k !== titleF)
+            out[k] = v;
+    return out;
+}
+/** DocTypes belonging to an app lane (module) — a CMS "collection" is one of these. */
+function moduleDoctypes(dts, module) {
+    return dts.filter((dt) => (dt.module ?? '') === module);
+}
+/** The conventional field a collection uses to scope documents to a project. */
+exports.PROJECT_FIELD = 'project';
+/** True when a DocType declares the `project` scope field (→ project filtering works). */
+function hasProjectField(dt) {
+    return (dt.fields ?? []).some((f) => f.fieldname === exports.PROJECT_FIELD);
+}
+/**
+ * The engine refuses to edit or delete a document that is no longer a draft
+ * (`ops.go`: "document is not a draft (docstatus %d); cannot edit" and "submitted
+ * document must be cancelled before deletion"). So the views ASK before offering
+ * the affordance — a submitted invoice shows no Edit button rather than a full
+ * form that errors on Save.
+ */
+function isDraft(record) {
+    return Number(record?.docstatus ?? types_1.DRAFT) === types_1.DRAFT;
+}
+/** A record's human title — the DocType's titleField, else its name. */
+function titleOf(doc, dt) {
+    if (dt.titleField && typeof doc[dt.titleField] === 'string' && doc[dt.titleField]) {
+        return String(doc[dt.titleField]);
+    }
+    return typeof doc.name === 'string' && doc.name ? doc.name : '(untitled)';
+}
+/**
+ * URL-safe slug from arbitrary text: lower-case, any run of non-alphanumerics
+ * collapsed to a single dash, ends trimmed. Guarantees a no-space, `%`-free
+ * document name (the engine and a host's proxy path both require it).
+ */
+function slugify(s) {
+    return String(s ?? '')
+        .normalize('NFKD')
+        .replace(/[\u0300-\u036f]/g, '') // strip diacritics (accents → ASCII)
+        .toLowerCase()
+        .trim()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+/** Valid Pascal/slug DocType name (letters/digits/dash/underscore, alnum-led, no space). */
+function isValidDoctypeName(name) {
+    return /^[A-Za-z0-9][A-Za-z0-9_-]*$/.test(name.trim());
+}
+const secToMs = (v) => {
+    const n = Number(v);
+    return Number.isFinite(n) && n > 0 ? n * 1000 : undefined;
+};
+const numOrNull = (v) => {
+    const n = Number(v);
+    return Number.isFinite(n) ? n : null;
+};
+/** One field value, framework wire → @hanzo/data display shape. */
+function coerceForDisplay(f, v) {
+    switch (f.fieldtype) {
+        case 'Currency':
+            return { amount: numOrNull(v), currencyCode: 'USD' };
+        case 'Check':
+            return v === 1 || v === true || v === '1';
+        case 'Datetime':
+            return typeof v === 'string' ? v.replace(' ', 'T') : v;
+        case 'Password':
+            return v === types_1.REDACTED_MARKER ? '' : v; // never surface the marker
+        default:
+            return v;
+    }
+}
+/**
+ * A framework document → a flat @hanzo/data record: the field values coerced to
+ * their display shapes, plus `id` (the record key every view uses) and the managed
+ * envelope. The ONE read mapping every DocType view shares.
+ */
+function toRecord(doc, dt) {
+    const rec = {
+        id: doc.name,
+        name: doc.name,
+        doctype: doc.doctype,
+        docstatus: doc.docstatus,
+        createdAt: secToMs(doc.createdAt),
+        updatedAt: secToMs(doc.updatedAt),
+    };
+    for (const f of dt.fields ?? []) {
+        if (!(f.fieldname in doc))
+            continue;
+        rec[f.fieldname] = coerceForDisplay(f, doc[f.fieldname]);
+    }
+    return rec;
+}
+/** One draft value, @hanzo/data edit shape → framework wire. */
+function coerceForWrite(f, v) {
+    switch (f.fieldtype) {
+        case 'Currency':
+            return v && typeof v === 'object' && 'amount' in v ? Number(v.amount) : Number(v);
+        case 'Check':
+            return Boolean(v);
+        case 'Int':
+        case 'Float':
+            return Number(v);
+        case 'Datetime':
+            if (v instanceof Date)
+                return v.toISOString();
+            if (typeof v === 'number' && Number.isFinite(v))
+                return new Date(v).toISOString();
+            return v;
+        case 'Link':
+            // The picker stores a plain id (string); an unedited enriched value is
+            // {id,label}; a cleared value is null. The engine wants the id string ('' = clear).
+            if (v == null || v === '')
+                return '';
+            if (typeof v === 'object') {
+                return String(v.id ?? v.value ?? '');
+            }
+            return v;
+        default:
+            return v;
+    }
+}
+/**
+ * Enrich a record's Link values with the target's human label ({id,label}), so a
+ * relation renders as its title (not a raw id) in BOTH the list cell and the
+ * detail — @hanzo/data's relation display reads `.label`, its input reads `.id`.
+ * `optionsByField` is the loaded picker options per Link field (value=id, label=title).
+ */
+function enrichLinks(record, dt, optionsByField) {
+    const out = { ...record };
+    for (const f of dt.fields ?? []) {
+        if (f.fieldtype !== 'Link')
+            continue;
+        const raw = out[f.fieldname];
+        if (typeof raw === 'string' && raw) {
+            const opt = (optionsByField[f.fieldname] ?? []).find((o) => o.value === raw);
+            out[f.fieldname] = { id: raw, label: opt?.label ?? raw };
+        }
+    }
+    return out;
+}
+/** The Link fields of a DocType (their options must be loaded for the picker). */
+function linkFields(dt) {
+    return (dt.fields ?? []).filter((f) => f.fieldtype === 'Link');
+}
+/** A blank create-form draft seeded with each field's declared default (Check → bool). */
+function newDraft(dt) {
+    const out = {};
+    for (const f of dt.fields ?? []) {
+        if (f.default === undefined || f.default === '')
+            continue;
+        out[f.fieldname] = f.fieldtype === 'Check' ? f.default === '1' || f.default === 'true' : f.default;
+    }
+    return out;
+}
+/**
+ * A draft record → the framework write body: editable field values only (the
+ * engine owns `name`/`docstatus`/timestamps), each coerced to its wire shape, and
+ * the autoname source (e.g. `slug`) slugified so the document name is always URL-
+ * safe. Fields left `undefined` are dropped — a partial edit never nulls a value.
+ */
+function savePayload(draft, dt) {
+    const src = autonameSource(dt);
+    const out = {};
+    for (const f of dt.fields ?? []) {
+        if (f.readOnly)
+            continue; // engine-owned; never written back
+        let v = draft[f.fieldname];
+        if (v === undefined)
+            continue;
+        v = coerceForWrite(f, v);
+        if (f.fieldname === src && typeof v === 'string')
+            v = slugify(v);
+        out[f.fieldname] = v;
+    }
+    return out;
+}

package/dist/framework/fields.d.ts

@@ -10,7 +10,7 @@
  * imports are `import type`, erased at build, so the unit test runs in plain Node).
  */
 import type { FieldDefinition, SelectOption } from '@hanzo/data';
-import type { DocField, DocType, FrameworkDoc } from './types';
+import type { DocField, DocType, FrameworkDoc } from './types.js';
 /** `first_name` / `firstName` → "First Name"; known acronyms upper-cased. */
 export declare function humanize(name: string): string;
 /** The autoname source field for a `field:xxx` rule (`""` otherwise). */
@@ -116,3 +116,4 @@ export declare function newDraft(dt: DocType): Record<string, unknown>;
  * safe. Fields left `undefined` are dropped — a partial edit never nulls a value.
  */
 export declare function savePayload(draft: Record<string, unknown>, dt: DocType): Record<string, unknown>;
+//# sourceMappingURL=fields.d.ts.map

package/dist/framework/fields.d.ts.map

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