@hanzo/ui 8.0.26 → 8.0.28

package/dist/framework/RecordCards.cjs

@@ -0,0 +1,47 @@
+'use client';"use strict";
+'use client';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecordCards = RecordCards;
+const jsx_runtime_1 = require("react/jsx-runtime");
+/**
+ * RecordCards — the PHONE view of a DocType's documents: one stacked card per
+ * record instead of a horizontally-scrolling grid.
+ *
+ * A 12-column ERP Sales Order in a table on a 390px screen is a wall you drag
+ * sideways to read one row; the same record as a card is a title plus its declared
+ * list columns as label → value pairs, reading top to bottom in the width you
+ * have. Nothing is hidden that the table would have shown — the card renders the
+ * DocType's OWN `inListView` projection (`cardFields`), and the full record is one
+ * tap away.
+ *
+ * The whole card is the tap target (far past the 44px floor), values render
+ * through the SAME `FieldDisplay` router the table uses, so every field type
+ * behaves identically in both, and search is the pure `searchRecords` — no second
+ * filtering model.
+ */
+const react_1 = require("react");
+const gui_1 = require("@hanzo/gui");
+const lucide_icons_2_1 = require("@hanzogui/lucide-icons-2");
+const data_1 = require("@hanzo/data");
+const parts_1 = require("./parts.cjs");
+/** The headline for a card: the title field, else the record key. */
+function headline(record, titleField) {
+    const t = titleField ? record[titleField] : undefined;
+    if (typeof t === 'string' && t.trim())
+        return t;
+    if (typeof t === 'number')
+        return String(t);
+    const name = record.name ?? record.id;
+    return typeof name === 'string' && name ? name : 'Untitled';
+}
+function RecordCards({ titleField, fields, cardFields, records, loading, empty, onOpen, onCreate, createLabel = 'New record', toolbarExtra, }) {
+    const [query, setQuery] = (0, react_1.useState)('');
+    const visible = (0, react_1.useMemo)(() => (0, data_1.searchRecords)(records, query, fields), [records, query, fields]);
+    return ((0, jsx_runtime_1.jsxs)(gui_1.YStack, { testID: "doctype-cards", gap: "$3", width: "100%", children: [(0, jsx_runtime_1.jsxs)(gui_1.YStack, { gap: "$2", width: "100%", children: [(0, jsx_runtime_1.jsxs)(gui_1.XStack, { items: "center", gap: "$2", px: "$3", minH: 44, rounded: "$3", borderWidth: 1, borderColor: "$borderColor", width: "100%", children: [(0, jsx_runtime_1.jsx)(lucide_icons_2_1.Search, { size: 15, opacity: 0.6 }), (0, jsx_runtime_1.jsx)(gui_1.Input, { unstyled: true, flex: 1, minW: 0, height: 42, fontSize: "$3", color: "$color12", placeholder: "Search", value: query, onChangeText: setQuery, autoCapitalize: "none" })] }), (0, jsx_runtime_1.jsxs)(gui_1.XStack, { gap: "$2", items: "center", flexWrap: "wrap", width: "100%", children: [onCreate ? ((0, jsx_runtime_1.jsx)(parts_1.Action, { phone: true, primary: true, onPress: onCreate, children: createLabel })) : null, toolbarExtra] })] }), loading ? (0, jsx_runtime_1.jsx)(parts_1.Loading, { label: "Loading records\u2026" }) : null, !loading && visible.length === 0 ? ((0, jsx_runtime_1.jsx)(gui_1.Card, { borderWidth: 1, borderColor: "$borderColor", p: "$4", width: "100%", children: (0, jsx_runtime_1.jsx)(gui_1.Text, { fontSize: "$3", color: "$color10", children: query ? `No records match “${query}”.` : empty ?? 'No records yet.' }) })) : null, (0, jsx_runtime_1.jsx)(gui_1.YStack, { gap: "$2", width: "100%", children: visible.map((rec, i) => {
+                    const key = String(rec.name ?? rec.id ?? i);
+                    return ((0, jsx_runtime_1.jsx)(gui_1.Card, { borderWidth: 1, borderColor: "$borderColor", rounded: "$3", p: "$3", width: "100%", cursor: onOpen ? 'pointer' : undefined, pressStyle: onOpen ? { bg: '$color3' } : undefined, hoverStyle: onOpen ? { borderColor: '$color8' } : undefined, onPress: onOpen ? () => onOpen(rec) : undefined, style: parts_1.WRAP_ANYWHERE, children: (0, jsx_runtime_1.jsxs)(gui_1.YStack, { gap: "$2", width: "100%", children: [(0, jsx_runtime_1.jsxs)(gui_1.XStack, { items: "center", gap: "$2", width: "100%", children: [(0, jsx_runtime_1.jsx)(gui_1.Text, { fontSize: "$4", fontWeight: "700", flex: 1, minW: 0, numberOfLines: 2, children: headline(rec, titleField) }), onOpen ? (0, jsx_runtime_1.jsx)(lucide_icons_2_1.ChevronRight, { size: 16, opacity: 0.5 }) : null] }), cardFields.map((f) => (
+                                // Label above value: a two-column row forces the value into a
+                                // sliver at 390px. Stacked, every field type gets the full width.
+                                (0, jsx_runtime_1.jsxs)(gui_1.YStack, { gap: "$0.5", width: "100%", children: [(0, jsx_runtime_1.jsx)(gui_1.Text, { fontSize: "$1", color: "$color10", textTransform: "uppercase", letterSpacing: 0.4, children: f.label }), (0, jsx_runtime_1.jsx)(gui_1.XStack, { width: "100%", flexWrap: "wrap", children: (0, jsx_runtime_1.jsx)(data_1.FieldDisplay, { field: f, value: rec[f.name] }) })] }, f.name)))] }) }, key));
+                }) }), visible.length ? ((0, jsx_runtime_1.jsxs)(parts_1.Meta, { children: [visible.length, " of ", records.length, " record", records.length === 1 ? '' : 's'] })) : null] }));
+}

