@lumel/ai-schema-host 1.0.0 → 1.1.0

package/dist/{knowledge.json → knowledge/visual.json}

@@ -1,108 +1,4 @@
 [
-    {
-        "id": "fabric-base-theme",
-        "scope": "base",
-        "visualType": "COMMON",
-        "sectionKey": "theme",
-        "propertyName": "themeSchema",
-        "affectedVisualTypes": ["dashboard", "report", "page"],
-        "title": "Base Theme",
-        "description": "Top-level dashboard/report theme. Sets the global look (light, dark, IBCS, color-blind, etc.) that every visual inherits unless it overrides locally. Lives on baseSchema.themeSchema.name.",
-        "structureNote": "BATCH = replace. themeSchema is a single object { name }. Send the whole themeSchema object when changing the theme. updatePatterns are NON-EXHAUSTIVE examples showing patch SHAPE only — copy the structure/nesting, not the literal values; any key in schemaJson is editable the same way.",
-        "schemaJson": {
-            "name": {
-                "type": "enum",
-                "default": "DEFAULT",
-                "options": ["LIGHT", "DARK", "DEFAULT", "MIDNIGHT", "IBCS", "COLOR_BLIND_LIGHT", "COLOR_BLIND_DARK", "INFORIVER", "CUSTOM"],
-                "description": "Global theme applied to the whole layout. IBCS enables IBCS-standard styling for all charts."
-            }
-        },
-        "updatePatterns": {
-            "setDarkTheme": {
-                "intent": "Switch the dashboard to a dark theme",
-                "patch": { "name": "DARK" }
-            },
-            "setIbcsTheme": {
-                "intent": "Apply IBCS standard styling to the whole report",
-                "patch": { "name": "IBCS" }
-            }
-        }
-    },
-    {
-        "id": "fabric-base-canvas",
-        "scope": "base",
-        "visualType": "COMMON",
-        "sectionKey": "canvas",
-        "propertyName": "canvasSchema",
-        "affectedVisualTypes": ["dashboard", "report", "page"],
-        "title": "Base Canvas",
-        "description": "Dashboard/report-wide canvas: background and global typography defaults that visuals inherit. Lives on baseSchema.canvasSchema.",
-        "structureNote": "BATCH = replace. Re-send the full canvasSchema slice you are changing; preserve sibling keys (background, font). updatePatterns are NON-EXHAUSTIVE examples showing patch SHAPE only — copy the structure/nesting, not the literal values; any key in schemaJson is editable the same way.",
-        "schemaJson": {
-            "background": {
-                "type": "hex-color",
-                "default": "#ffffff",
-                "description": "CSS color of the canvas background behind all visuals."
-            },
-            "font": {
-                "_description": "Global typography defaults inherited by visuals.",
-                "family": { "type": "string", "default": "Segoe UI", "description": "CSS font-family stack for the layout." },
-                "size": { "type": "number", "default": 12, "description": "Base font size (px)." },
-                "color": { "type": "hex-color", "default": "#333333", "description": "Base text color." },
-                "responsive": { "type": "boolean", "default": true, "description": "Scale fonts responsively with the layout size." },
-                "autoColor": { "type": "boolean", "default": false, "description": "Auto-pick text color for contrast against the background." }
-            }
-        },
-        "updatePatterns": {
-            "setBackground": {
-                "intent": "Set the canvas background color",
-                "patch": { "background": "#f5f5f5" }
-            },
-            "setBaseFont": {
-                "intent": "Change the global font family and size (values illustrative)",
-                "patch": { "font": { "family": "Arial", "size": 14 } }
-            }
-        }
-    },
-    {
-        "id": "fabric-base-visualGroupMap",
-        "scope": "base",
-        "visualType": "COMMON",
-        "sectionKey": "visualGroupMap",
-        "propertyName": "visualGroupMap",
-        "affectedVisualTypes": ["dashboard", "report", "page"],
-        "title": "Visual Group Map",
-        "description": "Map of group elements that bundle visuals together for collective layout, visibility and rotation. Keyed by group element id on baseSchema.visualGroupMap.",
-        "structureNote": "BATCH = replace. Each entry is keyed by group id. Send the full group entry when updating; do not drop sibling group entries. updatePatterns are NON-EXHAUSTIVE examples showing patch SHAPE only — copy the structure/nesting, not the literal values; any key in schemaJson is editable the same way.",
-        "schemaJson": {
-            "<groupId>": {
-                "name": { "type": "string", "default": "", "description": "Display name of the group." },
-                "isHidden": { "type": "boolean", "default": false, "description": "Hide the entire group and its visuals." },
-                "isExpanded": { "type": "boolean", "default": true, "description": "Whether the group is expanded in the layout tree." },
-                "shallowDelete": { "type": "boolean", "default": false, "description": "Soft-delete marker; keeps the group entry but removes it from render." },
-                "dimensionConfig": {
-                    "_description": "Sizing behavior of the group container (see visual.dimensionConfig).",
-                    "type": "object"
-                },
-                "rotation": {
-                    "_description": "Group rotation transform.",
-                    "isEnabled": { "type": "boolean", "default": false, "description": "Enable rotation for the group." },
-                    "transform": { "type": "number", "default": 0, "description": "Rotation angle in degrees." },
-                    "center": { "type": "object", "default": null, "description": "Optional rotation center { x, y }." }
-                }
-            }
-        },
-        "updatePatterns": {
-            "hideGroup": {
-                "intent": "Hide a visual group",
-                "patch": { "<groupId>": { "isHidden": true } }
-            },
-            "renameGroup": {
-                "intent": "Rename a visual group",
-                "patch": { "<groupId>": { "name": "KPIs" } }
-            }
-        }
-    },
     {
         "id": "fabric-visual-dimension",
         "scope": "visual",
@@ -311,123 +207,6 @@
             }
         }
     },
