@hanzo/ui 8.0.24 → 8.0.25

package/dist/framework/core.cjs

@@ -0,0 +1,213 @@
+'use client';
+'use strict';
+
+var chunk3NG33DV2_cjs = require('../chunk-3NG33DV2.cjs');
+
+
+
+Object.defineProperty(exports, "BUILDER_FIELD_TYPES", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.BUILDER_FIELD_TYPES; }
+});
+Object.defineProperty(exports, "CANCELLED", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.CANCELLED; }
+});
+Object.defineProperty(exports, "DRAFT", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.DRAFT; }
+});
+Object.defineProperty(exports, "PROJECT_FIELD", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.PROJECT_FIELD; }
+});
+Object.defineProperty(exports, "REDACTED_MARKER", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.REDACTED_MARKER; }
+});
+Object.defineProperty(exports, "SUBMITTED", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.SUBMITTED; }
+});
+Object.defineProperty(exports, "autonameSource", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.autonameSource; }
+});
+Object.defineProperty(exports, "blankField", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.blankField; }
+});
+Object.defineProperty(exports, "cardFields", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.cardFields; }
+});
+Object.defineProperty(exports, "createFrameworkClient", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.createFrameworkClient; }
+});
+Object.defineProperty(exports, "createMediaUploader", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.createMediaUploader; }
+});
+Object.defineProperty(exports, "docTypeToFields", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.docTypeToFields; }
+});
+Object.defineProperty(exports, "enrichLinks", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.enrichLinks; }
+});
+Object.defineProperty(exports, "fieldNameFromLabel", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.fieldNameFromLabel; }
+});
+Object.defineProperty(exports, "fieldNeedsOptions", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.fieldNeedsOptions; }
+});
+Object.defineProperty(exports, "fieldTypeLabel", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.fieldTypeLabel; }
+});
+Object.defineProperty(exports, "fieldsFromDocType", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.fieldsFromDocType; }
+});
+Object.defineProperty(exports, "hasProjectField", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.hasProjectField; }
+});
+Object.defineProperty(exports, "humanize", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.humanize; }
+});
+Object.defineProperty(exports, "imageDimensions", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.imageDimensions; }
+});
+Object.defineProperty(exports, "isDraft", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.isDraft; }
+});
+Object.defineProperty(exports, "isMediaDoctype", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.isMediaDoctype; }
+});
+Object.defineProperty(exports, "isRef", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.isRef; }
+});
+Object.defineProperty(exports, "isValidDoctypeName", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.isValidDoctypeName; }
+});
+Object.defineProperty(exports, "joinKey", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.joinKey; }
+});
+Object.defineProperty(exports, "linkFields", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.linkFields; }
+});
+Object.defineProperty(exports, "listHiddenFields", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.listHiddenFields; }
+});
+Object.defineProperty(exports, "listQuery", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.listQuery; }
+});
+Object.defineProperty(exports, "listedFieldNames", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.listedFieldNames; }
+});
+Object.defineProperty(exports, "loadLinkOptions", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.loadLinkOptions; }
+});
+Object.defineProperty(exports, "looksLikeImage", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.looksLikeImage; }
+});
+Object.defineProperty(exports, "makeFieldOptions", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.makeFieldOptions; }
+});
+Object.defineProperty(exports, "mediaDocPayload", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.mediaDocPayload; }
+});
+Object.defineProperty(exports, "mediaFileField", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.mediaFileField; }
+});
+Object.defineProperty(exports, "mediaKey", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.mediaKey; }
+});
+Object.defineProperty(exports, "mediaRef", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.mediaRef; }
+});
+Object.defineProperty(exports, "moduleDoctypes", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.moduleDoctypes; }
+});
+Object.defineProperty(exports, "moveField", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.moveField; }
+});
+Object.defineProperty(exports, "newDraft", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.newDraft; }
+});
+Object.defineProperty(exports, "newKey", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.newKey; }
+});
+Object.defineProperty(exports, "parseRef", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.parseRef; }
+});
+Object.defineProperty(exports, "rows", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.rows; }
+});
+Object.defineProperty(exports, "savePayload", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.savePayload; }
+});
+Object.defineProperty(exports, "slugify", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.slugify; }
+});
+Object.defineProperty(exports, "starterFields", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.starterFields; }
+});
+Object.defineProperty(exports, "statusField", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.statusField; }
+});
+Object.defineProperty(exports, "titleOf", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.titleOf; }
+});
+Object.defineProperty(exports, "toDocField", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.toDocField; }
+});
+Object.defineProperty(exports, "toDocType", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.toDocType; }
+});
+Object.defineProperty(exports, "toRecord", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.toRecord; }
+});
+Object.defineProperty(exports, "validateBuilder", {
+  enumerable: true,
+  get: function () { return chunk3NG33DV2_cjs.validateBuilder; }
+});
+//# sourceMappingURL=core.cjs.map
+//# sourceMappingURL=core.cjs.map

