@lumel/ai-schema-host 1.0.0 → 1.1.0

package/dist/compiler/AISchemaCompiler.d.ts

@@ -1,4 +1,4 @@
-import knowledge from '../knowledge.json';
+import knowledge from '../knowledge';
 import type { EVisualType, IAISchemaCompiler, IAISchemaCompileInput, IAISchemaApplyResult, IAISchemaValidationResult } from '@lumel/visual-host';
 import { EVisualStateSchemaType, TVisualStateSchema } from '../schemaTypes/AiSchema.type';
 /** Shape of the curated, machine-readable schema knowledge JSON. */

package/dist/compiler/AISchemaCompiler.js

@@ -8,7 +8,7 @@ Object.defineProperty(exports, "AISchemaCompiler", {
         return AISchemaCompiler;
     }
 });
-const _knowledgejson = /*#__PURE__*/ _interop_require_default(require("../knowledge.json"));
+const _knowledge = /*#__PURE__*/ _interop_require_default(require("../knowledge"));
 function _interop_require_default(obj) {
     return obj && obj.__esModule ? obj : {
         default: obj
@@ -65,6 +65,6 @@ class AISchemaCompiler {
         }
     }
     /** Curated, machine-readable schema knowledge for LLM prompts. */ getKnowledge() {
-        return _knowledgejson.default;
+        return _knowledge.default;
     }
 }

package/dist/index.d.ts

@@ -2,11 +2,16 @@ export * from './types';
 import type { TKbDocumentList } from './types';
 /** Index-ready curated schema knowledge: one document per schema section. */
 export declare const AI_SCHEMA_KNOWLEDGE: TKbDocumentList;
+export { BASE_KNOWLEDGE, CHART_KNOWLEDGE, VISUAL_KNOWLEDGE } from './knowledge';
 export * from './schemaTypes/AiSchema.type';
 export type { IChartSchema } from './schemaTypes/visualStateSchema/ChartSchema/chartSchema.type';
 export type { IMatrixSchema } from './schemaTypes/visualStateSchema/MatrixSchema/matrixSchema.type';
 export type { ISuperFiltersSchema } from './schemaTypes/visualStateSchema/SuperFilter/SuperFilterSchema.type';
 export type { ISecondaryVisualsSchema } from './schemaTypes/visualStateSchema/SecondaryVisual/SecondaryVisualSchema.type';
+export type { IBoxSchema } from './schemaTypes/visualStateSchema/BoxSchema/boxSchema.type';
+export type { ITextSchema } from './schemaTypes/visualStateSchema/TextSchema/textSchema.type';
+export type { IShapeSchema } from './schemaTypes/visualStateSchema/ShapeSchema/shapeSchema.type';
+export type { INavigatorSchema } from './schemaTypes/visualStateSchema/NavigatorSchema/navigatorSchema.type';
 export * from './compiler/types';
 export { AISchemaCompiler } from './compiler/AISchemaCompiler';
 export type { TAiSchemaKnowledge } from './compiler/AISchemaCompiler';

package/dist/index.js

@@ -14,10 +14,19 @@ _export(exports, {
     },
     get AI_SCHEMA_KNOWLEDGE () {
         return AI_SCHEMA_KNOWLEDGE;
+    },
+    get BASE_KNOWLEDGE () {
+        return _knowledge.BASE_KNOWLEDGE;
+    },
+    get CHART_KNOWLEDGE () {
+        return _knowledge.CHART_KNOWLEDGE;
+    },
+    get VISUAL_KNOWLEDGE () {
+        return _knowledge.VISUAL_KNOWLEDGE;
     }
 });
 _export_star(require("./types"), exports);
-const _knowledgejson = /*#__PURE__*/ _interop_require_default(require("./knowledge.json"));
+const _knowledge = /*#__PURE__*/ _interop_require_wildcard(require("./knowledge"));
 _export_star(require("./schemaTypes/AiSchema.type"), exports);
 _export_star(require("./compiler/types"), exports);
 const _AISchemaCompiler = require("./compiler/AISchemaCompiler");
@@ -34,9 +43,45 @@ function _export_star(from, to) {
     });
     return from;
 }