-    {
-        "id": "fabric-chart-axis",
-        "scope": "visual",
-        "visualType": "CHART",
-        "sectionKey": "axis",
-        "propertyName": "axis",
-        "affectedVisualTypes": ["bar", "column", "line", "area", "combo", "waterfall", "scatter", "bubble"],
-        "title": "Chart Axis Configuration",
-        "description": "Controls the chart axes: x (category), y (primary value), y2 (secondary/dual value) and yMeasures (per-measure value axes keyed by multiple-axis id). Each axis has enabled, label, title and gridLine groups. Not applicable to pie/donut/treemap/funnel/sankey/gantt.",
-        "structureNote": "BATCH = replace. y-axis title color/size/bold/italic are NOT read from title.* — they route to the matching series label; only title.show + x-axis title.text apply directly. Re-send the full axis slice you change and preserve sibling axes. updatePatterns are NON-EXHAUSTIVE examples showing patch SHAPE only — copy the structure/nesting, not the literal values; any key in schemaJson is editable the same way.",
-        "schemaJson": {
-            "x": {
-                "_description": "Category axis.",
-                "enabled": { "type": "boolean", "default": true, "description": "Show or hide the entire x-axis." },
-                "display": { "type": "enum", "default": "scaleBand", "options": ["off", "yAxis", "scaleBand", "individualScaling"], "description": "Axis render mode." },
-                "label": {
-                    "_description": "Tick / category label styling.",
-                    "show": { "type": "boolean", "default": true, "description": "Show category labels." },
-                    "fontSize": { "type": "number", "default": null, "description": "Label font size (px)." },
-                    "bold": { "type": "boolean", "default": false, "description": "Bold labels." },
-                    "italic": { "type": "boolean", "default": false, "description": "Italic labels." },
-                    "color": { "type": "hex-color", "default": "#333333", "description": "Label text color." }
-                },
-                "title": {
-                    "_description": "Axis title text + styling.",
-                    "show": { "type": "boolean", "default": true, "description": "Show the axis title." },
-                    "text": { "type": "string", "default": "", "description": "Axis title text (x-axis applies directly)." },
-                    "fontSize": { "type": "number", "default": null, "description": "Title font size (px)." },
-                    "bold": { "type": "boolean", "default": false, "description": "Bold title." },
-                    "italic": { "type": "boolean", "default": false, "description": "Italic title." },
-                    "color": { "type": "hex-color", "default": "#333333", "description": "Title text color." }
-                },
-                "gridLine": {
-                    "_description": "Major gridline visibility, color and width.",
-                    "show": { "type": "boolean", "default": true, "description": "Show gridlines." },
-                    "color": { "type": "hex-color", "default": "#cccccc", "description": "Gridline color." },
-                    "width": { "type": "number", "default": 1, "description": "Gridline width (px)." }
-                }
-            },
-            "y": {
-                "_description": "Primary value axis. Same field groups as x. Note y-title style routes to series labels.",
-                "enabled": { "type": "boolean", "default": true, "description": "Show or hide the primary y-axis." },
-                "display": { "type": "enum", "default": "scaleBand", "options": ["off", "yAxis", "scaleBand", "individualScaling"], "description": "Axis render mode." },
-                "label": { "type": "object", "description": "Same label group as x.label." },
-                "title": { "type": "object", "description": "Same title group as x.title; only show applies directly, style routes to series label." },
-                "gridLine": { "type": "object", "description": "Same gridLine group as x.gridLine." }
-            },
-            "y2": {
-                "_description": "Secondary (dual) value axis. Same structure as y.",
-                "enabled": { "type": "boolean", "default": false, "description": "Show or hide the secondary y-axis." }
-            },
-            "yMeasures": {
-                "_description": "Per-measure value axes keyed by multipleYAxis id. Each value has the same structure as a single axis.",
-                "<multipleYAxisId>": { "type": "object", "description": "Axis config for one measure (label/title/gridLine)." }
-            }
-        },
-        "updatePatterns": {
-            "enableXAxisBoldLabels": {
-                "intent": "Enable the x-axis and bold its labels",
-                "patch": { "x": { "enabled": true, "label": { "bold": true } } }
-            },
-            "styleYTitle": {
-                "intent": "Color the primary y-axis title and set its size (routes to series labels; values illustrative)",
-                "patch": { "y": { "title": { "color": "#ff0000", "fontSize": 14 } } }
-            },
-            "stylePerMeasureAxis": {
-                "intent": "Style a per-measure y-axis label",
-                "patch": { "yMeasures": { "<multipleYAxisId>": { "label": { "color": "#333333" } } } }
-            },
-            "hideXGridLines": {
-                "intent": "Hide the x-axis grid lines",
-                "patch": { "x": { "gridLine": { "show": false } } }
-            }
-        }
-    },
-    {
-        "id": "fabric-chart-canvas",
-        "scope": "visual",
-        "visualType": "CHART",
-        "sectionKey": "canvas",
-        "propertyName": "canvas",
-        "affectedVisualTypes": ["bar", "column", "line", "area", "combo", "pie", "donut", "treemap", "funnel"],
-        "title": "Chart Canvas",
-        "description": "Chart-level canvas controls: chart theme, background color and typography. Overrides the inherited base canvas for this chart only.",
-        "structureNote": "BATCH = replace. Preserve sibling keys (theme, background, font) when patching. Changing theme resets measuresStyle to that theme's defaults. updatePatterns are NON-EXHAUSTIVE examples showing patch SHAPE only — copy the structure/nesting, not the literal values; any key in schemaJson is editable the same way.",
-        "schemaJson": {
-            "theme": {
-                "type": "enum",
-                "default": "ibcs",
-                "options": ["ibcs", "default", "ocean", "spring", "autumn", "grayscale"],
-                "description": "Active color theme. ibcs = IBCS standard black/gray palette (AC=black, PY=gray). Changing theme resets measuresStyle to theme defaults."
-            },
-            "background": { "type": "hex-color", "default": "#ffffff", "description": "Chart canvas background color." },
-            "font": {
-                "_description": "Chart typography.",
-                "family": { "type": "string", "default": "Segoe UI", "description": "Font family stack." },
-                "size": { "type": "number", "default": 12, "description": "Font size (px)." },
-                "color": { "type": "hex-color", "default": "#333333", "description": "Text color." },
-                "responsive": { "type": "boolean", "default": true, "description": "Scale fonts responsively." },
-                "autoColor": { "type": "boolean", "default": false, "description": "Auto-pick text color for contrast." }
-            }
-        },
-        "updatePatterns": {
-            "setChartTheme": {
-                "intent": "Switch the chart color theme (e.g. to ocean)",
-                "patch": { "theme": "ocean" }
-            },
-            "setChartBackground": {
-                "intent": "Set the chart background color",
-                "patch": { "background": "#fafafa" }
-            },
-            "setChartFont": {
-                "intent": "Change the chart font (values illustrative)",
-                "patch": { "font": { "family": "Arial", "size": 13 } }
-            }
-        }
-    },
     {
         "id": "fabric-matrix-placeholder",
         "scope": "visual",
@@ -466,5 +245,128 @@
         "structureNote": "Schema pending. Do not emit patches for secondary-visual visual-state until this section gains fields.",
         "schemaJson": {},
         "updatePatterns": {}
+    },
+    {
+        "id": "fabric-box",
+        "scope": "visual",
+        "visualType": "BOX",
+        "sectionKey": "box",
+        "propertyName": "boxSchema",
+        "affectedVisualTypes": ["box"],
+        "title": "Box Native Visual",
+        "description": "Native layout container that holds other visuals. Controls layout direction, child spacing, alignment, overflow and wrapping. Maps to the box store (IBoxElementState) via the field-map driven native compiler, scoped by visualId.",
+        "structureNote": "MERGE = deep-merge against current state. 'between' alignment is valid only on the box's MAIN axis (vertical box -> verticalAlignment, horizontal box -> horizontalAlignment); pairing a layout with the off-axis 'between' is rejected, and changing the layout resets an off-axis 'between' to its default. updatePatterns are NON-EXHAUSTIVE examples showing patch SHAPE only — copy the structure/nesting, not the literal values; any key in schemaJson is editable the same way.",
+        "schemaJson": {
+            "layout": { "type": "enum", "default": "vertical", "options": ["vertical", "horizontal"], "description": "Layout direction of the container (store: boxType)." },
+            "gap": { "type": "number", "default": 0, "description": "Spacing between children (px)." },
+            "verticalAlignment": { "type": "enum", "default": "top", "options": ["top", "center", "bottom", "between"], "description": "Vertical alignment of children. 'between' valid only for a vertical box." },
+            "horizontalAlignment": { "type": "enum", "default": "left", "options": ["left", "center", "right", "between"], "description": "Horizontal alignment of children. 'between' valid only for a horizontal box." },
+            "overflow": {
+                "_description": "Overflow behavior per axis.",
+                "horizontal": { "type": "enum", "default": "hidden", "options": ["hidden", "scroll"], "description": "Horizontal overflow behavior." },
+                "vertical": { "type": "enum", "default": "hidden", "options": ["hidden", "scroll"], "description": "Vertical overflow behavior." }
+            },
+            "wrapContent": { "type": "boolean", "default": false, "description": "Whether children wrap onto multiple lines." }
+        },
+        "updatePatterns": {
+            "stackVertically": {
+                "intent": "Stack children vertically with spacing",
+                "patch": { "layout": "vertical", "gap": 16 }
+            },
+            "spaceBetween": {
+                "intent": "Distribute children with space between them in a horizontal box",
+                "patch": { "layout": "horizontal", "horizontalAlignment": "between" }
+            }
+        }
+    },
+    {
+        "id": "fabric-shape",
+        "scope": "visual",
+        "visualType": "SHAPE",
+        "sectionKey": "shape",
+        "propertyName": "shapeSchema",
+        "affectedVisualTypes": ["shape"],
+        "title": "Shape Native Visual",
+        "description": "Native shape styling: fill, border, shadow and tooltip. Maps to the shape store (IShapeStyles) via the field-map driven native compiler, scoped by visualId. Shape geometry, text-on-shape, icon and action sections are deferred.",
+        "structureNote": "MERGE = deep-merge against current state. Each section (fill, border, shadow, tooltip) is its own nested object; preserve the sections you are not changing. updatePatterns are NON-EXHAUSTIVE examples showing patch SHAPE only — copy the structure/nesting, not the literal values; any key in schemaJson is editable the same way.",
+        "schemaJson": {
+            "fill": {
+                "_description": "Background fill.",
+                "color": { "type": "hex-color", "default": "#ffffff", "description": "Fill color (store: fill.fillColor)." },
+                "show": { "type": "boolean", "default": true, "description": "Enable the fill (store: fill.isEnabled)." }
+            },
+            "border": {
+                "_description": "Outline.",
+                "color": { "type": "hex-color", "default": "#cccccc", "description": "Border color." },
+                "width": { "type": "number", "default": 1, "description": "Border width (px)." },
+                "style": { "type": "enum", "default": "solid", "options": ["solid", "dotted", "dashed"], "description": "Border line style." },
+                "show": { "type": "boolean", "default": false, "description": "Enable the border (store: border.isEnabled)." }
+            },
+            "shadow": {
+                "_description": "Drop shadow.",
+                "color": { "type": "hex-color", "default": "#00000033", "description": "Shadow color." },
+                "blur": { "type": "number", "default": 4, "description": "Shadow blur radius (px)." },
+                "show": { "type": "boolean", "default": false, "description": "Enable the shadow (store: shadow.isEnabled)." }
+            },
+            "tooltip": {
+                "_description": "Hover tooltip.",
+                "content": { "type": "string", "default": "", "description": "Tooltip text." },
+                "show": { "type": "boolean", "default": false, "description": "Enable the tooltip (store: tooltip.isEnabled)." }
+            }
+        },
+        "updatePatterns": {
+            "fillWithDashedBorder": {
+                "intent": "Solid blue fill with a dashed border (values illustrative)",
+                "patch": { "fill": { "color": "#1f6feb", "show": true }, "border": { "color": "#0b3d91", "width": 1, "style": "dashed", "show": true } }
+            }
+        }
+    },
+    {
+        "id": "fabric-navigator",
+        "scope": "visual",
+        "visualType": "NAVIGATOR",
+        "sectionKey": "navigator",
+        "propertyName": "navigatorSchema",
+        "affectedVisualTypes": ["navigator"],
+        "title": "Navigator Native Visual",
+        "description": "Native runtime-input element ('Navigator' in the UI): navigator kind and button action. Maps to the navigator store (INavigatorState) via the field-map driven native compiler, scoped by visualId. Per-state styling and tab layout are deferred.",
+        "structureNote": "MERGE = deep-merge against current state. button.* fields apply to the NAVIGATOR_BUTTON kind; set the matching target (webUrl/bookmarkId/pageDestinationId/variableId) for the chosen action. updatePatterns are NON-EXHAUSTIVE examples showing patch SHAPE only — copy the structure/nesting, not the literal values; any key in schemaJson is editable the same way.",
+        "schemaJson": {
+            "type": { "type": "enum", "default": "NAVIGATOR_BUTTON", "options": ["NAVIGATOR_BUTTON", "BOOKMARK_TABS", "PAGE_NAVIGATOR_TABS"], "description": "Navigator kind." },
+            "button": {
+                "_description": "Button behavior (applies to the NAVIGATOR_BUTTON kind).",
+                "action": { "type": "enum", "default": "NONE", "options": ["NONE", "BACK", "WEB_URL", "PAGE_NAVIGATION", "BOOKMARK_NAVIGATION", "CLEAR_SLICER", "APPLY_SLICER", "DRILL_THROUGH", "VARIABLE"], "description": "Button action (store: navigatorButtonState.actionType)." },
+                "webUrl": { "type": "string", "default": "", "description": "Target URL when action is WEB_URL." },
+                "bookmarkId": { "type": "string", "default": "", "description": "Target bookmark id when action is BOOKMARK_NAVIGATION." },
+                "pageDestinationId": { "type": "string", "default": "", "description": "Target page id when action is PAGE_NAVIGATION." },
+                "variableId": { "type": "string", "default": "", "description": "Target variable id when action is VARIABLE." }
+            }
+        },
+        "updatePatterns": {
+            "openUrl": {
+                "intent": "Make the button open a URL",
+                "patch": { "type": "NAVIGATOR_BUTTON", "button": { "action": "WEB_URL", "webUrl": "https://example.com" } }
+            }
+        }
+    },
+    {
+        "id": "fabric-text",
+        "scope": "visual",
+        "visualType": "TEXT",
+        "sectionKey": "text",
+        "propertyName": "textSchema",
+        "affectedVisualTypes": ["text"],
+        "title": "Text Native Visual",
+        "description": "Native rich-text element. v1 exposes the plain-text content only. Maps to the text store (visualState.text) via the field-map driven native compiler, scoped by visualId. Character styling (font/color/bold) lives in the selection-scoped textStyleStore applied via the Lexical editor and is deferred.",
+        "structureNote": "MERGE = deep-merge against current state. Only content is writable; do not emit character-style patches. updatePatterns are NON-EXHAUSTIVE examples showing patch SHAPE only — copy the structure/nesting, not the literal values; any key in schemaJson is editable the same way.",
+        "schemaJson": {
+            "content": { "type": "string", "default": "", "description": "Plain-text content of the element (store: text)." }
+        },
+        "updatePatterns": {
+            "setContent": {
+                "intent": "Set the text content",
+                "patch": { "content": "Quarterly revenue summary" }
+            }
+        }
     }
