@fieldia/core 0.1.0

package/src/lib/format/layout.d.ts

@@ -0,0 +1,521 @@
+import * as z from 'zod';
+import { type JsonValue } from './json';
+/**
+ * The layout: where each field goes and what surrounds it.
+ *
+ * Every element carries a stable `id`, unique within the page, so a designer
+ * can select it, undo can name it, and an app can override it. Anything that
+ * shows or hides by state takes a modifier: `true`, `false`, or an expression
+ * such as `state == 'draft' and amount > 100`.
+ */
+/** `true`, `false`, or an expression evaluated against the record's values. */
+export type Modifier = boolean | string;
+export type Tone = 'info' | 'success' | 'warning' | 'danger' | 'muted';
+export interface FieldNode {
+    type: 'field';
+    id: string;
+    field: string;
+    label?: string;
+    /** How the value is shown, when not the type's default: radio, tags, email… */
+    widget?: string;
+    placeholder?: string;
+    help?: string;
+    /** Grid columns this field spans inside a section. */
+    colspan?: number;
+    /** For one2many and many2many: which line fields show as columns. */
+    columns?: string[];
+    invisible?: Modifier;
+    readonly?: Modifier;
+    required?: Modifier;
+}
+export interface ButtonNode {
+    type: 'button';
+    id: string;
+    label: string;
+    /** The action's name. The app decides what it does. */
+    action: string;
+    params?: {
+        [key: string]: JsonValue;
+    };
+    style?: 'primary' | 'secondary' | 'danger' | 'link';
+    /** Ask before running the action. */
+    confirm?: string;
+    icon?: string;
+    invisible?: Modifier;
+}
+export interface TextNode {
+    type: 'text';
+    id: string;
+    text: string;
+    style?: 'heading' | 'paragraph' | 'note';
+    invisible?: Modifier;
+}
+/** A named place the app fills with its own content, such as an activity feed. */
+export interface SlotNode {
+    type: 'slot';
+    id: string;
+    name: string;
+    invisible?: Modifier;
+}
+export interface SectionNode {
+    type: 'section';
+    id: string;
+    title?: string;
+    description?: string;
+    columns?: 1 | 2 | 3 | 4;
+    collapsible?: boolean;
+    invisible?: Modifier;
+    children: LayoutNode[];
+}
+export interface TabNode {
+    type: 'tab';
+    id: string;
+    label: string;
+    icon?: string;
+    invisible?: Modifier;
+    children: LayoutNode[];
+}
+export interface TabsNode {
+    type: 'tabs';
+    id: string;
+    invisible?: Modifier;
+    children: TabNode[];
+}
+/** A step of a wizard. An invisible step is skipped, which is how surveys branch. */
+export interface StepNode {
+    type: 'step';
+    id: string;
+    label: string;
+    description?: string;
+    invisible?: Modifier;
+    children: LayoutNode[];
+}
+export interface WizardNode {
+    type: 'wizard';
+    id: string;
+    children: StepNode[];
+}
+export interface SectionsNode {
+    type: 'sections';
+    id: string;
+    children: LayoutNode[];
+}
+export interface StatButton {
+    id: string;
+    label: string;
+    action: string;
+    /** A numeric field shown on the button, such as a count of invoices. */
+    field?: string;
+    icon?: string;
+    invisible?: Modifier;
+}
+export interface Ribbon {
+    id: string;
+    label: string;
+    tone?: Tone;
+    invisible?: Modifier;
+}
+export interface Alert {
+    id: string;
+    message: string;
+    tone?: Tone;
+    invisible?: Modifier;
+}
+export interface SheetTitle {
+    field: string;
+    subtitleField?: string;
+    avatarField?: string;
+    placeholder?: string;
+}
+export interface Statusbar {
+    field: string;
+    /** Show only these states, as Flectra-style status bars often do. */
+    visibleStates?: (string | number)[];
+    /** Clicking a state moves the record to it. */
+    clickable?: boolean;
+}
+/** The record layout: a header with a statusbar and buttons, then the sheet itself. */
+export interface SheetNode {
+    type: 'sheet';
+    id: string;
+    title?: SheetTitle;
+    statusbar?: Statusbar;
+    buttons?: ButtonNode[];
+    statButtons?: StatButton[];
+    ribbon?: Ribbon;
+    alerts?: Alert[];
+    children: LayoutNode[];
+    sidePanel?: SlotNode;
+}
+/** Anything that can sit inside a section, tab, step or sheet. */
+export type LayoutNode = FieldNode | ButtonNode | TextNode | SlotNode | SectionNode | TabsNode;
+/** What a page's `layout` can be: the four page layouts. */
+export type RootLayout = SheetNode | SectionsNode | TabsNode | WizardNode;
+export declare const ModifierSchema: z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>;
+export declare const FieldNodeSchema: z.ZodObject<{
+    type: z.ZodLiteral<"field">;
+    id: z.ZodString;
+    field: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    widget: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodString>;
+    help: z.ZodOptional<z.ZodString>;
+    colspan: z.ZodOptional<z.ZodInt>;
+    columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    readonly: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    required: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+}, z.z.core.$strict>;
+export declare const ButtonNodeSchema: z.ZodObject<{
+    type: z.ZodLiteral<"button">;
+    id: z.ZodString;
+    label: z.ZodString;
+    action: z.ZodString;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    style: z.ZodOptional<z.ZodEnum<{
+        danger: "danger";
+        primary: "primary";
+        secondary: "secondary";
+        link: "link";
+    }>>;
+    confirm: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+}, z.z.core.$strict>;
+export declare const TextNodeSchema: z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    id: z.ZodString;
+    text: z.ZodString;
+    style: z.ZodOptional<z.ZodEnum<{
+        heading: "heading";
+        paragraph: "paragraph";
+        note: "note";
+    }>>;
+    invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+}, z.z.core.$strict>;
+export declare const SlotNodeSchema: z.ZodObject<{
+    type: z.ZodLiteral<"slot">;
+    id: z.ZodString;
+    name: z.ZodString;
+    invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+}, z.z.core.$strict>;
+export declare const SectionNodeSchema: z.ZodObject<{
+    type: z.ZodLiteral<"section">;
+    id: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    columns: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>;
+    collapsible: z.ZodOptional<z.ZodBoolean>;
+    invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    children: z.ZodArray<typeof LayoutNodeSchema>;
+}, z.z.core.$strict>;
+export declare const TabNodeSchema: z.ZodObject<{
+    type: z.ZodLiteral<"tab">;
+    id: z.ZodString;
+    label: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+    invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    children: z.ZodArray<typeof LayoutNodeSchema>;
+}, z.z.core.$strict>;
+export declare const TabsNodeSchema: z.ZodObject<{
+    type: z.ZodLiteral<"tabs">;
+    id: z.ZodString;
+    invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    children: z.ZodArray<z.ZodObject<{
+        type: z.ZodLiteral<"tab">;
+        id: z.ZodString;
+        label: z.ZodString;
+        icon: z.ZodOptional<z.ZodString>;
+        invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+        children: z.ZodArray<typeof LayoutNodeSchema>;
+    }, z.z.core.$strict>>;
+}, z.z.core.$strict>;
+export declare const LayoutNodeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"field">;
+    id: z.ZodString;
+    field: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    widget: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodString>;
+    help: z.ZodOptional<z.ZodString>;
+    colspan: z.ZodOptional<z.ZodInt>;
+    columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    readonly: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    required: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+}, z.z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"button">;
+    id: z.ZodString;
+    label: z.ZodString;
+    action: z.ZodString;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    style: z.ZodOptional<z.ZodEnum<{
+        danger: "danger";
+        primary: "primary";
+        secondary: "secondary";
+        link: "link";
+    }>>;
+    confirm: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+}, z.z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    id: z.ZodString;
+    text: z.ZodString;
+    style: z.ZodOptional<z.ZodEnum<{
+        heading: "heading";
+        paragraph: "paragraph";
+        note: "note";
+    }>>;
+    invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+}, z.z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"slot">;
+    id: z.ZodString;
+    name: z.ZodString;
+    invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+}, z.z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"section">;
+    id: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    columns: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>;
+    collapsible: z.ZodOptional<z.ZodBoolean>;
+    invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    children: z.ZodArray<typeof LayoutNodeSchema>;
+}, z.z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"tabs">;
+    id: z.ZodString;
+    invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    children: z.ZodArray<z.ZodObject<{
+        type: z.ZodLiteral<"tab">;
+        id: z.ZodString;
+        label: z.ZodString;
+        icon: z.ZodOptional<z.ZodString>;
+        invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+        children: z.ZodArray<typeof LayoutNodeSchema>;
+    }, z.z.core.$strict>>;
+}, z.z.core.$strict>], "type">;
+export declare const StepNodeSchema: z.ZodObject<{
+    type: z.ZodLiteral<"step">;
+    id: z.ZodString;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    children: z.ZodArray<typeof LayoutNodeSchema>;
+}, z.z.core.$strict>;
+export declare const WizardNodeSchema: z.ZodObject<{
+    type: z.ZodLiteral<"wizard">;
+    id: z.ZodString;
+    children: z.ZodArray<z.ZodObject<{
+        type: z.ZodLiteral<"step">;
+        id: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+        children: z.ZodArray<typeof LayoutNodeSchema>;
+    }, z.z.core.$strict>>;
+}, z.z.core.$strict>;
+export declare const SectionsNodeSchema: z.ZodObject<{
+    type: z.ZodLiteral<"sections">;
+    id: z.ZodString;
+    children: z.ZodArray<typeof LayoutNodeSchema>;
+}, z.z.core.$strict>;
+export declare const StatButtonSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    action: z.ZodString;
+    field: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+}, z.z.core.$strict>;
+export declare const RibbonSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    tone: z.ZodOptional<z.ZodEnum<{
+        success: "success";
+        info: "info";
+        warning: "warning";
+        danger: "danger";
+        muted: "muted";
+    }>>;
+    invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+}, z.z.core.$strict>;
+export declare const AlertSchema: z.ZodObject<{
+    id: z.ZodString;
+    message: z.ZodString;
+    tone: z.ZodOptional<z.ZodEnum<{
+        success: "success";
+        info: "info";
+        warning: "warning";
+        danger: "danger";
+        muted: "muted";
+    }>>;
+    invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+}, z.z.core.$strict>;
+export declare const SheetNodeSchema: z.ZodObject<{
+    type: z.ZodLiteral<"sheet">;
+    id: z.ZodString;
+    title: z.ZodOptional<z.ZodObject<{
+        field: z.ZodString;
+        subtitleField: z.ZodOptional<z.ZodString>;
+        avatarField: z.ZodOptional<z.ZodString>;
+        placeholder: z.ZodOptional<z.ZodString>;
+    }, z.z.core.$strict>>;
+    statusbar: z.ZodOptional<z.ZodObject<{
+        field: z.ZodString;
+        visibleStates: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+        clickable: z.ZodOptional<z.ZodBoolean>;
+    }, z.z.core.$strict>>;
+    buttons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodLiteral<"button">;
+        id: z.ZodString;
+        label: z.ZodString;
+        action: z.ZodString;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+        style: z.ZodOptional<z.ZodEnum<{
+            danger: "danger";
+            primary: "primary";
+            secondary: "secondary";
+            link: "link";
+        }>>;
+        confirm: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodString>;
+        invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    }, z.z.core.$strict>>>;
+    statButtons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        action: z.ZodString;
+        field: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodString>;
+        invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    }, z.z.core.$strict>>>;
+    ribbon: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        tone: z.ZodOptional<z.ZodEnum<{
+            success: "success";
+            info: "info";
+            warning: "warning";
+            danger: "danger";
+            muted: "muted";
+        }>>;
+        invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    }, z.z.core.$strict>>;
+    alerts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        message: z.ZodString;
+        tone: z.ZodOptional<z.ZodEnum<{
+            success: "success";
+            info: "info";
+            warning: "warning";
+            danger: "danger";
+            muted: "muted";
+        }>>;
+        invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    }, z.z.core.$strict>>>;
+    children: z.ZodArray<typeof LayoutNodeSchema>;
+    sidePanel: z.ZodOptional<z.ZodObject<{
+        type: z.ZodLiteral<"slot">;
+        id: z.ZodString;
+        name: z.ZodString;
+        invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    }, z.z.core.$strict>>;
+}, z.z.core.$strict>;
+export declare const RootLayoutSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"sheet">;
+    id: z.ZodString;
+    title: z.ZodOptional<z.ZodObject<{
+        field: z.ZodString;
+        subtitleField: z.ZodOptional<z.ZodString>;
+        avatarField: z.ZodOptional<z.ZodString>;
+        placeholder: z.ZodOptional<z.ZodString>;
+    }, z.z.core.$strict>>;
+    statusbar: z.ZodOptional<z.ZodObject<{
+        field: z.ZodString;
+        visibleStates: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+        clickable: z.ZodOptional<z.ZodBoolean>;
+    }, z.z.core.$strict>>;
+    buttons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodLiteral<"button">;
+        id: z.ZodString;
+        label: z.ZodString;
+        action: z.ZodString;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+        style: z.ZodOptional<z.ZodEnum<{
+            danger: "danger";
+            primary: "primary";
+            secondary: "secondary";
+            link: "link";
+        }>>;
+        confirm: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodString>;
+        invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    }, z.z.core.$strict>>>;
+    statButtons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        action: z.ZodString;
+        field: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodString>;
+        invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    }, z.z.core.$strict>>>;
+    ribbon: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        tone: z.ZodOptional<z.ZodEnum<{
+            success: "success";
+            info: "info";
+            warning: "warning";
+            danger: "danger";
+            muted: "muted";
+        }>>;
+        invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    }, z.z.core.$strict>>;
+    alerts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        message: z.ZodString;
+        tone: z.ZodOptional<z.ZodEnum<{
+            success: "success";
+            info: "info";
+            warning: "warning";
+            danger: "danger";
+            muted: "muted";
+        }>>;
+        invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    }, z.z.core.$strict>>>;
+    children: z.ZodArray<typeof LayoutNodeSchema>;
+    sidePanel: z.ZodOptional<z.ZodObject<{
+        type: z.ZodLiteral<"slot">;
+        id: z.ZodString;
+        name: z.ZodString;
+        invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    }, z.z.core.$strict>>;
+}, z.z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"sections">;
+    id: z.ZodString;
+    children: z.ZodArray<typeof LayoutNodeSchema>;
+}, z.z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"tabs">;
+    id: z.ZodString;
+    invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    children: z.ZodArray<z.ZodObject<{
+        type: z.ZodLiteral<"tab">;
+        id: z.ZodString;
+        label: z.ZodString;
+        icon: z.ZodOptional<z.ZodString>;
+        invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+        children: z.ZodArray<typeof LayoutNodeSchema>;
+    }, z.z.core.$strict>>;
+}, z.z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"wizard">;
+    id: z.ZodString;
+    children: z.ZodArray<z.ZodObject<{
+        type: z.ZodLiteral<"step">;
+        id: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        invisible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+        children: z.ZodArray<typeof LayoutNodeSchema>;
+    }, z.z.core.$strict>>;
+}, z.z.core.$strict>], "type">;