-function _interop_require_default(obj) {
-    return obj && obj.__esModule ? obj : {
-        default: obj
+function _getRequireWildcardCache(nodeInterop) {
+    if (typeof WeakMap !== "function") return null;
+    var cacheBabelInterop = new WeakMap();
+    var cacheNodeInterop = new WeakMap();
+    return (_getRequireWildcardCache = function(nodeInterop) {
+        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
+    })(nodeInterop);
+}
+function _interop_require_wildcard(obj, nodeInterop) {
+    if (!nodeInterop && obj && obj.__esModule) {
+        return obj;
+    }
+    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
+        return {
+            default: obj
+        };
+    }
+    var cache = _getRequireWildcardCache(nodeInterop);
+    if (cache && cache.has(obj)) {
+        return cache.get(obj);
+    }
+    var newObj = {
+        __proto__: null
     };
+    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
+    for(var key in obj){
+        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
+            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
+            if (desc && (desc.get || desc.set)) {
+                Object.defineProperty(newObj, key, desc);
+            } else {
+                newObj[key] = obj[key];
+            }
+        }
+    }
+    newObj.default = obj;
+    if (cache) {
+        cache.set(obj, newObj);
+    }
+    return newObj;
 }
-const AI_SCHEMA_KNOWLEDGE = _knowledgejson.default;
+const AI_SCHEMA_KNOWLEDGE = _knowledge.default;

package/dist/knowledge/base.json

@@ -0,0 +1,106 @@
+[
+    {
+        "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" } }
+            }
+        }
+    }
+]

package/dist/knowledge/chart.json