-]
+]

package/dist/schemaTypes/AiSchema.type.d.ts

@@ -2,13 +2,21 @@ import { IMatrixSchema } from './visualStateSchema/MatrixSchema/matrixSchema.typ
 import { ISecondaryVisualsSchema } from './visualStateSchema/SecondaryVisual/SecondaryVisualSchema.type';
 import { ISuperFiltersSchema } from './visualStateSchema/SuperFilter/SuperFilterSchema.type';
 import { IChartSchema } from './visualStateSchema/ChartSchema/chartSchema.type';
+import { IBoxSchema } from './visualStateSchema/BoxSchema/boxSchema.type';
+import { ITextSchema } from './visualStateSchema/TextSchema/textSchema.type';
+import { IShapeSchema } from './visualStateSchema/ShapeSchema/shapeSchema.type';
+import { INavigatorSchema } from './visualStateSchema/NavigatorSchema/navigatorSchema.type';
 import type { EThemeType, EVisualType, IGroupElement, IPivotAssignment, ISuperFilter, IVisualDimension, IVisualDimensionConfig, IVisualElementStyles, IVisualPosition } from '@lumel/visual-host';
-export type TVisualStateSchema = IMatrixSchema | IChartSchema | ISuperFiltersSchema | ISecondaryVisualsSchema;
+export type TVisualStateSchema = IMatrixSchema | IChartSchema | ISuperFiltersSchema | ISecondaryVisualsSchema | IBoxSchema | ITextSchema | IShapeSchema | INavigatorSchema;
 export declare enum EVisualStateSchemaType {
     CHART = "CHART",
     MATRIX = "MATRIX",
     SUPER_FILTER = "SUPER_FILTER",
-    SECONDARY_VISUAL = "SECONDARY_VISUAL"
+    SECONDARY_VISUAL = "SECONDARY_VISUAL",
+    BOX = "BOX",
+    TEXT = "TEXT",
+    SHAPE = "SHAPE",
+    NAVIGATOR = "NAVIGATOR"
 }
 export interface IVisualSchema {
     chartType?: string;

package/dist/schemaTypes/AiSchema.type.js

@@ -13,5 +13,9 @@ var EVisualStateSchemaType = /*#__PURE__*/ function(EVisualStateSchemaType) {
     EVisualStateSchemaType["MATRIX"] = "MATRIX";
     EVisualStateSchemaType["SUPER_FILTER"] = "SUPER_FILTER";
     EVisualStateSchemaType["SECONDARY_VISUAL"] = "SECONDARY_VISUAL";
+    EVisualStateSchemaType["BOX"] = "BOX";
+    EVisualStateSchemaType["TEXT"] = "TEXT";
+    EVisualStateSchemaType["SHAPE"] = "SHAPE";
+    EVisualStateSchemaType["NAVIGATOR"] = "NAVIGATOR";
     return EVisualStateSchemaType;
 }({});

package/dist/schemaTypes/visualStateSchema/BoxSchema/boxSchema.type.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Curated AI schema contract for the native **Box** visual (layout container).
+ *
+ * The field-map driven compiler in `editable-app`
+ * (`modules/AiSchema/native/compilers/boxAiSchemaCompiler.ts`) is the single source of
+ * truth for how these map to the box store (`IBoxElementState`).
+ *
+ * Note: `between` alignment applies only to the box's MAIN axis — `verticalAlignment`
+ * for a vertical box, `horizontalAlignment` for a horizontal box. The compiler
+ * validates this on apply and normalizes it when the layout changes.
+ */
+export interface IBoxSchema {
+    schemaVersion?: number;
+    /** Layout direction of the container (store: `boxType`). */
+    layout?: 'vertical' | 'horizontal';
+    /** Spacing between children, in pixels. */
+    gap?: number;
+    /** Vertical alignment of children. `between` is valid only for a vertical box. */
+    verticalAlignment?: 'top' | 'center' | 'bottom' | 'between';
+    /** Horizontal alignment of children. `between` is valid only for a horizontal box. */
+    horizontalAlignment?: 'left' | 'center' | 'right' | 'between';
+    /** Overflow behaviour per axis. */
+    overflow?: {
+        horizontal?: 'hidden' | 'scroll';
+        vertical?: 'hidden' | 'scroll';
+    };
+    /** Whether children wrap onto multiple lines. */
+    wrapContent?: boolean;
+}

package/dist/schemaTypes/visualStateSchema/BoxSchema/boxSchema.type.js

@@ -0,0 +1,14 @@
+/**
+ * Curated AI schema contract for the native **Box** visual (layout container).
+ *
+ * The field-map driven compiler in `editable-app`
+ * (`modules/AiSchema/native/compilers/boxAiSchemaCompiler.ts`) is the single source of
+ * truth for how these map to the box store (`IBoxElementState`).
+ *
+ * Note: `between` alignment applies only to the box's MAIN axis — `verticalAlignment`
+ * for a vertical box, `horizontalAlignment` for a horizontal box. The compiler
+ * validates this on apply and normalizes it when the layout changes.
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});

package/dist/schemaTypes/visualStateSchema/ChartSchema/chartSchema.type.d.ts

@@ -1,12 +1,12 @@
 export type TChartTheme = string;
-export interface AxisLabelSchema {
+export interface IAxisLabelSchema {
     show?: boolean;
     fontSize?: number;
     bold?: boolean;
     italic?: boolean;
     color?: string;
 }
-export interface AxisTitleSchema {
+export interface IAxisTitleSchema {
     show?: boolean;
     text?: string;
     fontSize?: number;
@@ -14,40 +14,152 @@ export interface AxisTitleSchema {
     italic?: boolean;
     color?: string;
 }
-export interface AxisGridLineSchema {
+export interface IAxisGridLineSchema {
     show?: boolean;
     color?: string;
     width?: number;
 }
 export type TYAxisDisplayType = 'off' | 'yAxis' | 'scaleBand' | 'individualScaling';
-export interface AxisSchema {
+export interface IAxisSchema {
     enabled?: boolean;
     /** Y-axis rendering mode. Applies to `axis.y` and `axis.yMeasures.*` only. */
     display?: TYAxisDisplayType;
-    label?: AxisLabelSchema;
-    title?: AxisTitleSchema;
-    gridLine?: AxisGridLineSchema;
+    label?: IAxisLabelSchema;
+    title?: IAxisTitleSchema;
+    gridLine?: IAxisGridLineSchema;
 }