package/dist/framework/core.cjs.map

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

package/dist/framework/core.d.ts

@@ -0,0 +1,6 @@
+export * from './types';
+export * from './client';
+export * from './fields';
+export * from './builder-logic';
+export * from './media';
+export * from './data';

package/dist/framework/core.js

@@ -0,0 +1,4 @@
+'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
+//# sourceMappingURL=core.js.map

package/dist/framework/core.js.map

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

package/dist/framework/data.d.ts

@@ -2,8 +2,8 @@
  * Shared, non-React data helpers for the generic DocType renderer. A relation
  * (Link) field is a picker over the TARGET doctype's records, so before a view
  * can render or edit one it must load those records (+ the target's schema for
- * the human label). This is the ONE place that does it, used by both the records
- * list and the record detail — no per-view duplication.
+ * the human label). This is the ONE place that does it, used by the records list,
+ * the mobile card list and the record detail — no per-view duplication.
  */
 import type { SelectOption, FieldDefinition } from '@hanzo/data';
 import type { DocType } from './types';

package/dist/framework/fields.d.ts

@@ -2,8 +2,9 @@
  * Pure mapping between the Hanzo Framework DocType metadata and @hanzo/data's
  * render model — the brain of the generic DocType renderer. It is the ONE place
  * that translates the engine's Frappe field vocabulary into @hanzo/data's, so
- * EVERY app lane (CMS/ERP/CRM/Helpdesk) renders list/form/detail identically with
- * zero per-doctype code. A new DocType — or a whole new lane — "just works".
+ * EVERY app lane (CMS / ERP / CRM / Helpdesk) renders list, card, form and detail
+ * identically with zero per-doctype code. A new DocType — or a whole new lane —
+ * "just works".
  *
  * No I/O, no React — data in, data out, trivially testable (the @hanzo/data
  * imports are `import type`, erased at build, so the unit test runs in plain Node).
@@ -27,24 +28,66 @@ export interface FieldMapOpts {
 export declare function docTypeToFields(dt: DocType, opts?: FieldMapOpts): FieldDefinition[];
 /** The status field a publishable content type uses (a Select including "Published"). */
 export declare function statusField(dt: DocType): string;
-/** Fields shown as table columns: the `inListView` subset (all, if none flagged). */
+/**
+ * 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.
+ */
 export declare function listHiddenFields(dt: DocType): string[];
+/**
+ * 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.
+ */
+export declare function cardFields(dt: DocType, fields: FieldDefinition[], max?: number): FieldDefinition[];
+/** The `inListView` field names (empty when the DocType flags none). */
+export declare function listedFieldNames(dt: DocType): string[];
 /** True when a DocType is a media/asset library (a required Attach) → grid view. */
 export declare function isMediaDoctype(dt: DocType): boolean;
 /** The primary Attach field name (the asset URL) of a media doctype. */
 export declare function mediaFileField(dt: DocType): string;
+/** The uploaded-asset facts a media DocType may want stored alongside the file. */
+export interface MediaFacts {
+    /** The `file`-field value (an object reference or URL). */
+    fileRef: string;
+    filename: string;
+    mime: string;
+    size: number;
+    width: number;
+    height: number;
+}
+/**
+ * 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.
+ */
+export declare function mediaDocPayload(dt: DocType, facts: MediaFacts): Record<string, unknown>;
 /** DocTypes belonging to an app lane (module) — a CMS "collection" is one of these. */
 export declare function moduleDoctypes(dts: DocType[], module: string): DocType[];
 /** The conventional field a collection uses to scope documents to a project. */
 export declare const PROJECT_FIELD = "project";
 /** True when a DocType declares the `project` scope field (→ project filtering works). */
 export declare function hasProjectField(dt: DocType): boolean;
+/**
+ * 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.
+ */
+export declare function isDraft(record: Record<string, unknown> | null | undefined): boolean;
 /** A record's human title — the DocType's titleField, else its name. */
 export declare function titleOf(doc: Record<string, unknown>, dt: DocType): string;
 /**
  * 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 the console's own proxy path both require it).
+ * document name (the engine and a host's proxy path both require it).
  */
 export declare function slugify(s: unknown): string;
 /** Valid Pascal/slug DocType name (letters/digits/dash/underscore, alnum-led, no space). */