@@ -0,0 +1,265 @@
+[
+    {
+        "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-chart-legend",
+        "scope": "visual",
+        "visualType": "CHART",
+        "sectionKey": "legend",
+        "propertyName": "legend",
+        "affectedVisualTypes": ["bar", "column", "line", "area", "combo", "pie", "donut", "treemap", "funnel"],
+        "title": "Chart Legend",
+        "description": "Curated legend controls: visibility, layout, alignment, marker style and legend title/label typography. The resolver replays legendSettings reducers and the compiler does a single RESIZE render.",
+        "structureNote": "BATCH = replace. title and label are their own style objects; preserve sibling keys when patching. Legend font color/size can be overwritten by a later canvas/theme edit (canvas runs before legend). 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": {
+            "enabled": { "type": "boolean", "default": false, "description": "Show or hide the legend." },
+            "layout": { "type": "enum", "default": "horizontal", "options": ["horizontal", "vertical"], "description": "Legend orientation." },
+            "horizontalAlignment": { "type": "enum", "default": "center", "options": ["left", "center", "right"], "description": "Horizontal docking of the legend." },
+            "verticalAlignment": { "type": "enum", "default": "top", "options": ["top", "middle", "bottom"], "description": "Vertical docking of the legend." },
+            "showIcon": { "type": "boolean", "default": true, "description": "Show the series marker icon next to each legend item." },
+            "markerStyle": { "type": "enum", "default": "markerDefault", "options": ["markerDefault", "marker", "line", "lineAndMarkers"], "description": "Shape of the legend marker." },
+            "title": {
+                "_description": "Legend title text + styling.",
+                "show": { "type": "boolean", "default": false, "description": "Show the legend title." },
+                "text": { "type": "string", "default": "", "description": "Legend title text." },
+                "fontSize": { "type": "number", "default": null, "description": "Title font size (px)." },
+                "color": { "type": "hex-color", "default": "#333333", "description": "Title text color." }
+            },
+            "label": {
+                "_description": "Legend item label styling.",
+                "show": { "type": "boolean", "default": true, "description": "Show legend item 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." }
+            }
+        },
+        "updatePatterns": {
+            "enableDockBottomCenter": {
+                "intent": "Enable the legend, dock it bottom-center, and bold its labels",
+                "patch": { "enabled": true, "verticalAlignment": "bottom", "horizontalAlignment": "center", "label": { "bold": true } }
+            },
+            "setLegendTitle": {
+                "intent": "Give the legend a title",
+                "patch": { "title": { "show": true, "text": "Scenarios", "color": "#333333" } }
+            }
+        }
+    },
+    {
+        "id": "fabric-chart-dataLabel",
+        "scope": "visual",
+        "visualType": "CHART",
+        "sectionKey": "dataLabel",
+        "propertyName": "dataLabel",
+        "affectedVisualTypes": ["bar", "column", "line", "area", "combo", "waterfall"],
+        "title": "Chart Data Labels",
+        "description": "Universal (chart-wide) data-label styling, addressed by measure DISPLAY NAME, plus chart-wide variance-label settings. all applies to every measure first; measures entries override per measure; variance styles the variance labels on column/waterfall charts.",
+        "structureNote": "BATCH = replace. measures is keyed by the measure's display name (NOT internal role/id); duplicate display names warn + last-wins. all is applied before per-measure overrides. variance is applied to every variance measure. 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": {
+            "all": {
+                "_description": "Optional convenience style applied to every measure first, before per-measure overrides. Same fields as a measures entry.",
+                "type": "object"
+            },
+            "measures": {
+                "_description": "Per-measure data-label styling keyed by measure display name.",
+                "<measureDisplayName>": {
+                    "show": { "type": "boolean", "default": true, "description": "Show the data label." },
+                    "display": { "type": "enum", "default": "auto", "options": ["auto", "limited", "minMax", "minOnly", "maxOnly", "firstLast", "firstOnly", "lastOnly", "nthLabel", "none", "outlier", "nthAndLast"], "description": "Which labels to show along the series." },
+                    "position": { "type": "enum", "default": "auto", "options": ["auto", "outside", "insideTop", "insideCenter", "insideBottom", "center"], "description": "Label position relative to the data point." },
+                    "fontSize": { "type": "number", "default": null, "description": "Label font size (px)." },
+                    "color": { "type": "hex-color", "default": "#333333", "description": "Label text color." },
+                    "bold": { "type": "boolean", "default": false, "description": "Bold label." },
+                    "italic": { "type": "boolean", "default": false, "description": "Italic label." },
+                    "underline": { "type": "boolean", "default": false, "description": "Underline label." },
+                    "background": { "type": "hex-color", "default": "#ffffff", "description": "Label background color." },
+                    "showBackground": { "type": "boolean", "default": false, "description": "Show the label background." }
+                }
+            },
+            "variance": {
+                "_description": "Variance data-label styling (column/waterfall charts with variance measures). Applied to every variance measure.",
+                "show": { "type": "boolean", "default": false, "description": "Show the variance labels." },
+                "display": { "type": "enum", "default": "auto", "options": ["auto", "limited", "minMax", "minOnly", "maxOnly", "firstLast", "firstOnly", "lastOnly", "nthLabel", "none", "outlier", "nthAndLast"], "description": "Which variance labels to show." },
+                "position": { "type": "enum", "default": "auto", "options": ["auto", "outside", "insideTop", "insideCenter", "insideBottom", "center"], "description": "Variance label position." },
+                "fontSize": { "type": "number", "default": null, "description": "Variance label font size (px)." },
+                "color": { "type": "hex-color", "default": "#333333", "description": "Variance label text color." },
+                "bold": { "type": "boolean", "default": false, "description": "Bold variance label." },
+                "italic": { "type": "boolean", "default": false, "description": "Italic variance label." },
+                "background": { "type": "hex-color", "default": "#ffffff", "description": "Variance label background color." },
+                "showBackground": { "type": "boolean", "default": false, "description": "Show the variance label background." }
+            }
+        },
+        "updatePatterns": {
+            "styleMeasureLabel": {
+                "intent": "Show the Sales data label in bold white",
+                "patch": { "measures": { "Sales": { "show": true, "bold": true, "color": "#ffffff" } } }
+            },
+            "setAllFontSize": {
+                "intent": "Set every measure's data-label font size",
+                "patch": { "all": { "fontSize": 12 } }
+            },
+            "styleVarianceLabels": {
+                "intent": "Show variance labels at min and max, bold (values illustrative)",
+                "patch": { "variance": { "show": true, "display": "minMax", "bold": true, "fontSize": 11, "color": "#cc0000" } }
+            }
+        }
+    },
+    {
+        "id": "fabric-chart-measureSeries",
+        "scope": "visual",
+        "visualType": "CHART",
+        "sectionKey": "measureSeries",
+        "propertyName": "measureSeries",
+        "affectedVisualTypes": ["bar", "column", "line", "area", "combo", "waterfall"],
+        "title": "Chart Measure & Series",
+        "description": "Per-measure series controls addressed by measure DISPLAY NAME: reorder measures, show/hide a measure, change how it is plotted (chartType), and assign it to a y-axis on multi-axis (MAC) charts. Shape is { order?: string[]; measures?: Record<displayName, { show?, chartType?, axis? }> }.",
+        "structureNote": "BATCH = replace. measures is keyed by measure display name (NOT internal role/id); duplicate display names warn + last-wins. order may be partial — unlisted measures keep their relative order, after the listed ones; ordering applies within each category (actuals vs variances). chartType allowed values depend on the measure category; axis applies only on multi-axis (MAC) charts. 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": {
+            "order": {
+                "type": "array",
+                "default": [],
+                "description": "Desired display order as a list of measure display names (the drag sequence). May be partial."
+            },
+            "measures": {
+                "_description": "Per-measure series controls keyed by measure display name.",
+                "<measureDisplayName>": {
+                    "show": { "type": "boolean", "default": true, "description": "Show or hide this measure's series." },
+                    "chartType": { "type": "enum", "default": null, "options": ["groupedBar", "bar", "lollipop", "waterfall", "table", "lineChart", "areaChart", "varianceBar", "variancePin", "varianceWaterfall"], "description": "Render type. Allowed values depend on the measure category; an invalid choice is skipped with a warning." },
+                    "axis": { "type": "enum", "default": null, "options": ["yAxis1", "yAxis2", "yAxis3", "yAxis4", "yAxis5", "yAxis6", "none"], "description": "Y-axis assignment. Multi-axis (MAC) charts only; ignored with a warning otherwise. Setting yAxis2 also enables the secondary axis." }
+                }
+            }
+        },
+        "updatePatterns": {
+            "reorderMeasures": {
+                "intent": "Reorder the measures (values illustrative)",
+                "patch": { "order": ["Budget", "Sales", "Forecast"] }
+            },
+            "hideMeasure": {
+                "intent": "Hide a measure's series",
+                "patch": { "measures": { "Forecast": { "show": false } } }
+            },
+            "changePlotType": {
+                "intent": "Plot one measure as a line and another as grouped bars",
+                "patch": { "measures": { "Sales": { "chartType": "lineChart" }, "Budget": { "chartType": "groupedBar" } } }
+            },
+            "moveToSecondaryAxis": {
+                "intent": "Move a measure onto the secondary axis",
+                "patch": { "measures": { "Growth %": { "axis": "yAxis2" } } }
+            }
+        }
+    }
+]