-export interface AxisGroupSchema {
-    x?: AxisSchema;
-    y?: AxisSchema;
-    y2?: AxisSchema;
-    yMeasures?: Record<string, AxisSchema>;
+export interface IAxisGroupSchema {
+    x?: IAxisSchema;
+    y?: IAxisSchema;
+    y2?: IAxisSchema;
+    yMeasures?: Record<string, IAxisSchema>;
 }
-export interface CanvasFontSchema {
+export interface ICanvasFontSchema {
     family?: string;
     size?: number;
     color?: string;
     responsive?: boolean;
     autoColor?: boolean;
 }
-export interface CanvasSchema {
+export interface ICanvasSchema {
     theme?: TChartTheme;
     background?: string;
-    font?: CanvasFontSchema;
+    font?: ICanvasFontSchema;
+}
+/** Legend title text + styling (curated). */
+export interface ILegendTitleSchema {
+    show?: boolean;
+    text?: string;
+    fontSize?: number;
+    color?: string;
+}
+/** Legend label styling (curated). */
+export interface ILegendLabelSchema {
+    show?: boolean;
+    fontSize?: number;
+    bold?: boolean;
+    italic?: boolean;
+    color?: string;
+}
+/** Curated legend controls. */
+export interface ILegendSchema {
+    enabled?: boolean;
+    layout?: 'horizontal' | 'vertical';
+    horizontalAlignment?: 'left' | 'center' | 'right';
+    verticalAlignment?: 'top' | 'middle' | 'bottom';
+    showIcon?: boolean;
+    markerStyle?: 'markerDefault' | 'marker' | 'line' | 'lineAndMarkers';
+    title?: ILegendTitleSchema;
+    label?: ILegendLabelSchema;
+}
+export type TDataLabelDisplay = 'auto' | 'limited' | 'minMax' | 'minOnly' | 'maxOnly' | 'firstLast' | 'firstOnly' | 'lastOnly' | 'nthLabel' | 'none' | 'outlier' | 'nthAndLast';
+export type TDataLabelPosition = 'auto' | 'outside' | 'insideTop' | 'insideCenter' | 'insideBottom' | 'center';
+/** Universal (chart-wide) data-label styling for a single measure. */
+export interface IDataLabelStyleSchema {
+    show?: boolean;
+    display?: TDataLabelDisplay;
+    position?: TDataLabelPosition;
+    fontSize?: number;
+    color?: string;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    background?: string;
+    showBackground?: boolean;
+}
+/**
+ * Variance data-label styling. Variance labels are a separate label shown for the
+ * variance measures (the change vs a reference scenario) on column/waterfall charts
+ * that have variance measures. This block is applied to every variance measure.
+ */
+export interface IDataLabelVarianceSchema {
+    /** Enable/disable the variance labels (store: enabled). */
+    show?: boolean;
+    /** Which variance labels to show (store: varianceDisplay). */
+    display?: TDataLabelDisplay;
+    /** Label position relative to the data point (store: position). */
+    position?: TDataLabelPosition;
+    fontSize?: number;
+    /** Font color (store: fontColor). */
+    color?: string;
+    /** Bold (store: commonFontStyle.isBold). */
+    bold?: boolean;
+    /** Italic (store: commonFontStyle.isItalic). */
+    italic?: boolean;
+    /** Background color (store: background). */
+    background?: string;
+    /** Show the background (store: showBackgroundColor). */
+    showBackground?: boolean;
+}
+/**
+ * Curated data-label controls, addressed by measure display name. `all` applies
+ * to every measure first; `measures` entries override per measure. `variance`
+ * styles the variance labels (applied to every variance measure).
+ */
+export interface IDataLabelSchema {
+    all?: IDataLabelStyleSchema;
+    measures?: Record<string, IDataLabelStyleSchema>;
+    variance?: IDataLabelVarianceSchema;
+}
+/**
+ * Curated chart types a single measure series can be rendered as. The allowed
+ * values depend on the measure category (actual/box-plot vs absolute/relative
+ * variance vs additional-actual); the resolver validates the choice per measure
+ * and skips with a warning when it does not apply.
+ */
+export type TMeasureChartType = 'groupedBar' | 'bar' | 'lollipop' | 'waterfall' | 'table' | 'lineChart' | 'areaChart' | 'varianceBar' | 'variancePin' | 'varianceWaterfall';
+/** Which y-axis a measure is plotted against. Multi-axis (MAC) charts only. */
+export type TMeasureAxis = 'yAxis1' | 'yAxis2' | 'yAxis3' | 'yAxis4' | 'yAxis5' | 'yAxis6' | 'none';
+/** Per-measure series controls (visibility / render type / axis). */
+export interface IMeasureSeriesEntrySchema {
+    /** Show or hide this measure's series (store: isVisible + chartIsVisible). */
+    show?: boolean;
+    /** Render type for this measure (store: chart). Valid options depend on the measure category. */
+    chartType?: TMeasureChartType;
+    /** Y-axis this measure is plotted on (store: yAxis). Multi-axis (MAC) charts only. */
+    axis?: TMeasureAxis;
+}
+/**
+ * Per-measure series controls, addressed by measure display name (NOT internal
+ * role/id). Lets you reorder, show/hide, change how a measure is plotted, and assign
+ * it to a secondary axis on multi-axis charts.
+ */
+export interface IMeasureSeriesSchema {
+    /**
+     * Desired display order, listed by measure display name (the drag sequence). May be
+     * partial — unlisted measures keep their current relative order, after the listed
+     * ones. Ordering is applied within each measure category (actuals vs variances)
+     * exactly as the Measure & Series modal does.
+     */
+    order?: string[];
+    /** Per-measure controls (visibility / render type / axis), keyed by measure display name. */
+    measures?: Record<string, IMeasureSeriesEntrySchema>;
 }
 export interface IChartSchema {
     schemaVersion?: number;
-    axis?: AxisGroupSchema;
-    canvas?: CanvasSchema;
+    axis?: IAxisGroupSchema;
+    canvas?: ICanvasSchema;
+    legend?: ILegendSchema;
+    dataLabel?: IDataLabelSchema;
+    measureSeries?: IMeasureSeriesSchema;
 }