@aglyn/aglyn 1.0.0-beta.217 → 1.0.0-beta.219

package/src/lib/foundation/definitions/components.types.d.ts

@@ -297,7 +297,7 @@ export declare enum FieldComponentType {
     /**
      * Select listing the model fields of the nearest ancestor node's chosen
      * dataset (AGL-556): the editor resolves options from
-     * EntityPickerContext.datasetFields using the ancestor's `datasetId`
+     * EntityPickerContext.entityFields using the ancestor's `datasetId`
      * (or legacy `datasetName` matched by label) and persists the stable
      * model fieldId — field renames never break the mapping.
      */

package/src/lib/foundation/definitions/components.types.js

@@ -128,7 +128,7 @@ export var FieldComponentType = /*#__PURE__*/ function(FieldComponentType) {
     /**
    * Select listing the model fields of the nearest ancestor node's chosen
    * dataset (AGL-556): the editor resolves options from
-   * EntityPickerContext.datasetFields using the ancestor's `datasetId`
+   * EntityPickerContext.entityFields using the ancestor's `datasetId`
    * (or legacy `datasetName` matched by label) and persists the stable
    * model fieldId — field renames never break the mapping.
    */ FieldComponentType["DATASET_FIELD_SELECT"] = "dataset-field-select";

package/src/lib/foundation/definitions/components.types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/aglyn/src/lib/foundation/definitions/components.types.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  ConditionDefinition,\n  DataType,\n  Validator,\n} from '@data-driven-forms/react-form-renderer'\nimport type {\n  FieldActions,\n  ResolvePropsFunction,\n} from '@data-driven-forms/react-form-renderer/common-types'\nimport type { SvgIconProps } from '@mui/material'\nimport type { MuiStyledOptions } from '@mui/system/createStyled'\nimport type { CANVAS_ROOT_ELEMENT_ID } from '../constants/canvas'\nimport type { ComponentCategory } from '../constants/components'\nimport type { FEATURE_FLAG, RICH_TEXT_COMMANDS } from '../constants/shared'\nimport type { AGLYN_OF, SYMBOL_TYPE } from '../constants/symbol'\n\nexport enum LinealDirectiveFlag {\n  LIMIT_TO = 'limitedTo',\n  DISALLOW = 'forbid',\n}\n\nexport type BundleId = string\nexport type PluginId = string\nexport type ComponentId = string\nexport type PresetId = string\nexport type NodeId = string\n\nexport type ComponentsLinealOrder = [\n  directiveType: LinealDirectiveFlag,\n  directiveDefinition:\n    | Array<ComponentId>\n    | { plugins?: Array<PluginId>; components: Array<ComponentId> }\n    | { plugins: Array<PluginId>; components?: Array<ComponentId> },\n]\n\nexport type AglynNodeItemDenormalized<P = JSX.AnyProps> = AglynNodeSchema<P> & {\n  nodes?: AglynNodeItemDenormalized[]\n}\n\nexport type AglynNodesList = Array<AglynNodeItemDenormalized>\n\nexport type AglynNodeHierarchy<$ID extends NodeId = NodeId> = [\n  root: CANVAS_ROOT_ELEMENT_ID,\n  ...nodes: [...ancestors: NodeId[], element: $ID],\n]\n\nexport interface AglynExoticComponent<PROPS = any, REF = any>\n  extends JSX.ForwardRefExoticComponent<\n    JSX.PropsWithoutRef<PROPS> & JSX.RefAttributes<REF>\n  > {\n  [AGLYN_OF]?: SYMBOL_TYPE\n  aglyn?: boolean\n  schema?: AglynComponentSchema<PROPS>\n}\n\nexport interface AglynComponentSchema<P = any> {\n  $id: ComponentId\n  pluginId?: BundleId\n  kind?: 'element' | 'plaintext' | 'markdown'\n\n  displayName: string\n  title?: string\n  subtitle?: string\n  description?: string\n\n  /**\n   * Icon props for display around besigner\n   */\n  icon?: SvgIconProps\n  /**\n   * Options to be passed to styled(Component, \\{...styledOptions\\})\n   */\n  styledOptions?: MuiStyledOptions\n\n  /**\n   * Define a limitation for nodes allowed as direct descendents\n   */\n  restrictChildren?: ComponentsLinealOrder\n  /**\n   * Define a limitation for nodes allowed to be direct ancestors\n   */\n  restrictParent?: ComponentsLinealOrder\n\n  /**\n   * Filter props\n   */\n  resolveProps?: JSX.ResolveProps<AglynNodeItemDenormalized<P>>\n\n  /**\n   * Attribute fields to modify the contextual properties\n   * New version\n   */\n  attributes?: AglynAttributeSchema[]\n\n  /**\n   * Which groups of formatting the inline rich-text toolbar offers for this\n   * component (AGL-2557). Read only where `flags.richTextEditable` is on.\n   *\n   * Omitted means every group, which is what leaves Typography exactly as it\n   * was. Naming a subset narrows the toolbar AND the commit: a surface that\n   * offers neither lists nor links is phrasing-only, and the sanitizer holds\n   * it to that whatever an author pastes in.\n   */\n  richTextCommands?: RICH_TEXT_COMMANDS[]\n\n  /**\n   * Feature flags\n   */\n  flags?: {\n    /**\n     * Disable the use of emotion styled\n     */\n    emotion?: FEATURE_FLAG\n    /**\n     * Can the nodes of this component type be cloned?\n     */\n    cloning?: FEATURE_FLAG\n    /**\n     * Allow dragging nodes of this component type\n     */\n    dragging?: FEATURE_FLAG\n    /**\n     * Allow dropping nodes inside nodes of this component type\n     */\n    dropping?: FEATURE_FLAG\n    /**\n     * Allow editing element attributes of this component type\n     */\n    editing?: FEATURE_FLAG\n    /**\n     * Allow removing nodes of this component type\n     */\n    removing?: FEATURE_FLAG\n    /**\n     * Describe nodes of this component type to be self-closing\n     */\n    selfClosing?: FEATURE_FLAG\n    /**\n     * Component renders its `children` prop as text content the editor may\n     * edit directly (Attributes \"Text\" field, inline canvas editing).\n     */\n    textEditable?: FEATURE_FLAG\n    /**\n     * Component also accepts basic rich text (AGL-54): sanitized HTML in the\n     * `html` prop with `children` as the plain-text fallback.\n     */\n    richTextEditable?: FEATURE_FLAG\n    /**\n     * Component reads its children POSITIONALLY (AGL-1237), so the renderer\n     * must hand it one React child per node child instead of the single\n     * `<Branch>` element it normally passes.\n     *\n     * MUI's Accordion does `const [summary, ...rest] = Children.toArray(children)`,\n     * and `toArray` does not traverse into an element — so with the default\n     * wrapping the summary swallowed the whole subtree and the Collapse got\n     * nothing. Every accordion on every published site expanded to reveal an\n     * empty panel while its content rendered unconditionally inside the\n     * summary's `<h3>`.\n     *\n     * Opt in only for components with this contract; the wrapper is what\n     * keeps the Branch/Stem/Leaf seam swappable for everything else.\n     */\n    positionalChildren?: FEATURE_FLAG\n  }\n\n  /**\n   * Preset items are the available items to add to the canvas\n   */\n  presets?: AglynNodePresetSchema[]\n}\n\nexport type NodePresetData = Omit<AglynNodeSchema, '$id' | 'nodes'> & {\n  $id?: NodeId\n  nodes?: NodePresetData[]\n}\n\nexport type AglynNodePresetSchema = {\n  $id: PresetId\n  label: string\n  componentId?: ComponentId\n  pluginId?: BundleId\n  description?: string\n  icon?: SvgIconProps\n  category?: string | ComponentCategory\n  data: NodePresetData\n}\n\nexport enum FieldComponentType {\n  /**\n   * Per-breakpoint span editor (AGL-2486): a small row of breakpoint\n   * controls (All / xs / sm / md / lg / xl), each offering a column count\n   * plus MUI's `auto` and `grow` keywords. The persisted prop is still ONE\n   * string in the syntax the Grid element already parses (`\"6\"`, `\"auto\"`,\n   * `\"xs:12 md:6\"`) — this is an input affordance, not a shape change, so\n   * renderers and existing documents stay untouched. A value the row cannot\n   * model (a `{{token}}`, an unknown breakpoint) falls back to free text\n   * rather than being clobbered.\n   */\n  BREAKPOINT_SPAN = 'breakpoint-span',\n  BUTTON = 'button',\n  BUTTON_GROUP = 'button-group',\n  CHECKBOX = 'checkbox',\n  COLOR_PICKER = 'color-picker',\n  /**\n   * Border editor (AGL-2486): a thickness box plus a plain-English line-style\n   * picker (solid / dashed / dotted / double / no line). The persisted prop is\n   * still ONE CSS shorthand string (`\"1px solid\"`, `\"none\"`, `\"\"`), so\n   * renderers and existing documents stay untouched. A value the pair cannot\n   * model (`thin solid`, `1px solid #f00`, a binding token) falls back to free\n   * text rather than being clobbered, and flips back the moment the text is a\n   * plain `<width> <style>` again.\n   */\n  CSS_BORDER = 'css-border',\n  /**\n   * CSS length editor (AGL-1219): a number box plus a unit picker sharing\n   * the styles panel's unit list. The persisted prop is still ONE CSS\n   * string (`\"920px\"`, `\"100%\"`, `\"auto\"`, `\"\"`) — this is an input\n   * affordance, not a shape change, so renderers stay untouched. Values\n   * the picker can't model (`calc(…)`, a binding token) fall back to free\n   * text rather than being clobbered.\n   */\n  CSS_DIMENSION = 'css-dimension',\n  /**\n   * Background fill editor (AGL-1331): a fill-type switch (default / solid\n   * / linear / radial) over an angle box and a colour-stop list, each stop\n   * bindable to a palette token or a literal. The persisted prop is ONE CSS\n   * string under `backgroundImage` — a solid fill writes the explicit\n   * keyword `none` and leaves `backgroundColor` to do the job, while the\n   * default choice writes nothing at all (AGL-1338: the two differ on a\n   * component instance, where absence means \"keep the component's fill\") —\n   * so renderers stay untouched. Values\n   * the editor cannot model (`conic-gradient`, `to bottom right`, a stacked\n   * image list) fall back to free text rather than being clobbered.\n   */\n  CSS_GRADIENT = 'css-gradient',\n  /**\n   * Row-and-column grid editor for the Table element (AGL-2543).\n   *\n   * The persisted prop is still ONE string — pipe-delimited rows with the\n   * markdown divider carrying per-column alignment — so the renderer and\n   * existing documents stay untouched, and a comparison table already\n   * authored inside a Markdown element pastes straight in. This is the\n   * affordance that makes the element no-code: without it an author edits\n   * pipe syntax, which is the audience the besigner exists to spare.\n   */\n  DATA_TABLE = 'data-table',\n  DATE_PICKER = 'date-picker',\n  DUAL_LIST_SELECT = 'dual-list-select',\n  FIELD_ARRAY = 'field-array',\n  ICON_PICKER = 'icon-picker',\n  /**\n   * markdown-lite document editor (AGL-1616): the WYSIWYG the console\n   * already ships for blog entries and marketplace listings, rendered as the\n   * attribute's field. The persisted prop is still ONE markdown-lite string,\n   * so every renderer stays untouched — this is an input affordance, not a\n   * shape change. Declared by an attribute whose value is a whole document\n   * rather than a line of text; a plain TEXTAREA meant the Privacy Policy\n   * body was edited as a 13 KB raw paste (AGL-1594).\n   */\n  MARKDOWN = 'markdown',\n  INPUT_ADDON_BUTTON_GROUP = 'input-addon-button-group',\n  INPUT_ADDON_GROUP = 'input-addon-group',\n  PLAIN_TEXT = 'plain-text',\n  /**\n   * Named-preset picker with a raw escape hatch (AGL-2486): the theme's own\n   * answers first, then plain-English presets that PREVIEW themselves, then\n   * Custom…. The persisted prop is whatever the property already stored — a\n   * number where a bare number is a theme multiple, a CSS string otherwise —\n   * and a stored value matching no preset opens the field in its custom state\n   * holding that value rather than dropping it.\n   */\n  PRESET_CHOICE = 'preset-choice',\n  RADIO = 'radio',\n  /**\n   * Select listing the host's screens; the editor resolves the options from\n   * the host routing map at render time and writes the chosen screen id.\n   */\n  SCREEN_SELECT = 'screen-select',\n  /**\n   * Select listing the canvas's other elements (AGL-557): the editor\n   * resolves options from the live canvas at edit time and persists the\n   * node id — e.g. the form's reveal-on-submit target.\n   */\n  NODE_SELECT = 'node-select',\n  /**\n   * Id-based entity pickers (AGL-343/344): the editor resolves options\n   * from EntityPickerContext at edit time and persists the entity id —\n   * renames never break the reference.\n   */\n  /**\n   * Select listing the plugins installed for this site (AGL-1030): the editor\n   * resolves options from the install set the console publishes and persists\n   * the listing id. A picker rather than a typed document id — the same reason\n   * every other reference in the designer is one, and here it also removes the\n   * \"is this installed?\" question by construction.\n   */\n  PLUGIN_SELECT = 'plugin-select',\n  /**\n   * A placed plugin's declared settings, rendered as real fields (AGL-1049).\n   * Reads the sibling plugin selection to know which manifest to offer.\n   */\n  PLUGIN_SETTINGS = 'plugin-settings',\n  PRODUCT_SELECT = 'product-select',\n  COLLECTION_SELECT = 'collection-select',\n  CATEGORY_SELECT = 'category-select',\n  DATASET_SELECT = 'dataset-select',\n  /**\n   * Select listing the model fields of the nearest ancestor node's chosen\n   * dataset (AGL-556): the editor resolves options from\n   * EntityPickerContext.datasetFields using the ancestor's `datasetId`\n   * (or legacy `datasetName` matched by label) and persists the stable\n   * model fieldId — field renames never break the mapping.\n   */\n  DATASET_FIELD_SELECT = 'dataset-field-select',\n  /**\n   * Select listing the host's form entities (`docs/specs/reusable-forms.md`\n   * §2c): the editor resolves options from EntityPickerContext.forms and\n   * persists the form id. The same id-first reasoning as every picker in this\n   * family, and here it is load-bearing rather than convenient — the string\n   * it replaces was the form's whole identity, so a rename split the\n   * submission history it named.\n   */\n  FORM_SELECT = 'form-select',\n  SELECT = 'select',\n  SLIDER = 'slider',\n  SUB_FORM = 'sub-form',\n  SWITCH = 'switch',\n  TAB_ITEM = 'tab-item',\n  TABS = 'tabs',\n  TEXT_FIELD = 'text-field',\n  TEXTAREA = 'textarea',\n  /**\n   * Theme-scale combo box (AGL-2486): offers the THEME's own scale for a\n   * property — `theme.typography` for font size and weight,\n   * `theme.zIndex` for stacking — while still accepting any raw value\n   * (`18px`, `1.25rem`, `700`, `1400`), because arbitrary values are\n   * legitimate. The persisted value is a theme token PATH\n   * (`h4.fontSize`, `fontWeightBold`, `appBar`), which MUI's sx system\n   * resolves against the active theme exactly as it resolves\n   * `color: 'primary.main'` — so the element keeps following the theme\n   * instead of freezing the number it had when it was styled.\n   */\n  THEME_SCALE = 'theme-scale',\n  TIME_PICKER = 'time-picker',\n  TOGGLE_BUTTON = 'toggle-button',\n  WIZARD = 'wizard',\n}\n\nexport enum FieldValidatorType {\n  EXACT_LENGTH = 'exact-length',\n  MAX_LENGTH = 'max-length',\n  MAX_NUMBER_VALUE = 'max-number-value',\n  MIN_ITEMS = 'min-items',\n  MIN_LENGTH = 'min-length',\n  MIN_NUMBER_VALUE = 'min-number-value',\n  PATTERN = 'pattern',\n  REQUIRED = 'required',\n  URL = 'url',\n}\n\nexport type FieldDataType =\n  | 'boolean'\n  | 'float'\n  | 'integer'\n  | 'number'\n  | 'string'\n\nexport interface AglynAttributeSchema extends Dictionary<any> {\n  name: string\n  dataType?: DataType\n  component: string | FieldComponentType\n  validate?: Validator[]\n  condition?: ConditionDefinition | ConditionDefinition[]\n  initializeOnMount?: boolean\n  initialValue?: unknown\n  clearedValue?: unknown\n  clearOnUnmount?: boolean\n  actions?: FieldActions\n  resolveProps?: ResolvePropsFunction\n  description?: string\n}\n\nexport interface AglynNodeSchema<P = JSX.AnyProps> {\n  $id: NodeId\n  componentId: ComponentId\n  pluginId?: BundleId\n  parentId?: NodeId\n  sx?: JSX.SxProps\n  props?: P\n  nodes?: NodeId[] | AglynNodeSchema[]\n}\n"],"names":["LinealDirectiveFlag","FieldComponentType","FieldValidatorType"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAkBD,OAAO,IAAA,AAAKA,6CAAAA;;;WAAAA;MAGX;AAwKD,OAAO,IAAA,AAAKC,4CAAAA;IACV;;;;;;;;;GASC;;;;;IAMD;;;;;;;;GAQC;IAED;;;;;;;GAOC;IAED;;;;;;;;;;;GAWC;IAED;;;;;;;;;GASC;;;;;IAMD;;;;;;;;GAQC;;;;IAKD;;;;;;;GAOC;;IAGD;;;GAGC;IAED;;;;GAIC;IAED;;;;GAIC,GACD;;;;;;GAMC;IAED;;;GAGC;;;;;IAMD;;;;;;GAMC;IAED;;;;;;;GAOC;;;;;;;;;IAUD;;;;;;;;;;GAUC;;;;WA1JSA;MA+JX;AAED,OAAO,IAAA,AAAKC,4CAAAA;;;;;;;;;;WAAAA;MAUX"}
+{"version":3,"sources":["../../../../../../../libs/aglyn/src/lib/foundation/definitions/components.types.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  ConditionDefinition,\n  DataType,\n  Validator,\n} from '@data-driven-forms/react-form-renderer'\nimport type {\n  FieldActions,\n  ResolvePropsFunction,\n} from '@data-driven-forms/react-form-renderer/common-types'\nimport type { SvgIconProps } from '@mui/material'\nimport type { MuiStyledOptions } from '@mui/system/createStyled'\nimport type { CANVAS_ROOT_ELEMENT_ID } from '../constants/canvas'\nimport type { ComponentCategory } from '../constants/components'\nimport type { FEATURE_FLAG, RICH_TEXT_COMMANDS } from '../constants/shared'\nimport type { AGLYN_OF, SYMBOL_TYPE } from '../constants/symbol'\n\nexport enum LinealDirectiveFlag {\n  LIMIT_TO = 'limitedTo',\n  DISALLOW = 'forbid',\n}\n\nexport type BundleId = string\nexport type PluginId = string\nexport type ComponentId = string\nexport type PresetId = string\nexport type NodeId = string\n\nexport type ComponentsLinealOrder = [\n  directiveType: LinealDirectiveFlag,\n  directiveDefinition:\n    | Array<ComponentId>\n    | { plugins?: Array<PluginId>; components: Array<ComponentId> }\n    | { plugins: Array<PluginId>; components?: Array<ComponentId> },\n]\n\nexport type AglynNodeItemDenormalized<P = JSX.AnyProps> = AglynNodeSchema<P> & {\n  nodes?: AglynNodeItemDenormalized[]\n}\n\nexport type AglynNodesList = Array<AglynNodeItemDenormalized>\n\nexport type AglynNodeHierarchy<$ID extends NodeId = NodeId> = [\n  root: CANVAS_ROOT_ELEMENT_ID,\n  ...nodes: [...ancestors: NodeId[], element: $ID],\n]\n\nexport interface AglynExoticComponent<PROPS = any, REF = any>\n  extends JSX.ForwardRefExoticComponent<\n    JSX.PropsWithoutRef<PROPS> & JSX.RefAttributes<REF>\n  > {\n  [AGLYN_OF]?: SYMBOL_TYPE\n  aglyn?: boolean\n  schema?: AglynComponentSchema<PROPS>\n}\n\nexport interface AglynComponentSchema<P = any> {\n  $id: ComponentId\n  pluginId?: BundleId\n  kind?: 'element' | 'plaintext' | 'markdown'\n\n  displayName: string\n  title?: string\n  subtitle?: string\n  description?: string\n\n  /**\n   * Icon props for display around besigner\n   */\n  icon?: SvgIconProps\n  /**\n   * Options to be passed to styled(Component, \\{...styledOptions\\})\n   */\n  styledOptions?: MuiStyledOptions\n\n  /**\n   * Define a limitation for nodes allowed as direct descendents\n   */\n  restrictChildren?: ComponentsLinealOrder\n  /**\n   * Define a limitation for nodes allowed to be direct ancestors\n   */\n  restrictParent?: ComponentsLinealOrder\n\n  /**\n   * Filter props\n   */\n  resolveProps?: JSX.ResolveProps<AglynNodeItemDenormalized<P>>\n\n  /**\n   * Attribute fields to modify the contextual properties\n   * New version\n   */\n  attributes?: AglynAttributeSchema[]\n\n  /**\n   * Which groups of formatting the inline rich-text toolbar offers for this\n   * component (AGL-2557). Read only where `flags.richTextEditable` is on.\n   *\n   * Omitted means every group, which is what leaves Typography exactly as it\n   * was. Naming a subset narrows the toolbar AND the commit: a surface that\n   * offers neither lists nor links is phrasing-only, and the sanitizer holds\n   * it to that whatever an author pastes in.\n   */\n  richTextCommands?: RICH_TEXT_COMMANDS[]\n\n  /**\n   * Feature flags\n   */\n  flags?: {\n    /**\n     * Disable the use of emotion styled\n     */\n    emotion?: FEATURE_FLAG\n    /**\n     * Can the nodes of this component type be cloned?\n     */\n    cloning?: FEATURE_FLAG\n    /**\n     * Allow dragging nodes of this component type\n     */\n    dragging?: FEATURE_FLAG\n    /**\n     * Allow dropping nodes inside nodes of this component type\n     */\n    dropping?: FEATURE_FLAG\n    /**\n     * Allow editing element attributes of this component type\n     */\n    editing?: FEATURE_FLAG\n    /**\n     * Allow removing nodes of this component type\n     */\n    removing?: FEATURE_FLAG\n    /**\n     * Describe nodes of this component type to be self-closing\n     */\n    selfClosing?: FEATURE_FLAG\n    /**\n     * Component renders its `children` prop as text content the editor may\n     * edit directly (Attributes \"Text\" field, inline canvas editing).\n     */\n    textEditable?: FEATURE_FLAG\n    /**\n     * Component also accepts basic rich text (AGL-54): sanitized HTML in the\n     * `html` prop with `children` as the plain-text fallback.\n     */\n    richTextEditable?: FEATURE_FLAG\n    /**\n     * Component reads its children POSITIONALLY (AGL-1237), so the renderer\n     * must hand it one React child per node child instead of the single\n     * `<Branch>` element it normally passes.\n     *\n     * MUI's Accordion does `const [summary, ...rest] = Children.toArray(children)`,\n     * and `toArray` does not traverse into an element — so with the default\n     * wrapping the summary swallowed the whole subtree and the Collapse got\n     * nothing. Every accordion on every published site expanded to reveal an\n     * empty panel while its content rendered unconditionally inside the\n     * summary's `<h3>`.\n     *\n     * Opt in only for components with this contract; the wrapper is what\n     * keeps the Branch/Stem/Leaf seam swappable for everything else.\n     */\n    positionalChildren?: FEATURE_FLAG\n  }\n\n  /**\n   * Preset items are the available items to add to the canvas\n   */\n  presets?: AglynNodePresetSchema[]\n}\n\nexport type NodePresetData = Omit<AglynNodeSchema, '$id' | 'nodes'> & {\n  $id?: NodeId\n  nodes?: NodePresetData[]\n}\n\nexport type AglynNodePresetSchema = {\n  $id: PresetId\n  label: string\n  componentId?: ComponentId\n  pluginId?: BundleId\n  description?: string\n  icon?: SvgIconProps\n  category?: string | ComponentCategory\n  data: NodePresetData\n}\n\nexport enum FieldComponentType {\n  /**\n   * Per-breakpoint span editor (AGL-2486): a small row of breakpoint\n   * controls (All / xs / sm / md / lg / xl), each offering a column count\n   * plus MUI's `auto` and `grow` keywords. The persisted prop is still ONE\n   * string in the syntax the Grid element already parses (`\"6\"`, `\"auto\"`,\n   * `\"xs:12 md:6\"`) — this is an input affordance, not a shape change, so\n   * renderers and existing documents stay untouched. A value the row cannot\n   * model (a `{{token}}`, an unknown breakpoint) falls back to free text\n   * rather than being clobbered.\n   */\n  BREAKPOINT_SPAN = 'breakpoint-span',\n  BUTTON = 'button',\n  BUTTON_GROUP = 'button-group',\n  CHECKBOX = 'checkbox',\n  COLOR_PICKER = 'color-picker',\n  /**\n   * Border editor (AGL-2486): a thickness box plus a plain-English line-style\n   * picker (solid / dashed / dotted / double / no line). The persisted prop is\n   * still ONE CSS shorthand string (`\"1px solid\"`, `\"none\"`, `\"\"`), so\n   * renderers and existing documents stay untouched. A value the pair cannot\n   * model (`thin solid`, `1px solid #f00`, a binding token) falls back to free\n   * text rather than being clobbered, and flips back the moment the text is a\n   * plain `<width> <style>` again.\n   */\n  CSS_BORDER = 'css-border',\n  /**\n   * CSS length editor (AGL-1219): a number box plus a unit picker sharing\n   * the styles panel's unit list. The persisted prop is still ONE CSS\n   * string (`\"920px\"`, `\"100%\"`, `\"auto\"`, `\"\"`) — this is an input\n   * affordance, not a shape change, so renderers stay untouched. Values\n   * the picker can't model (`calc(…)`, a binding token) fall back to free\n   * text rather than being clobbered.\n   */\n  CSS_DIMENSION = 'css-dimension',\n  /**\n   * Background fill editor (AGL-1331): a fill-type switch (default / solid\n   * / linear / radial) over an angle box and a colour-stop list, each stop\n   * bindable to a palette token or a literal. The persisted prop is ONE CSS\n   * string under `backgroundImage` — a solid fill writes the explicit\n   * keyword `none` and leaves `backgroundColor` to do the job, while the\n   * default choice writes nothing at all (AGL-1338: the two differ on a\n   * component instance, where absence means \"keep the component's fill\") —\n   * so renderers stay untouched. Values\n   * the editor cannot model (`conic-gradient`, `to bottom right`, a stacked\n   * image list) fall back to free text rather than being clobbered.\n   */\n  CSS_GRADIENT = 'css-gradient',\n  /**\n   * Row-and-column grid editor for the Table element (AGL-2543).\n   *\n   * The persisted prop is still ONE string — pipe-delimited rows with the\n   * markdown divider carrying per-column alignment — so the renderer and\n   * existing documents stay untouched, and a comparison table already\n   * authored inside a Markdown element pastes straight in. This is the\n   * affordance that makes the element no-code: without it an author edits\n   * pipe syntax, which is the audience the besigner exists to spare.\n   */\n  DATA_TABLE = 'data-table',\n  DATE_PICKER = 'date-picker',\n  DUAL_LIST_SELECT = 'dual-list-select',\n  FIELD_ARRAY = 'field-array',\n  ICON_PICKER = 'icon-picker',\n  /**\n   * markdown-lite document editor (AGL-1616): the WYSIWYG the console\n   * already ships for blog entries and marketplace listings, rendered as the\n   * attribute's field. The persisted prop is still ONE markdown-lite string,\n   * so every renderer stays untouched — this is an input affordance, not a\n   * shape change. Declared by an attribute whose value is a whole document\n   * rather than a line of text; a plain TEXTAREA meant the Privacy Policy\n   * body was edited as a 13 KB raw paste (AGL-1594).\n   */\n  MARKDOWN = 'markdown',\n  INPUT_ADDON_BUTTON_GROUP = 'input-addon-button-group',\n  INPUT_ADDON_GROUP = 'input-addon-group',\n  PLAIN_TEXT = 'plain-text',\n  /**\n   * Named-preset picker with a raw escape hatch (AGL-2486): the theme's own\n   * answers first, then plain-English presets that PREVIEW themselves, then\n   * Custom…. The persisted prop is whatever the property already stored — a\n   * number where a bare number is a theme multiple, a CSS string otherwise —\n   * and a stored value matching no preset opens the field in its custom state\n   * holding that value rather than dropping it.\n   */\n  PRESET_CHOICE = 'preset-choice',\n  RADIO = 'radio',\n  /**\n   * Select listing the host's screens; the editor resolves the options from\n   * the host routing map at render time and writes the chosen screen id.\n   */\n  SCREEN_SELECT = 'screen-select',\n  /**\n   * Select listing the canvas's other elements (AGL-557): the editor\n   * resolves options from the live canvas at edit time and persists the\n   * node id — e.g. the form's reveal-on-submit target.\n   */\n  NODE_SELECT = 'node-select',\n  /**\n   * Id-based entity pickers (AGL-343/344): the editor resolves options\n   * from EntityPickerContext at edit time and persists the entity id —\n   * renames never break the reference.\n   */\n  /**\n   * Select listing the plugins installed for this site (AGL-1030): the editor\n   * resolves options from the install set the console publishes and persists\n   * the listing id. A picker rather than a typed document id — the same reason\n   * every other reference in the designer is one, and here it also removes the\n   * \"is this installed?\" question by construction.\n   */\n  PLUGIN_SELECT = 'plugin-select',\n  /**\n   * A placed plugin's declared settings, rendered as real fields (AGL-1049).\n   * Reads the sibling plugin selection to know which manifest to offer.\n   */\n  PLUGIN_SETTINGS = 'plugin-settings',\n  PRODUCT_SELECT = 'product-select',\n  COLLECTION_SELECT = 'collection-select',\n  CATEGORY_SELECT = 'category-select',\n  DATASET_SELECT = 'dataset-select',\n  /**\n   * Select listing the model fields of the nearest ancestor node's chosen\n   * dataset (AGL-556): the editor resolves options from\n   * EntityPickerContext.entityFields using the ancestor's `datasetId`\n   * (or legacy `datasetName` matched by label) and persists the stable\n   * model fieldId — field renames never break the mapping.\n   */\n  DATASET_FIELD_SELECT = 'dataset-field-select',\n  /**\n   * Select listing the host's form entities (`docs/specs/reusable-forms.md`\n   * §2c): the editor resolves options from EntityPickerContext.forms and\n   * persists the form id. The same id-first reasoning as every picker in this\n   * family, and here it is load-bearing rather than convenient — the string\n   * it replaces was the form's whole identity, so a rename split the\n   * submission history it named.\n   */\n  FORM_SELECT = 'form-select',\n  SELECT = 'select',\n  SLIDER = 'slider',\n  SUB_FORM = 'sub-form',\n  SWITCH = 'switch',\n  TAB_ITEM = 'tab-item',\n  TABS = 'tabs',\n  TEXT_FIELD = 'text-field',\n  TEXTAREA = 'textarea',\n  /**\n   * Theme-scale combo box (AGL-2486): offers the THEME's own scale for a\n   * property — `theme.typography` for font size and weight,\n   * `theme.zIndex` for stacking — while still accepting any raw value\n   * (`18px`, `1.25rem`, `700`, `1400`), because arbitrary values are\n   * legitimate. The persisted value is a theme token PATH\n   * (`h4.fontSize`, `fontWeightBold`, `appBar`), which MUI's sx system\n   * resolves against the active theme exactly as it resolves\n   * `color: 'primary.main'` — so the element keeps following the theme\n   * instead of freezing the number it had when it was styled.\n   */\n  THEME_SCALE = 'theme-scale',\n  TIME_PICKER = 'time-picker',\n  TOGGLE_BUTTON = 'toggle-button',\n  WIZARD = 'wizard',\n}\n\nexport enum FieldValidatorType {\n  EXACT_LENGTH = 'exact-length',\n  MAX_LENGTH = 'max-length',\n  MAX_NUMBER_VALUE = 'max-number-value',\n  MIN_ITEMS = 'min-items',\n  MIN_LENGTH = 'min-length',\n  MIN_NUMBER_VALUE = 'min-number-value',\n  PATTERN = 'pattern',\n  REQUIRED = 'required',\n  URL = 'url',\n}\n\nexport type FieldDataType =\n  | 'boolean'\n  | 'float'\n  | 'integer'\n  | 'number'\n  | 'string'\n\nexport interface AglynAttributeSchema extends Dictionary<any> {\n  name: string\n  dataType?: DataType\n  component: string | FieldComponentType\n  validate?: Validator[]\n  condition?: ConditionDefinition | ConditionDefinition[]\n  initializeOnMount?: boolean\n  initialValue?: unknown\n  clearedValue?: unknown\n  clearOnUnmount?: boolean\n  actions?: FieldActions\n  resolveProps?: ResolvePropsFunction\n  description?: string\n}\n\nexport interface AglynNodeSchema<P = JSX.AnyProps> {\n  $id: NodeId\n  componentId: ComponentId\n  pluginId?: BundleId\n  parentId?: NodeId\n  sx?: JSX.SxProps\n  props?: P\n  nodes?: NodeId[] | AglynNodeSchema[]\n}\n"],"names":["LinealDirectiveFlag","FieldComponentType","FieldValidatorType"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAkBD,OAAO,IAAA,AAAKA,6CAAAA;;;WAAAA;MAGX;AAwKD,OAAO,IAAA,AAAKC,4CAAAA;IACV;;;;;;;;;GASC;;;;;IAMD;;;;;;;;GAQC;IAED;;;;;;;GAOC;IAED;;;;;;;;;;;GAWC;IAED;;;;;;;;;GASC;;;;;IAMD;;;;;;;;GAQC;;;;IAKD;;;;;;;GAOC;;IAGD;;;GAGC;IAED;;;;GAIC;IAED;;;;GAIC,GACD;;;;;;GAMC;IAED;;;GAGC;;;;;IAMD;;;;;;GAMC;IAED;;;;;;;GAOC;;;;;;;;;IAUD;;;;;;;;;;GAUC;;;;WA1JSA;MA+JX;AAED,OAAO,IAAA,AAAKC,4CAAAA;;;;;;;;;;WAAAA;MAUX"}

package/src/lib/foundation/definitions/org-billing.types.d.ts

@@ -115,8 +115,6 @@ export interface CoreOrgFeatureFlags {
     removeBranding?: boolean;
     /** Schedule a version to publish at a date/time (tier above versioning). */
     scheduledPublishing?: boolean;
-    /** Sell listings on the marketplace marketplace (AGL-46). */
-    marketplaceSelling?: boolean;
     /** AI copy assist in the besigner (AGL-89). */
     aiAssist?: boolean;
     /**
@@ -228,20 +226,14 @@ export interface CoreOrgFeatureFlags {
     commerce?: boolean;
     /** Console point-of-sale mode (AGL-312). */
     pos?: boolean;
-    /** Recurring storefront subscription products (AGL-303). */
-    storefrontSubscriptions?: boolean;
     /** Entitlement-gated screens/sections/video paywalls (AGL-309). */
     contentGating?: boolean;
-    /** Gift cards & store credit (AGL-322). */
-    giftCards?: boolean;
     /** Verified-buyer product reviews (AGL-324). */
     productReviews?: boolean;
     /** Abandoned checkout recovery emails (AGL-323). */
     abandonedCart?: boolean;
     /** Dropship supplier routing on paid orders (AGL-289). */
     dropshipRouting?: boolean;
-    /** Commerce analytics dashboard (AGL-327). */
-    commerceAnalytics?: boolean;
     /**
      * White-label the platform (White-Label Phase 1): replace the Aglyn brand
      * — product name, logo, colors, support URL, transactional email from-name
@@ -272,11 +264,11 @@ export interface CoreOrgFeatureFlags {
  * {@link CoreOrgFeatureFlags} is the platform's own set — what
  * `PLAN_ENTITLEMENTS` declares for every plan, and what
  * `Required<CoreOrgFeatureFlags>` keeps exhaustive.
- * {@link PluginEntitlementFeatures} is the plugin half (AGL-3124): empty
- * until a plugin declares a gate of its own into it with `declare module`,
- * and resolved from that plugin's `registerPluginEntitlements` defaults
- * rather than from a row in a core plan table — which is why a plugin's gate
- * joins HERE and not above. Every reader keeps reading `OrgFeatureFlags`, and
+ * {@link PluginEntitlementFeatures} is the plugin half (AGL-3124): a plugin
+ * declares a gate of its own into it with `declare module`, and its answer
+ * per plan comes from that plugin's `plan-entitlements` declaration or its
+ * `registerPluginEntitlements` defaults rather than from a row core writes —
+ * which is why a plugin's gate joins HERE and not above. Every reader keeps reading `OrgFeatureFlags`, and
  * `keyof OrgFeatureFlags` admits a plugin's key the moment it is declared.
  */
 export interface OrgFeatureFlags extends CoreOrgFeatureFlags, PluginEntitlementFeatures {
@@ -463,8 +455,6 @@ export interface CoreOrgEntitlements {
     /** Hard per-site collaborator cap incl. addons (see `membersPerHost`). */
     maxMembersPerHost?: number;
     bandwidthGb?: number;
-    /** Form submissions accepted per calendar month (Forms & Lead Capture). */
-    formSubmissionsPerMonth?: number;
     /**
      * Saved form DEFINITIONS per host — documents under
      * `hosts/{hostId}/forms`, the entity a submission's `formId` points at.
@@ -488,8 +478,6 @@ export interface CoreOrgEntitlements {
     functionsPerHost?: number;
     /** Workflow builder cap (AGL-99/101). */
     workflowsPerHost?: number;
-    /** Event-triggered workflow runs per calendar month (AGL-165). */
-    workflowRunsPerMonth?: number;
     /** Bookable services per host (AGL-159). */
     servicesPerHost?: number;
     /** Redirect rules per host (AGL-154). */
@@ -505,48 +493,6 @@ export interface CoreOrgEntitlements {
      * and activities are not counted — see `CRM_ACTIVITIES_PER_RECORD_CEILING`.
      */
     contactsPerHost?: number;
-    /**
-     * One-to-one emails a workspace may send from CRM records per UTC day —
-     * the message a rep writes to one person from their contact page, as
-     * against a campaign (`emailSendsPerMonth`) or transactional mail.
-     *
-     * A HARD cap on every tier and a daily one, because it is the only send
-     * class a person can produce by hand at volume: a campaign is one act over
-     * a metered audience, and a receipt follows an order somebody paid for,
-     * but a rep with a template and a list can put a thousand messages onto
-     * the platform's sending reputation in an afternoon. The day boundary is
-     * what makes the cap a pace rather than a wall — tomorrow the count is
-     * zero again — and the number is sized so that every tier holds its
-     * margin with the whole day spent, which is the arithmetic the Drive
-     * pricing decision of 2026-09-05 records. `checkCrmEmailQuota` reads it;
-     * the counter it is enforced against is `orgs/{orgId}/crmEmailUsage/{day}`.
-     *
-     * Every send still counts on the org's `emailSends` cost meter, like any
-     * other message the provider charged for. 0 on Free, which has no CRM,
-     * and finite on every paid tier, Enterprise's 2,000 included.
-     *
-     * ## This ladder and `emailSendsPerMonth` are NOT the same ladder
-     *
-     * They answer to different principles, deliberately, and a tier's two
-     * numbers are not expected to look like each other. `emailSendsPerMonth`
-     * is sized against SHARED-DOMAIN REPUTATION: campaign mail is bulk on a
-     * pool every tier without its own verified sending domain rides under
-     * `p=reject`, so what one workspace sends is a cost every other workspace
-     * pays. This one is sized against COGS SHARE: one-to-one mail is a per-tier
-     * margin question, which is why it is a daily pace rather than a monthly
-     * band.
-     *
-     * The two are far apart at the entry tier — a band of 0 beside a real daily
-     * allowance — and that reads as an inconsistency until the principles are
-     * named. It is not one. One-to-one mail is addressed to a single person,
-     * usually inside a relationship the recipient started, and it reaches the
-     * provider through a per-user pace limit, both suppression lists, a
-     * `declined` consent basis as a hard stop, and an atomic daily reservation.
-     * Complaint rates on it are structurally unlike bulk. Reconciling the two
-     * ladders would price a reply to one customer as though it carried a
-     * campaign's reputation risk.
-     */
-    crmEmailsPerDay?: number;
     /**
      * CAMPAIGN emails sendable per calendar month (AGL-161), and campaign
      * emails only (AGL-1438).
@@ -567,47 +513,6 @@ export interface CoreOrgEntitlements {
      * are not meant to track each other.
      */
     emailSendsPerMonth?: number;
-    /**
-     * Aglyn Assist credits per calendar month — the band assist spends against.
-     *
-     * A CREDIT IS A UNIT OF MODEL COST, not a message. One assist action can
-     * cost two orders of magnitude more than another: a question is a few
-     * thousand tokens, while generating a screen carries the node tree, the
-     * component catalog and the theme tokens in, structured markup out, and
-     * iterates. A message allowance would price those the same, so one
-     * workspace's ten screen builds would outspend another's thousand questions
-     * and both would read as "within allowance".
-     *
-     * The unit is defined by `ASSIST_CREDIT_COST_USD` and the conversion lives
-     * in `assist-credits.ts`. Only that module turns credits into dollars;
-     * everything a customer sees counts credits, because the dollar figure
-     * behind them is our provider bill and not a price.
-     *
-     * ## HOW THE BAND IS SIZED, and why it is not a share of the price
-     *
-     * A credit is a dollar of provider spend at `ASSIST_CREDIT_COST_USD`, so
-     * the band IS a liability figure: the plan's whole assist give is
-     * `assistCreditsPerMonth / 1000` dollars. Credits past it are not a give —
-     * since AGL-2653 they are SOLD at `extraAssistCreditsUsdPer1k`, unless the
-     * org's `assistOverage.hardCap` asks `reserveAssistMessage` to refuse at
-     * the band instead. Sizing it as a share of the subscription price says
-     * nothing about whether the tier can afford it, because the price is also
-     * carrying storage, bandwidth, form submissions, dataset storage, API
-     * requests, contacts and email.
-     *
-     * So each band is sized against what those SEVEN other terms leave. Every
-     * paid band takes between a quarter and a third of that remainder, which
-     * keeps the tier's worst case positive and keeps the ladder's shape: the
-     * margin each tier holds at 100% of every band stays in proportion to what
-     * it held before assist was sold at all. `tier-margin-floor.spec.ts` is the
-     * model, and it pins both the rule and the resulting figures.
-     *
-     * 0 on Free and Starter, which carry no `aiAssist` and no band. The Aglyn
-     * AI add-on (AGL-2896) adds `AI_ADDON_CREDITS_PER_MONTH[plan]` to this
-     * band in `resolveOrgEntitlements` — one pool, widened, rather than a
-     * second meter — so Starter with the add-on carries a band after all.
-     */
-    assistCreditsPerMonth?: number;
     /** Action runs per calendar month (AGL-148). */
     actionRunsPerMonth?: number;
     /** Included customer REST API requests per calendar month (AGL-634);
@@ -639,13 +544,6 @@ export interface CoreOrgEntitlements {
     transactionFeePhysicalPct?: number;
     /** Platform fee % on digital storefront sales (Connect app fee). */
     transactionFeeDigitalPct?: number;
-    /**
-     * Platform take rate % on the org's MARKETPLACE listing sales (AGL-46,
-     * resolved from entitlements per AGL-1543): 20 on paid plans, 30 on
-     * free. Distinct from the storefront `transactionFee*Pct` above — this
-     * is Aglyn's cut of a marketplace sale, priced off the SELLER org.
-     */
-    marketplaceFeePct?: number;
     features?: OrgFeatureFlags;
     /**
      * A staff PLAN COMP (AGL-3034) — see `OrgPlanComp`. Not a quota: the
@@ -660,10 +558,10 @@ export interface CoreOrgEntitlements {
  *
  * {@link CoreOrgEntitlements} is what `PLAN_ENTITLEMENTS` declares per plan
  * and what `ResolvedOrgEntitlements` keeps exhaustive.
- * {@link PluginEntitlementQuotas} is the plugin half: empty until a plugin
- * declares a key of its own into it with `declare module` and registers it
- * with `registerPluginEntitlementKeys`, and resolved from that plugin's seat
- * add-on declaration rather than from a row in a core plan table. So
+ * {@link PluginEntitlementQuotas} is the plugin half: a plugin declares a
+ * key of its own into it with `declare module`, and its figure per plan comes
+ * from that plugin's `plan-entitlements` declaration, compiled into
+ * `PLAN_ENTITLEMENTS` (AGL-3080), widened by any seat add-on it declares. So
  * `resolveOrgEntitlements` carries a plugin's band, and `keyof
  * OrgEntitlements` admits its key, without this file naming the plugin's
  * domain.
@@ -1275,6 +1173,15 @@ export interface AglynOrgBilling extends AglynDocument {
     /** Staff suspension (AGL-202): set = all the org's sites serve 503. */
     suspendedAt?: ITimestamp | null;
     suspendedReason?: string;
+    /**
+     * Whether the suspension above is IN FORCE, stored so the staff
+     * Organizations list can filter by it with an equality (AGL-3416). `false`
+     * on every unsuspended org; written beside the `suspended*` family by the
+     * lockdown core and cleared on a lapsed timed lock by
+     * `settleLapsedSuspensions`. Never an enforcement input: every enforcing
+     * reader asks the family itself.
+     */
+    suspended?: boolean;
     /**
      * GDPR erasure request (AGL-206): hard deletion happens ONLY via `eraseOrg`
      * after a 7-day hold from this stamp — reached by the
@@ -1291,12 +1198,6 @@ export interface AglynOrgBilling extends AglynDocument {
     crm?: OrgCrmSettings;
     createdAt?: ITimestamp;
     updatedAt?: ITimestamp;
-    /**
-     * The workspace's email capture address (AGL-2657) — see `OrgCrmInbound`.
-     * Server-owned and member-readable: the token IS the address, so a client
-     * that could write it could point another workspace's mail here.
-     */
-    crmInbound?: OrgCrmInbound;
 }
 /**
  * What the CRM lets an organization decide for every site at once
@@ -1339,24 +1240,6 @@ export interface OrgCrmHostSettings {
      */
     defaultOwnerUid?: string;
 }
-/**
- * The workspace's email capture address, as the org document carries it
- * (AGL-2657): `crm+<token>@<capture domain>`.
- *
- * One token per organization, minted lazily by `crm/inbound-address` the
- * first time a member asks for the address, and replaced by the same route
- * on a rotation. Every site of the organization shares it: a captured
- * message is filed on the record that matches its correspondent, and the
- * record says which site it belongs to, so the address need not.
- */
-export interface OrgCrmInbound {
-    /** The url-safe secret in the local part; `crm+<token>@…`. */
-    token: string;
-    /** When the first token was minted, epoch ms. */
-    createdAtMs: number;
-    /** When the token was last replaced, epoch ms; absent until it has been. */
-    rotatedAtMs?: number;
-}
 /**
  * One assignment rule (AGL-2618): `when` every named condition holds for a
  * capture, `assign` the record this way. A condition left out is not a