package/dist/knowledge/index.d.ts

@@ -0,0 +1,10 @@
+import type { TKbDocumentList } from '../types';
+/** scope=base documents (dashboard/report/page level). */
+export declare const BASE_KNOWLEDGE: TKbDocumentList;
+/** visualType=CHART documents (axis/canvas/legend/dataLabel/measureSeries). */
+export declare const CHART_KNOWLEDGE: TKbDocumentList;
+/** Remaining scope=visual documents (common envelope, matrix/superFilter/secondary, native box/shape/navigator/text). */
+export declare const VISUAL_KNOWLEDGE: TKbDocumentList;
+/** Combined, index-ready curated schema knowledge: one document per schema section. */
+declare const knowledge: TKbDocumentList;
+export default knowledge;

package/dist/knowledge/index.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get BASE_KNOWLEDGE () {
+        return BASE_KNOWLEDGE;
+    },
+    get CHART_KNOWLEDGE () {
+        return CHART_KNOWLEDGE;
+    },
+    get VISUAL_KNOWLEDGE () {
+        return VISUAL_KNOWLEDGE;
+    },
+    get default () {
+        return _default;
+    }
+});
+const _basejson = /*#__PURE__*/ _interop_require_default(require("./base.json"));
+const _chartjson = /*#__PURE__*/ _interop_require_default(require("./chart.json"));
+const _visualjson = /*#__PURE__*/ _interop_require_default(require("./visual.json"));
+function _interop_require_default(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+const BASE_KNOWLEDGE = _basejson.default;
+const CHART_KNOWLEDGE = _chartjson.default;
+const VISUAL_KNOWLEDGE = _visualjson.default;
+/** Combined, index-ready curated schema knowledge: one document per schema section. */ const knowledge = [
+    ..._basejson.default,
+    ..._chartjson.default,
+    ..._visualjson.default
+];
+const _default = knowledge;