package/dist/framework/RecordCards.d.ts

@@ -33,3 +33,4 @@ export interface RecordCardsProps {
     toolbarExtra?: ReactNode;
 }
 export declare function RecordCards({ titleField, fields, cardFields, records, loading, empty, onOpen, onCreate, createLabel, toolbarExtra, }: RecordCardsProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=RecordCards.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RecordCards.d.ts","sourceRoot":"","sources":["../../src/framework/RecordCards.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAGzD,OAAO,EAA+B,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AAI/E,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,4EAA4E;IAC5E,MAAM,EAAE,eAAe,EAAE,CAAA;IACzB,8DAA8D;IAC9D,UAAU,EAAE,eAAe,EAAE,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;IAClC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IAClD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,SAAS,CAAA;CACzB;AAWD,wBAAgB,WAAW,CAAC,EAC1B,UAAU,EACV,MAAM,EACN,UAAU,EACV,OAAO,EACP,OAAO,EACP,KAAK,EACL,MAAM,EACN,QAAQ,EACR,WAA0B,EAC1B,YAAY,GACb,EAAE,gBAAgB,2CAuGlB"}

package/dist/framework/RecordCards.js

@@ -0,0 +1,45 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * RecordCards — the PHONE view of a DocType's documents: one stacked card per
+ * record instead of a horizontally-scrolling grid.
+ *
+ * A 12-column ERP Sales Order in a table on a 390px screen is a wall you drag
+ * sideways to read one row; the same record as a card is a title plus its declared
+ * list columns as label → value pairs, reading top to bottom in the width you
+ * have. Nothing is hidden that the table would have shown — the card renders the
+ * DocType's OWN `inListView` projection (`cardFields`), and the full record is one
+ * tap away.
+ *
+ * The whole card is the tap target (far past the 44px floor), values render
+ * through the SAME `FieldDisplay` router the table uses, so every field type
+ * behaves identically in both, and search is the pure `searchRecords` — no second
+ * filtering model.
+ */
+import { useMemo, useState } from 'react';
+import { Card, Input, Text, XStack, YStack } from '@hanzo/gui';
+import { ChevronRight, Search } from '@hanzogui/lucide-icons-2';
+import { FieldDisplay, searchRecords } from '@hanzo/data';
+import { Action, Loading, Meta, WRAP_ANYWHERE } from './parts.js';
+/** The headline for a card: the title field, else the record key. */
+function headline(record, titleField) {
+    const t = titleField ? record[titleField] : undefined;
+    if (typeof t === 'string' && t.trim())
+        return t;
+    if (typeof t === 'number')
+        return String(t);
+    const name = record.name ?? record.id;
+    return typeof name === 'string' && name ? name : 'Untitled';
+}
+export function RecordCards({ titleField, fields, cardFields, records, loading, empty, onOpen, onCreate, createLabel = 'New record', toolbarExtra, }) {
+    const [query, setQuery] = useState('');
+    const visible = useMemo(() => searchRecords(records, query, fields), [records, query, fields]);
+    return (_jsxs(YStack, { testID: "doctype-cards", gap: "$3", width: "100%", children: [_jsxs(YStack, { gap: "$2", width: "100%", children: [_jsxs(XStack, { items: "center", gap: "$2", px: "$3", minH: 44, rounded: "$3", borderWidth: 1, borderColor: "$borderColor", width: "100%", children: [_jsx(Search, { size: 15, opacity: 0.6 }), _jsx(Input, { unstyled: true, flex: 1, minW: 0, height: 42, fontSize: "$3", color: "$color12", placeholder: "Search", value: query, onChangeText: setQuery, autoCapitalize: "none" })] }), _jsxs(XStack, { gap: "$2", items: "center", flexWrap: "wrap", width: "100%", children: [onCreate ? (_jsx(Action, { phone: true, primary: true, onPress: onCreate, children: createLabel })) : null, toolbarExtra] })] }), loading ? _jsx(Loading, { label: "Loading records\u2026" }) : null, !loading && visible.length === 0 ? (_jsx(Card, { borderWidth: 1, borderColor: "$borderColor", p: "$4", width: "100%", children: _jsx(Text, { fontSize: "$3", color: "$color10", children: query ? `No records match “${query}”.` : empty ?? 'No records yet.' }) })) : null, _jsx(YStack, { gap: "$2", width: "100%", children: visible.map((rec, i) => {
+                    const key = String(rec.name ?? rec.id ?? i);
+                    return (_jsx(Card, { borderWidth: 1, borderColor: "$borderColor", rounded: "$3", p: "$3", width: "100%", cursor: onOpen ? 'pointer' : undefined, pressStyle: onOpen ? { bg: '$color3' } : undefined, hoverStyle: onOpen ? { borderColor: '$color8' } : undefined, onPress: onOpen ? () => onOpen(rec) : undefined, style: WRAP_ANYWHERE, children: _jsxs(YStack, { gap: "$2", width: "100%", children: [_jsxs(XStack, { items: "center", gap: "$2", width: "100%", children: [_jsx(Text, { fontSize: "$4", fontWeight: "700", flex: 1, minW: 0, numberOfLines: 2, children: headline(rec, titleField) }), onOpen ? _jsx(ChevronRight, { size: 16, opacity: 0.5 }) : null] }), cardFields.map((f) => (
+                                // Label above value: a two-column row forces the value into a
+                                // sliver at 390px. Stacked, every field type gets the full width.
+                                _jsxs(YStack, { gap: "$0.5", width: "100%", children: [_jsx(Text, { fontSize: "$1", color: "$color10", textTransform: "uppercase", letterSpacing: 0.4, children: f.label }), _jsx(XStack, { width: "100%", flexWrap: "wrap", children: _jsx(FieldDisplay, { field: f, value: rec[f.name] }) })] }, f.name)))] }) }, key));
+                }) }), visible.length ? (_jsxs(Meta, { children: [visible.length, " of ", records.length, " record", records.length === 1 ? '' : 's'] })) : null] }));
+}
+//# sourceMappingURL=RecordCards.js.map

package/dist/framework/RecordCards.js.map

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

package/dist/framework/builder-logic.cjs

@@ -0,0 +1,169 @@
+'use client';"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BUILDER_FIELD_TYPES = void 0;
+exports.fieldTypeLabel = fieldTypeLabel;
+exports.fieldNeedsOptions = fieldNeedsOptions;
+exports.newKey = newKey;
+exports.blankField = blankField;
+exports.starterFields = starterFields;
+exports.fieldsFromDocType = fieldsFromDocType;
+exports.fieldNameFromLabel = fieldNameFromLabel;
+exports.validateBuilder = validateBuilder;
+exports.toDocField = toDocField;
+exports.moveField = moveField;
+exports.toDocType = toDocType;
+const fields_1 = require("./fields.cjs");
+/**
+ * The builder's field-type vocabulary — every framework fieldtype, with a friendly
+ * label + hint. This is the ONE list the "add field" type picker renders, so the
+ * builder always offers exactly what the engine accepts (no drift). Order is the
+ * author-facing order (common types first).
+ */
+exports.BUILDER_FIELD_TYPES = [
+    { type: 'Data', label: 'Text', hint: 'Single line of text' },
+    { type: 'RichText', label: 'Rich text', hint: 'Formatted body (WYSIWYG)' },
+    { type: 'LongText', label: 'Long text', hint: 'Multi-line plain text' },
+    { type: 'Int', label: 'Number', hint: 'Whole number' },
+    { type: 'Float', label: 'Decimal', hint: 'Decimal number' },
+    { type: 'Currency', label: 'Currency', hint: 'Money amount' },
+    { type: 'Check', label: 'Checkbox', hint: 'True / false' },
+    { type: 'Date', label: 'Date', hint: 'Calendar date' },
+    { type: 'Datetime', label: 'Date & time', hint: 'Date with time' },
+    { type: 'Select', label: 'Select', hint: 'One of a list of options' },
+    { type: 'Link', label: 'Relation', hint: 'Reference another collection' },
+    { type: 'Attach', label: 'Attachment', hint: 'A file / image URL' },
+    { type: 'Table', label: 'Table', hint: 'Repeatable child rows (JSON)' },
+    { type: 'JSON', label: 'JSON', hint: 'Arbitrary JSON' },
+];
+const LABELS = Object.fromEntries(exports.BUILDER_FIELD_TYPES.map((t) => [t.type, t.label]));
+/** The friendly label for a fieldtype (falls back to the raw type). */
+function fieldTypeLabel(t) {
+    return LABELS[t] ?? t;
+}
+/** True when a fieldtype needs `options` (Select choices, Link/Table target). */
+function fieldNeedsOptions(t) {
+    return t === 'Select' || t === 'Link' || t === 'Table';
+}
+let seq = 0;
+/** A fresh, unique client key. */
+function newKey() {
+    seq += 1;
+    return `f${seq}_${Math.random().toString(36).slice(2, 8)}`;
+}
+/** A blank field row of a given type. */
+function blankField(type = 'Data') {
+    return { key: newKey(), label: '', type, required: false, inListView: false, options: '' };
+}
+/**
+ * The default starter fields for a NEW content collection: a required Title, a URL
+ * Slug (the autoname key), a rich Body, and a Draft/Published Status. The author
+ * edits from here. Mirrors the cloud CMS seed so a hand-built collection matches a
+ * seeded one.
+ */
+function starterFields() {
+    return [
+        { key: newKey(), label: 'Title', type: 'Data', required: true, inListView: true, options: '' },
+        { key: newKey(), label: 'Slug', type: 'Data', required: true, inListView: true, options: '' },
+        { key: newKey(), label: 'Body', type: 'RichText', required: false, inListView: false, options: '' },
+        { key: newKey(), label: 'Status', type: 'Select', required: false, inListView: true, options: 'Draft\nPublished' },
+        // Optional project scope — lets a host's org→project switcher filter this collection.
+        { key: newKey(), label: 'Project', type: 'Data', required: false, inListView: false, options: '' },
+    ];
+}
+/** An existing DocType → editable builder rows (drops engine-managed fields). */
+function fieldsFromDocType(dt) {
+    return (dt.fields ?? []).map((f) => ({
+        key: newKey(),
+        label: f.label || f.fieldname,
+        type: f.fieldtype,
+        required: Boolean(f.reqd),
+        inListView: Boolean(f.inListView),
+        options: f.options ?? '',
+    }));
+}
+/** The fieldname derived from a label (slug with underscores; identifier-safe). */
+function fieldNameFromLabel(label) {
+    const slug = (0, fields_1.slugify)(label).replace(/-/g, '_');
+    // A leading digit isn't a valid identifier lead; prefix it.
+    return /^[0-9]/.test(slug) ? `f_${slug}` : slug;
+}
+/**
+ * Validate the whole builder: the collection name, at least one field, unique
+ * non-empty field labels/names, and options present where required. Pure.
+ */
+function validateBuilder(name, fields) {
+    const fieldErrors = {};
+    let formError = null;
+    if (!(0, fields_1.isValidDoctypeName)(name.trim())) {
+        formError = 'Enter a collection name with letters, digits, dashes or underscores (no spaces).';
+    }
+    else if (fields.length === 0) {
+        formError = 'Add at least one field.';
+    }
+    const seen = new Set();
+    for (const f of fields) {
+        const label = f.label.trim();
+        if (!label) {
+            fieldErrors[f.key] = 'Name this field.';
+            continue;
+        }
+        const fname = fieldNameFromLabel(label);
+        if (!fname) {
+            fieldErrors[f.key] = 'Use letters or digits in the field name.';
+            continue;
+        }
+        if (seen.has(fname)) {
+            fieldErrors[f.key] = `Duplicate field "${fname}".`;
+            continue;
+        }
+        seen.add(fname);
+        if ((f.type === 'Link' || f.type === 'Table') && !f.options.trim()) {
+            fieldErrors[f.key] = f.type === 'Link' ? 'Choose the collection to relate to.' : 'Name the child collection.';
+        }
+        else if (f.type === 'Select' && !f.options.trim()) {
+            fieldErrors[f.key] = 'Add at least one option.';
+        }
+    }
+    return { ok: !formError && Object.keys(fieldErrors).length === 0, fieldErrors, formError };
+}
+/** A builder row → a framework DocField (drops UI-only bits, coerces options). */
+function toDocField(f) {
+    const fieldname = fieldNameFromLabel(f.label);
+    const field = {
+        fieldname,
+        fieldtype: f.type,
+        label: f.label.trim(),
+    };
+    if (f.required)
+        field.reqd = true;
+    if (f.inListView)
+        field.inListView = true;
+    if (fieldNeedsOptions(f.type) && f.options.trim())
+        field.options = f.options.trim();
+    return field;
+}
+/** Move a row within the ordered field list (a no-op at either end). Pure. */
+function moveField(fields, key, dir) {
+    const i = fields.findIndex((f) => f.key === key);
+    const j = i + dir;
+    if (i < 0 || j < 0 || j >= fields.length)
+        return fields;
+    const next = [...fields];
+    [next[i], next[j]] = [next[j], next[i]];
+    return next;
+}
+/**
+ * The builder → a `DocType` create body. Auto-derives `autoname`/`titleField` from
+ * conventional fields when present (a `slug` field → `field:slug` naming; a `title`
+ * field → the title). Tags the module so the collection joins the lane.
+ */
+function toDocType(name, module, fields) {
+    const docFields = fields.map(toDocField);
+    const byName = new Set(docFields.map((f) => f.fieldname));
+    const dt = { name: name.trim(), module, fields: docFields };
+    if (byName.has('slug'))
+        dt.autoname = 'field:slug';
+    if (byName.has('title'))
+        dt.titleField = 'title';
+    return dt;
+}

package/dist/framework/builder-logic.d.ts

@@ -9,7 +9,7 @@
  * projects the whole thing to a valid `DocType` create body. Names are slugified
  * to field-name rules so a save never 400s on a bad identifier.
  */
-import type { DocType, DocField, Fieldtype } from './types';
+import type { DocType, DocField, Fieldtype } from './types.js';
 /**
  * The builder's field-type vocabulary — every framework fieldtype, with a friendly
  * label + hint. This is the ONE list the "add field" type picker renders, so the
@@ -74,3 +74,4 @@ export declare function moveField(fields: BuilderField[], key: string, dir: -1 |
  * field → the title). Tags the module so the collection joins the lane.
  */
 export declare function toDocType(name: string, module: string, fields: BuilderField[]): DocType;
+//# sourceMappingURL=builder-logic.d.ts.map

package/dist/framework/builder-logic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder-logic.d.ts","sourceRoot":"","sources":["../../src/framework/builder-logic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAG3D;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAejF,CAAA;AAMD,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAEnD;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,SAAS,GAAG,OAAO,CAEvD;AAED,+EAA+E;AAC/E,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAA;IACX,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,SAAS,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;IACjB,UAAU,EAAE,OAAO,CAAA;IACnB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAA;CAChB;AAGD,kCAAkC;AAClC,wBAAgB,MAAM,IAAI,MAAM,CAG/B;AAED,yCAAyC;AACzC,wBAAgB,UAAU,CAAC,IAAI,GAAE,SAAkB,GAAG,YAAY,CAEjE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,YAAY,EAAE,CAS9C;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,OAAO,GAAG,YAAY,EAAE,CAS7D;AAED,mFAAmF;AACnF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAA;IACX,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,6CAA6C;IAC7C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,iBAAiB,CAmCvF;AAED,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,CAAC,EAAE,YAAY,GAAG,QAAQ,CAWpD;AAED,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,YAAY,EAAE,CAO1F;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAOvF"}

package/dist/framework/builder-logic.js

@@ -0,0 +1,156 @@
+'use client';import { slugify, isValidDoctypeName } from './fields.js';
+/**
+ * The builder's field-type vocabulary — every framework fieldtype, with a friendly
+ * label + hint. This is the ONE list the "add field" type picker renders, so the
+ * builder always offers exactly what the engine accepts (no drift). Order is the
+ * author-facing order (common types first).
+ */
+export const BUILDER_FIELD_TYPES = [
+    { type: 'Data', label: 'Text', hint: 'Single line of text' },
+    { type: 'RichText', label: 'Rich text', hint: 'Formatted body (WYSIWYG)' },
+    { type: 'LongText', label: 'Long text', hint: 'Multi-line plain text' },
+    { type: 'Int', label: 'Number', hint: 'Whole number' },
+    { type: 'Float', label: 'Decimal', hint: 'Decimal number' },
+    { type: 'Currency', label: 'Currency', hint: 'Money amount' },
+    { type: 'Check', label: 'Checkbox', hint: 'True / false' },
+    { type: 'Date', label: 'Date', hint: 'Calendar date' },
+    { type: 'Datetime', label: 'Date & time', hint: 'Date with time' },
+    { type: 'Select', label: 'Select', hint: 'One of a list of options' },
+    { type: 'Link', label: 'Relation', hint: 'Reference another collection' },
+    { type: 'Attach', label: 'Attachment', hint: 'A file / image URL' },
+    { type: 'Table', label: 'Table', hint: 'Repeatable child rows (JSON)' },
+    { type: 'JSON', label: 'JSON', hint: 'Arbitrary JSON' },
+];
+const LABELS = Object.fromEntries(BUILDER_FIELD_TYPES.map((t) => [t.type, t.label]));
+/** The friendly label for a fieldtype (falls back to the raw type). */
+export function fieldTypeLabel(t) {
+    return LABELS[t] ?? t;
+}
+/** True when a fieldtype needs `options` (Select choices, Link/Table target). */
+export function fieldNeedsOptions(t) {
+    return t === 'Select' || t === 'Link' || t === 'Table';
+}
+let seq = 0;
+/** A fresh, unique client key. */
+export function newKey() {
+    seq += 1;
+    return `f${seq}_${Math.random().toString(36).slice(2, 8)}`;
+}
+/** A blank field row of a given type. */
+export function blankField(type = 'Data') {
+    return { key: newKey(), label: '', type, required: false, inListView: false, options: '' };
+}
+/**
+ * The default starter fields for a NEW content collection: a required Title, a URL
+ * Slug (the autoname key), a rich Body, and a Draft/Published Status. The author
+ * edits from here. Mirrors the cloud CMS seed so a hand-built collection matches a
+ * seeded one.
+ */
+export function starterFields() {
+    return [
+        { key: newKey(), label: 'Title', type: 'Data', required: true, inListView: true, options: '' },
+        { key: newKey(), label: 'Slug', type: 'Data', required: true, inListView: true, options: '' },
+        { key: newKey(), label: 'Body', type: 'RichText', required: false, inListView: false, options: '' },
+        { key: newKey(), label: 'Status', type: 'Select', required: false, inListView: true, options: 'Draft\nPublished' },
+        // Optional project scope — lets a host's org→project switcher filter this collection.
+        { key: newKey(), label: 'Project', type: 'Data', required: false, inListView: false, options: '' },
+    ];
+}
+/** An existing DocType → editable builder rows (drops engine-managed fields). */
+export function fieldsFromDocType(dt) {
+    return (dt.fields ?? []).map((f) => ({
+        key: newKey(),
+        label: f.label || f.fieldname,
+        type: f.fieldtype,
+        required: Boolean(f.reqd),
+        inListView: Boolean(f.inListView),
+        options: f.options ?? '',
+    }));
+}
+/** The fieldname derived from a label (slug with underscores; identifier-safe). */
+export function fieldNameFromLabel(label) {
+    const slug = slugify(label).replace(/-/g, '_');
+    // A leading digit isn't a valid identifier lead; prefix it.
+    return /^[0-9]/.test(slug) ? `f_${slug}` : slug;
+}
+/**
+ * Validate the whole builder: the collection name, at least one field, unique
+ * non-empty field labels/names, and options present where required. Pure.
+ */
+export function validateBuilder(name, fields) {
+    const fieldErrors = {};
+    let formError = null;
+    if (!isValidDoctypeName(name.trim())) {
+        formError = 'Enter a collection name with letters, digits, dashes or underscores (no spaces).';
+    }
+    else if (fields.length === 0) {
+        formError = 'Add at least one field.';
+    }
+    const seen = new Set();
+    for (const f of fields) {
+        const label = f.label.trim();
+        if (!label) {
+            fieldErrors[f.key] = 'Name this field.';
+            continue;
+        }
+        const fname = fieldNameFromLabel(label);
+        if (!fname) {
+            fieldErrors[f.key] = 'Use letters or digits in the field name.';
+            continue;
+        }
+        if (seen.has(fname)) {
+            fieldErrors[f.key] = `Duplicate field "${fname}".`;
+            continue;
+        }
+        seen.add(fname);
+        if ((f.type === 'Link' || f.type === 'Table') && !f.options.trim()) {
+            fieldErrors[f.key] = f.type === 'Link' ? 'Choose the collection to relate to.' : 'Name the child collection.';
+        }
+        else if (f.type === 'Select' && !f.options.trim()) {
+            fieldErrors[f.key] = 'Add at least one option.';
+        }
+    }
+    return { ok: !formError && Object.keys(fieldErrors).length === 0, fieldErrors, formError };
+}
+/** A builder row → a framework DocField (drops UI-only bits, coerces options). */
+export function toDocField(f) {
+    const fieldname = fieldNameFromLabel(f.label);
+    const field = {
+        fieldname,
+        fieldtype: f.type,
+        label: f.label.trim(),
+    };
+    if (f.required)
+        field.reqd = true;
+    if (f.inListView)
+        field.inListView = true;
+    if (fieldNeedsOptions(f.type) && f.options.trim())
+        field.options = f.options.trim();
+    return field;
+}
+/** Move a row within the ordered field list (a no-op at either end). Pure. */
+export function moveField(fields, key, dir) {
+    const i = fields.findIndex((f) => f.key === key);
+    const j = i + dir;
+    if (i < 0 || j < 0 || j >= fields.length)
+        return fields;
+    const next = [...fields];
+    [next[i], next[j]] = [next[j], next[i]];
+    return next;
+}
+/**
+ * The builder → a `DocType` create body. Auto-derives `autoname`/`titleField` from
+ * conventional fields when present (a `slug` field → `field:slug` naming; a `title`
+ * field → the title). Tags the module so the collection joins the lane.
+ */
+export function toDocType(name, module, fields) {
+    const docFields = fields.map(toDocField);
+    const byName = new Set(docFields.map((f) => f.fieldname));
+    const dt = { name: name.trim(), module, fields: docFields };
+    if (byName.has('slug'))
+        dt.autoname = 'field:slug';
+    if (byName.has('title'))
+        dt.titleField = 'title';
+    return dt;
+}
+//# sourceMappingURL=builder-logic.js.map

package/dist/framework/builder-logic.js.map

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

package/dist/framework/client.cjs

@@ -0,0 +1,95 @@
+'use client';"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rows = rows;
+exports.listQuery = listQuery;
+exports.createFrameworkClient = createFrameworkClient;
+const enc = encodeURIComponent;
+const asRecord = (v) => v && typeof v === 'object' && !Array.isArray(v) ? v : {};
+/** Pull the first array under a common envelope key (the engine uses `data`). */
+function rows(payload) {
+    if (Array.isArray(payload)) {
+        return payload.filter((x) => x && typeof x === 'object');
+    }
+    const o = asRecord(payload);
+    for (const k of ['data', 'items', 'rows']) {
+        if (Array.isArray(o[k])) {
+            return o[k].filter((x) => x && typeof x === 'object');
+        }
+    }
+    return [];
+}
+/** A framework document is already a flat map + envelope; keep it as-is (typed). */
+const asDoc = (v) => asRecord(v);
+const asDocType = (v) => {
+    const r = asRecord(v);
+    return {
+        ...r,
+        name: String(r.name ?? ''),
+        fields: Array.isArray(r.fields) ? r.fields : [],
+    };
+};
+/** Build the generic document list querystring from a typed ListQuery. Pure. */
+function listQuery(q) {
+    if (!q)
+        return '';
+    const p = new URLSearchParams();
+    if (q.filters && Object.keys(q.filters).length)
+        p.set('filters', JSON.stringify(q.filters));
+    if (q.fields && q.fields.length)
+        p.set('fields', q.fields.join(','));
+    if (q.orderBy)
+        p.set('order_by', q.orderBy);
+    if (q.limit)
+        p.set('limit', String(q.limit));
+    const s = p.toString();
+    return s ? `?${s}` : '';
+}
+/** Bind the framework surface to a host's transport. */
+function createFrameworkClient(t) {
+    return {
+        doctypes: {
+            list: () => t.get('doctypes').then((r) => rows(r).map(asDocType)),
+            get: (name) => t.get(`doctypes/${enc(name)}`).then(asDocType),
+            create: (dt) => t.post('doctypes', dt).then(asDocType),
+            update: (name, dt) => t.put(`doctypes/${enc(name)}`, dt).then(asDocType),
+            remove: (name) => t.del(`doctypes/${enc(name)}`),
+        },
+        records: {
+            list: (doctype, q) => t.get(`${enc(doctype)}${listQuery(q)}`).then((r) => rows(r).map(asDoc)),
+            get: (doctype, name) => t.get(`${enc(doctype)}/${enc(name)}`).then(asDoc),
+            create: (doctype, data) => t.post(enc(doctype), data).then(asDoc),
+            update: (doctype, name, data) => t.put(`${enc(doctype)}/${enc(name)}`, data).then(asDoc),
+            remove: (doctype, name) => t.del(`${enc(doctype)}/${enc(name)}`),
+            submit: (doctype, name) => t.post(`${enc(doctype)}/${enc(name)}/submit`).then(asDoc),
+            cancel: (doctype, name) => t.post(`${enc(doctype)}/${enc(name)}/cancel`).then(asDoc),
+        },
+        modules: {
+            list: () => t.get('modules').then((r) => rows(r).map((m) => ({
+                module: String(m.module ?? ''),
+                doctypes: Array.isArray(m.doctypes) ? m.doctypes : [],
+            }))),
+            get: (module) => t.get(`modules/${enc(module)}`).then((v) => {
+                const r = asRecord(v);
+                return {
+                    module: String(r.module ?? module),
+                    doctypes: Array.isArray(r.doctypes) ? r.doctypes : [],
+                    installed: Array.isArray(r.installed) ? r.installed : [],
+                };
+            }),
+            install: (module) => t.post(`modules/${enc(module)}/install`).then((v) => {
+                const r = asRecord(v);
+                return {
+                    module: String(r.module ?? module),
+                    created: Array.isArray(r.created) ? r.created : [],
+                    existing: Array.isArray(r.existing) ? r.existing : [],
+                };
+            }),
+        },
+        roles: {
+            list: () => t.get('roles').then((r) => rows(r).map((x) => ({ user: String(x.user ?? ''), role: String(x.role ?? '') }))),
+            assign: (user, role) => t.post('roles', { user, role }).then(() => undefined),
+            revoke: (user, role) => t.del(`roles/${enc(user)}/${enc(role)}`),
+        },
+        summary: () => t.get('summary').then(asRecord),
+    };
+}

package/dist/framework/client.d.ts

@@ -15,7 +15,7 @@
  * Payloads are read defensively from `{ data }` (or a bare array), so a shape drift
  * degrades a list rather than throwing.
  */
-import type { DocType, FrameworkDoc, InstallResult, ListQuery, ModuleInfo } from './types';
+import type { DocType, FrameworkDoc, InstallResult, ListQuery, ModuleInfo } from './types.js';
 /**
  * The ONE seam a host injects. Paths are relative to the framework root and never
  * start with a slash; the host prefixes its own base (and adds credentials).
@@ -72,3 +72,4 @@ export interface FrameworkClient {
 }
 /** Bind the framework surface to a host's transport. */
 export declare function createFrameworkClient(t: FrameworkTransport): FrameworkClient;
+//# sourceMappingURL=client.d.ts.map

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

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