package/src/lib/format/layout.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RootLayoutSchema = exports.SheetNodeSchema = exports.AlertSchema = exports.RibbonSchema = exports.StatButtonSchema = exports.SectionsNodeSchema = exports.WizardNodeSchema = exports.StepNodeSchema = exports.LayoutNodeSchema = exports.TabsNodeSchema = exports.TabNodeSchema = exports.SectionNodeSchema = exports.SlotNodeSchema = exports.TextNodeSchema = exports.ButtonNodeSchema = exports.FieldNodeSchema = exports.ModifierSchema = void 0;
+const z = require("zod");
+const field_1 = require("./field");
+const json_1 = require("./json");
+// ---------------------------------------------------------------------------
+// Schemas. Recursion goes through getters on z.strictObject (zod 4's own
+// pattern); `.strict()` would clone the shape and run the getters too early.
+// layout.types.ts proves these schemas and the interfaces above agree.
+// ---------------------------------------------------------------------------
+exports.ModifierSchema = z.union([z.boolean(), z.string().min(1)]).meta({ id: 'Modifier' });
+const id = z.string().regex(/^[A-Za-z0-9][A-Za-z0-9._-]*$/);
+const fieldName = z.string().regex(field_1.FIELD_NAME);
+const tone = z.enum(['info', 'success', 'warning', 'danger', 'muted']);
+const invisible = exports.ModifierSchema.optional();
+exports.FieldNodeSchema = z.strictObject({
+    type: z.literal('field'),
+    id,
+    field: fieldName,
+    label: z.string().optional(),
+    widget: z.string().min(1).optional(),
+    placeholder: z.string().optional(),
+    help: z.string().optional(),
+    colspan: z.int().min(1).max(4).optional(),
+    columns: z.array(fieldName).min(1).optional(),
+    invisible,
+    readonly: exports.ModifierSchema.optional(),
+    required: exports.ModifierSchema.optional(),
+});
+exports.ButtonNodeSchema = z.strictObject({
+    type: z.literal('button'),
+    id,
+    label: z.string(),
+    action: z.string().min(1),
+    params: z.record(z.string(), json_1.JsonValueSchema).optional(),
+    style: z.enum(['primary', 'secondary', 'danger', 'link']).optional(),
+    confirm: z.string().optional(),
+    icon: z.string().optional(),
+    invisible,
+});
+exports.TextNodeSchema = z.strictObject({
+    type: z.literal('text'),
+    id,
+    text: z.string(),
+    style: z.enum(['heading', 'paragraph', 'note']).optional(),
+    invisible,
+});
+exports.SlotNodeSchema = z.strictObject({ type: z.literal('slot'), id, name: z.string().min(1), invisible });
+exports.SectionNodeSchema = z.strictObject({
+    type: z.literal('section'),
+    id,
+    title: z.string().optional(),
+    description: z.string().optional(),
+    columns: z.union([z.literal(1), z.literal(2), z.literal(3), z.literal(4)]).optional(),
+    collapsible: z.boolean().optional(),
+    invisible,
+    get children() {
+        return z.array(exports.LayoutNodeSchema);
+    },
+}).meta({ id: 'SectionNode' });
+exports.TabNodeSchema = z.strictObject({
+    type: z.literal('tab'),
+    id,
+    label: z.string(),
+    icon: z.string().optional(),
+    invisible,
+    get children() {
+        return z.array(exports.LayoutNodeSchema);
+    },
+}).meta({ id: 'TabNode' });
+exports.TabsNodeSchema = z.strictObject({
+    type: z.literal('tabs'),
+    id,
+    invisible,
+    children: z.array(exports.TabNodeSchema).min(1),
+}).meta({ id: 'TabsNode' });
+exports.LayoutNodeSchema = z
+    .discriminatedUnion('type', [
+    exports.FieldNodeSchema,
+    exports.ButtonNodeSchema,
+    exports.TextNodeSchema,
+    exports.SlotNodeSchema,
+    exports.SectionNodeSchema,
+    exports.TabsNodeSchema,
+])
+    .meta({ id: 'LayoutNode' });
+exports.StepNodeSchema = z.strictObject({
+    type: z.literal('step'),
+    id,
+    label: z.string(),
+    description: z.string().optional(),
+    invisible,
+    get children() {
+        return z.array(exports.LayoutNodeSchema);
+    },
+}).meta({ id: 'StepNode' });
+exports.WizardNodeSchema = z.strictObject({
+    type: z.literal('wizard'),
+    id,
+    children: z.array(exports.StepNodeSchema).min(1),
+}).meta({ id: 'WizardNode' });
+exports.SectionsNodeSchema = z.strictObject({
+    type: z.literal('sections'),
+    id,
+    get children() {
+        return z.array(exports.LayoutNodeSchema);
+    },
+}).meta({ id: 'SectionsNode' });
+exports.StatButtonSchema = z.strictObject({
+    id,
+    label: z.string(),
+    action: z.string().min(1),
+    field: fieldName.optional(),
+    icon: z.string().optional(),
+    invisible,
+});
+exports.RibbonSchema = z.strictObject({ id, label: z.string(), tone: tone.optional(), invisible });
+exports.AlertSchema = z.strictObject({ id, message: z.string(), tone: tone.optional(), invisible });
+exports.SheetNodeSchema = z.strictObject({
+    type: z.literal('sheet'),
+    id,
+    title: z
+        .strictObject({
+        field: fieldName,
+        subtitleField: fieldName.optional(),
+        avatarField: fieldName.optional(),
+        placeholder: z.string().optional(),
+    })
+        .optional(),
+    statusbar: z
+        .strictObject({
+        field: fieldName,
+        visibleStates: z.array(z.union([z.string(), z.number()])).optional(),
+        clickable: z.boolean().optional(),
+    })
+        .optional(),
+    buttons: z.array(exports.ButtonNodeSchema).optional(),
+    statButtons: z.array(exports.StatButtonSchema).optional(),
+    ribbon: exports.RibbonSchema.optional(),
+    alerts: z.array(exports.AlertSchema).optional(),
+    get children() {
+        return z.array(exports.LayoutNodeSchema);
+    },
+    sidePanel: exports.SlotNodeSchema.optional(),
+}).meta({ id: 'SheetNode' });
+exports.RootLayoutSchema = z
+    .discriminatedUnion('type', [exports.SheetNodeSchema, exports.SectionsNodeSchema, exports.TabsNodeSchema, exports.WizardNodeSchema])
+    .meta({ id: 'RootLayout' });
+//# sourceMappingURL=layout.js.map

package/src/lib/format/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/format/layout.ts"],"names":[],"mappings":"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"}