@aglyn/shared-ui-jsx-forms 1.0.0-beta.143

package/src/lib/constants/flags.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export declare enum FieldComponentType {
+    /** Per-breakpoint span/offset row; persists one string (AGL-2486). */
+    BREAKPOINT_SPAN = "breakpoint-span",
+    BUTTON = "button",
+    CHECKBOX = "checkbox",
+    COLOR_PICKER = "color-picker",
+    /** Thickness + line style for a border shorthand; one string (AGL-2486). */
+    CSS_BORDER = "css-border",
+    /** Number + unit editor for a CSS length; persists one string (AGL-1219). */
+    CSS_DIMENSION = "css-dimension",
+    /** Fill type + angle + colour stops; persists one CSS string (AGL-1331). */
+    CSS_GRADIENT = "css-gradient",
+    /** Row-and-column grid for the Table element (AGL-2543). */
+    DATA_TABLE = "data-table",
+    DATE_PICKER = "date-picker",
+    DUAL_LIST_SELECT = "dual-list-select",
+    FIELD_ARRAY = "field-array",
+    ICON_PICKER = "icon-picker",
+    INPUT_ADDON_BUTTON_GROUP = "input-addon-button-group",
+    INPUT_ADDON_GROUP = "input-addon-group",
+    PLAIN_TEXT = "plain-text",
+    /** Named presets with a raw escape hatch (AGL-2486). */
+    PRESET_CHOICE = "preset-choice",
+    RADIO = "radio",
+    SELECT = "select",
+    SLIDER = "slider",
+    SUB_FORM = "sub-form",
+    SWITCH = "switch",
+    TAB_ITEM = "tab-item",
+    TABS = "tabs",
+    TEXT_FIELD = "text-field",
+    TEXTAREA = "textarea",
+    /** Theme-scale combo box that still accepts a raw value (AGL-2486). */
+    THEME_SCALE = "theme-scale",
+    TIME_PICKER = "time-picker",
+    TOGGLE_BUTTON = "toggle-button",
+    WIZARD = "wizard"
+}
+export declare enum FieldValidatorType {
+    EXACT_LENGTH = "exact-length",
+    MAX_LENGTH = "max-length",
+    MAX_NUMBER_VALUE = "max-number-value",
+    MIN_ITEMS = "min-items",
+    MIN_LENGTH = "min-length",
+    MIN_NUMBER_VALUE = "min-number-value",
+    PATTERN = "pattern",
+    REQUIRED = "required",
+    URL = "url"
+}
+export declare enum FieldDataType {
+    BOOLEAN = "boolean",
+    FLOAT = "float",
+    INTEGER = "integer",
+    NUMBER = "number",
+    STRING = "string"
+}

package/src/lib/constants/flags.js

@@ -0,0 +1,69 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ export var FieldComponentType = /*#__PURE__*/ function(FieldComponentType) {
+    /** Per-breakpoint span/offset row; persists one string (AGL-2486). */ FieldComponentType["BREAKPOINT_SPAN"] = "breakpoint-span";
+    FieldComponentType["BUTTON"] = "button";
+    FieldComponentType["CHECKBOX"] = "checkbox";
+    FieldComponentType["COLOR_PICKER"] = "color-picker";
+    /** Thickness + line style for a border shorthand; one string (AGL-2486). */ FieldComponentType["CSS_BORDER"] = "css-border";
+    /** Number + unit editor for a CSS length; persists one string (AGL-1219). */ FieldComponentType["CSS_DIMENSION"] = "css-dimension";
+    /** Fill type + angle + colour stops; persists one CSS string (AGL-1331). */ FieldComponentType["CSS_GRADIENT"] = "css-gradient";
+    /** Row-and-column grid for the Table element (AGL-2543). */ FieldComponentType["DATA_TABLE"] = "data-table";
+    FieldComponentType["DATE_PICKER"] = "date-picker";
+    FieldComponentType["DUAL_LIST_SELECT"] = "dual-list-select";
+    FieldComponentType["FIELD_ARRAY"] = "field-array";
+    FieldComponentType["ICON_PICKER"] = "icon-picker";
+    FieldComponentType["INPUT_ADDON_BUTTON_GROUP"] = "input-addon-button-group";
+    FieldComponentType["INPUT_ADDON_GROUP"] = "input-addon-group";
+    FieldComponentType["PLAIN_TEXT"] = "plain-text";
+    /** Named presets with a raw escape hatch (AGL-2486). */ FieldComponentType["PRESET_CHOICE"] = "preset-choice";
+    FieldComponentType["RADIO"] = "radio";
+    FieldComponentType["SELECT"] = "select";
+    FieldComponentType["SLIDER"] = "slider";
+    FieldComponentType["SUB_FORM"] = "sub-form";
+    FieldComponentType["SWITCH"] = "switch";
+    FieldComponentType["TAB_ITEM"] = "tab-item";
+    FieldComponentType["TABS"] = "tabs";
+    FieldComponentType["TEXT_FIELD"] = "text-field";
+    FieldComponentType["TEXTAREA"] = "textarea";
+    /** Theme-scale combo box that still accepts a raw value (AGL-2486). */ FieldComponentType["THEME_SCALE"] = "theme-scale";
+    FieldComponentType["TIME_PICKER"] = "time-picker";
+    FieldComponentType["TOGGLE_BUTTON"] = "toggle-button";
+    FieldComponentType["WIZARD"] = "wizard";
+    return FieldComponentType;
+}({});
+export var FieldValidatorType = /*#__PURE__*/ function(FieldValidatorType) {
+    FieldValidatorType["EXACT_LENGTH"] = "exact-length";
+    FieldValidatorType["MAX_LENGTH"] = "max-length";
+    FieldValidatorType["MAX_NUMBER_VALUE"] = "max-number-value";
+    FieldValidatorType["MIN_ITEMS"] = "min-items";
+    FieldValidatorType["MIN_LENGTH"] = "min-length";
+    FieldValidatorType["MIN_NUMBER_VALUE"] = "min-number-value";
+    FieldValidatorType["PATTERN"] = "pattern";
+    FieldValidatorType["REQUIRED"] = "required";
+    FieldValidatorType["URL"] = "url";
+    return FieldValidatorType;
+}({});
+export var FieldDataType = /*#__PURE__*/ function(FieldDataType) {
+    FieldDataType["BOOLEAN"] = "boolean";
+    FieldDataType["FLOAT"] = "float";
+    FieldDataType["INTEGER"] = "integer";
+    FieldDataType["NUMBER"] = "number";
+    FieldDataType["STRING"] = "string";
+    return FieldDataType;
+}({});
+
+//# sourceMappingURL=flags.js.map

package/src/lib/constants/flags.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/ui/jsx-forms/src/lib/constants/flags.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2022 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\nexport enum FieldComponentType {\n  /** Per-breakpoint span/offset row; persists one string (AGL-2486). */\n  BREAKPOINT_SPAN = 'breakpoint-span',\n  BUTTON = 'button',\n  CHECKBOX = 'checkbox',\n  COLOR_PICKER = 'color-picker',\n  /** Thickness + line style for a border shorthand; one string (AGL-2486). */\n  CSS_BORDER = 'css-border',\n  /** Number + unit editor for a CSS length; persists one string (AGL-1219). */\n  CSS_DIMENSION = 'css-dimension',\n  /** Fill type + angle + colour stops; persists one CSS string (AGL-1331). */\n  CSS_GRADIENT = 'css-gradient',\n  /** Row-and-column grid for the Table element (AGL-2543). */\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  INPUT_ADDON_BUTTON_GROUP = 'input-addon-button-group',\n  INPUT_ADDON_GROUP = 'input-addon-group',\n  PLAIN_TEXT = 'plain-text',\n  /** Named presets with a raw escape hatch (AGL-2486). */\n  PRESET_CHOICE = 'preset-choice',\n  RADIO = 'radio',\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  /** Theme-scale combo box that still accepts a raw value (AGL-2486). */\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 enum FieldDataType {\n  BOOLEAN = 'boolean',\n  FLOAT = 'float',\n  INTEGER = 'integer',\n  NUMBER = 'number',\n  STRING = 'string',\n}\n"],"names":["FieldComponentType","FieldValidatorType","FieldDataType"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,OAAO,IAAA,AAAKA,4CAAAA;IACV,oEAAoE;;;;IAKpE,0EAA0E;IAE1E,2EAA2E;IAE3E,0EAA0E;IAE1E,0DAA0D;;;;;;;;IAS1D,sDAAsD;;;;;;;;;;IAWtD,qEAAqE;;;;WAhC3DA;MAqCX;AAED,OAAO,IAAA,AAAKC,4CAAAA;;;;;;;;;;WAAAA;MAUX;AAED,OAAO,IAAA,AAAKC,uCAAAA;;;;;;WAAAA;MAMX"}

package/src/lib/hocs/with-grid-item.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2023 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type GridProps as MuiGridProps } from '@mui/material';
+import { type ComponentType, type ElementType, type ForwardRefExoticComponent, type PropsWithoutRef, type RefAttributes } from 'react';
+export interface GridWrappedMergeProps {
+    FieldGridProps?: Partial<MuiGridProps>;
+}
+export type GridWrappedComponentProps<D extends ElementType = any, P = EmptyObj> = PropsWithoutRef<P & GridWrappedMergeProps> & RefAttributes<D>;
+export interface GridWrappedExoticComponent<D extends ElementType = any, P = EmptyObj> extends ForwardRefExoticComponent<GridWrappedComponentProps<D, P>> {
+}
+export declare function withGridItem<P>(WrappedComponent: ComponentType<P>): GridWrappedExoticComponent<any, P>;

package/src/lib/hocs/with-grid-item.js

@@ -0,0 +1,48 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2023 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ // eslint-disable-next-line @nx/enforce-module-boundaries
+import { mergeSxProps } from "@aglyn/shared-ui-theme";
+import { getDisplayName } from "@aglyn/shared-util-tools";
+import { hoistNonReactStatics } from "@aglyn/shared-util-vendor";
+import { Grid as MuiGrid } from "@mui/material";
+import { forwardRef } from "react";
+export function withGridItem(WrappedComponent) {
+    const displayName = getDisplayName(WrappedComponent);
+    const WithGridItem = /*#__PURE__*/ forwardRef((props, ref)=>{
+        const { FieldGridProps } = props, rest = _object_without_properties_loose(props, [
+            "FieldGridProps"
+        ]);
+        const _ref = FieldGridProps || {}, { sx } = _ref, gridProps = _object_without_properties_loose(_ref, [
+            "sx"
+        ]);
+        return /*#__PURE__*/ _jsx(MuiGrid, _extends({
+            ref: ref,
+            sx: mergeSxProps({
+                position: 'relative'
+            }, sx)
+        }, gridProps, {
+            children: /*#__PURE__*/ _jsx(WrappedComponent, _extends({}, rest))
+        }));
+    });
+    WithGridItem.displayName = `WithGridItem(${displayName})`;
+    hoistNonReactStatics(WithGridItem, WrappedComponent);
+    return WithGridItem;
+}
+
+//# sourceMappingURL=with-grid-item.js.map

package/src/lib/hocs/with-grid-item.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/ui/jsx-forms/src/lib/hocs/with-grid-item.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2023 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\n// eslint-disable-next-line @nx/enforce-module-boundaries\nimport { mergeSxProps } from '@aglyn/shared-ui-theme'\nimport { getDisplayName } from '@aglyn/shared-util-tools'\nimport { hoistNonReactStatics } from '@aglyn/shared-util-vendor'\nimport { Grid as MuiGrid, type GridProps as MuiGridProps } from '@mui/material'\nimport {\n  type ComponentType,\n  type ElementType,\n  forwardRef,\n  type ForwardRefExoticComponent,\n  type PropsWithoutRef,\n  type RefAttributes,\n} from 'react'\n\n\nexport interface GridWrappedMergeProps {\n  FieldGridProps?: Partial<MuiGridProps>\n}\n\nexport type GridWrappedComponentProps<\n  D extends ElementType = any,\n  P = EmptyObj,\n> = PropsWithoutRef<P & GridWrappedMergeProps> & RefAttributes<D>\n\nexport interface GridWrappedExoticComponent<\n  D extends ElementType = any,\n  P = EmptyObj,\n> extends ForwardRefExoticComponent<GridWrappedComponentProps<D, P>> {}\n\nexport function withGridItem<P>(\n  WrappedComponent: ComponentType<P>,\n): GridWrappedExoticComponent<any, P> {\n  const displayName = getDisplayName(WrappedComponent)\n  const WithGridItem = forwardRef<any, P & GridWrappedMergeProps>(\n    (props, ref) => {\n      const { FieldGridProps, ...rest } = props\n      const { sx, ...gridProps } = FieldGridProps || ({} as MuiGridProps)\n\n      return (\n        <MuiGrid\n          ref={ref}\n          sx={mergeSxProps({ position: 'relative' }, sx)}\n          {...gridProps}\n        >\n          <WrappedComponent {...(rest as P)} />\n        </MuiGrid>\n      )\n    },\n  )\n  WithGridItem.displayName = `WithGridItem(${displayName})`\n  hoistNonReactStatics(WithGridItem, WrappedComponent)\n  return WithGridItem\n}\n"],"names":["mergeSxProps","getDisplayName","hoistNonReactStatics","Grid","MuiGrid","forwardRef","withGridItem","WrappedComponent","displayName","WithGridItem","props","ref","FieldGridProps","rest","sx","gridProps","position"],"mappings":";;;AAAA;;;;;;;;;;;;;;;CAeC,GAED,yDAAyD;AACzD,SAASA,YAAY,QAAQ,yBAAwB;AACrD,SAASC,cAAc,QAAQ,2BAA0B;AACzD,SAASC,oBAAoB,QAAQ,4BAA2B;AAChE,SAASC,QAAQC,OAAO,QAAwC,gBAAe;AAC/E,SAGEC,UAAU,QAIL,QAAO;AAiBd,OAAO,SAASC,aACdC,gBAAkC;IAElC,MAAMC,cAAcP,eAAeM;IACnC,MAAME,6BAAeJ,WACnB,CAACK,OAAOC;QACN,MAAM,EAAEC,cAAc,EAAW,GAAGF,OAATG,wCAASH;;;QACpC,MAA6BE,OAAAA,kBAAmB,CAAC,GAA3C,EAAEE,EAAE,EAAgB,GAAGF,MAAdG,6CAAcH;;;QAE7B,qBACE,KAACR;YACCO,KAAKA;YACLG,IAAId,aAAa;gBAAEgB,UAAU;YAAW,GAAGF;WACvCC;sBAEJ,cAAA,KAACR,+BAAsBM;;IAG7B;IAEFJ,aAAaD,WAAW,GAAG,CAAC,aAAa,EAAEA,YAAY,CAAC,CAAC;IACzDN,qBAAqBO,cAAcF;IACnC,OAAOE;AACT"}

package/src/lib/jsx-forms.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export * from './types';
+export * from './components/color-picker.component';
+export * from './components/color-picker-tokens';
+export * from './components/icon-select.component';
+export * from './components/select.component';
+export * from './components/switch.component';
+export * from './components/text-field.component';
+export * from './components/textarea.component';
+export * from './components/grid-form-template.component';
+export * from './components/create-artifact-drawer.component';
+export * from './components/toggle-button.component';
+export * from './mapper';
+export * from './constants/component-mappers';
+export * from './constants/dynamic-fields';
+export * from './constants/field-configurations';
+export * from './constants/flags';
+export * from './hocs/with-grid-item';
+export * from './utils/option-is-equal-to-value';
+export * from './utils/validation-message';
+export * from './vendor/data-driven-forms';
+export { type SelectProps } from './components/select.component';
+export { type SwitchProps } from './components/switch.component';
+export { type TextFieldProps } from './components/text-field.component';
+export { type TextareaProps } from './components/textarea.component';
+export { FieldArray } from './vendor/data-driven-forms';

package/src/lib/jsx-forms.js

@@ -0,0 +1,42 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ export * from "./types.js";
+export * from "./components/color-picker.component.js";
+export * from "./components/color-picker-tokens.js";
+export * from "./components/icon-select.component.js";
+export * from "./components/select.component.js";
+export * from "./components/switch.component.js";
+export * from "./components/text-field.component.js";
+export * from "./components/textarea.component.js";
+export * from "./components/grid-form-template.component.js";
+// The shared create drawer (AGL-700). Exported from the library rather than
+// living in `apps/console` so that the console pages a PLUGIN ships can create
+// a record the same way the app's own list pages do — a plugin card cannot
+// import from the app that renders it.
+export * from "./components/create-artifact-drawer.component.js";
+export * from "./components/toggle-button.component.js";
+export * from "./mapper/index.js";
+export * from "./constants/component-mappers.js";
+export * from "./constants/dynamic-fields.js";
+export * from "./constants/field-configurations.js";
+export * from "./constants/flags.js";
+export * from "./hocs/with-grid-item.js";
+export * from "./utils/option-is-equal-to-value.js";
+export * from "./utils/validation-message.js";
+export * from "./vendor/data-driven-forms.js";
+export { FieldArray } from "./vendor/data-driven-forms.js";
+
+//# sourceMappingURL=jsx-forms.js.map

package/src/lib/jsx-forms.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/shared/ui/jsx-forms/src/lib/jsx-forms.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2022 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\nexport * from './types'\n\nexport * from './components/color-picker.component'\nexport * from './components/color-picker-tokens'\nexport * from './components/icon-select.component'\nexport * from './components/select.component'\nexport * from './components/switch.component'\nexport * from './components/text-field.component'\nexport * from './components/textarea.component'\nexport * from './components/grid-form-template.component'\n// The shared create drawer (AGL-700). Exported from the library rather than\n// living in `apps/console` so that the console pages a PLUGIN ships can create\n// a record the same way the app's own list pages do — a plugin card cannot\n// import from the app that renders it.\nexport * from './components/create-artifact-drawer.component'\nexport * from './components/toggle-button.component'\n\nexport * from './mapper'\n\nexport * from './constants/component-mappers'\nexport * from './constants/dynamic-fields'\nexport * from './constants/field-configurations'\nexport * from './constants/flags'\n\nexport * from './hocs/with-grid-item'\n\nexport * from './utils/option-is-equal-to-value'\nexport * from './utils/validation-message'\n\nexport * from './vendor/data-driven-forms'\n\n// Explicit winners for names exported by both the classic components and\n// the MUI-native mapper (or the ddf vendor barrel) — TS2308 otherwise.\nexport { type SelectProps } from './components/select.component'\nexport { type SwitchProps } from './components/switch.component'\nexport { type TextFieldProps } from './components/text-field.component'\nexport { type TextareaProps } from './components/textarea.component'\nexport { FieldArray } from './vendor/data-driven-forms'\n"],"names":["FieldArray"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,cAAc,aAAS;AAEvB,cAAc,yCAAqC;AACnD,cAAc,sCAAkC;AAChD,cAAc,wCAAoC;AAClD,cAAc,mCAA+B;AAC7C,cAAc,mCAA+B;AAC7C,cAAc,uCAAmC;AACjD,cAAc,qCAAiC;AAC/C,cAAc,+CAA2C;AACzD,4EAA4E;AAC5E,+EAA+E;AAC/E,2EAA2E;AAC3E,uCAAuC;AACvC,cAAc,mDAA+C;AAC7D,cAAc,0CAAsC;AAEpD,cAAc,oBAAU;AAExB,cAAc,mCAA+B;AAC7C,cAAc,gCAA4B;AAC1C,cAAc,sCAAkC;AAChD,cAAc,uBAAmB;AAEjC,cAAc,2BAAuB;AAErC,cAAc,sCAAkC;AAChD,cAAc,gCAA4B;AAE1C,cAAc,gCAA4B;AAQ1C,SAASA,UAAU,QAAQ,gCAA4B"}

package/src/lib/mapper/breakpoint-span.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type SpanBreakpoint } from '@aglyn/shared-data-enums';
+import { type FormFieldGridProps } from './form-field-grid';
+import type { BaseFieldProps } from './types';
+/**
+ * BreakpointSpan (AGL-2486): the per-breakpoint editor for a MUI Grid cell's
+ * **Span** and **Offset**.
+ *
+ * Both were free-text boxes taking a developer syntax — `xs:12 md:2` — with
+ * the syntax explained only in a tooltip. Aglyn's authors are not reading the
+ * MUI Grid docs, so the capability was there and unreachable: in practice a
+ * cell got one number and never became responsive.
+ *
+ * The PERSISTED value is unchanged: still ONE string, still the same syntax,
+ * parsed by the same shared pair the Grid element itself uses
+ * (`parseBreakpointSpan`/`buildBreakpointSpan` in `@aglyn/shared-data-enums`).
+ * This is an input affordance, not a shape change, so renderers, published
+ * documents and existing nodes stay untouched — the same rule
+ * {@link CssDimensionField} follows for CSS lengths.
+ *
+ * Two things the layout of this editor has to get right:
+ *
+ *  - A value authored with NO breakpoint (`"6"`) is a scalar and applies at
+ *    every size. It is NOT the same string as `xs:6`, and MUI's prop is
+ *    either a scalar or an object — never both. So the row leads with an
+ *    **All** cell, and picking a breakpoint disables it (and vice versa)
+ *    rather than silently dropping one of the two.
+ *  - Anything this editor cannot model — a `{{token}}`, an unknown
+ *    breakpoint, a span wider than the offered list — must NOT be clobbered.
+ *    It falls back to a raw text box holding the string verbatim, and flips
+ *    back to the controls the moment the text becomes modellable again. The
+ *    same escape hatch is reachable on purpose (**Edit as text**) so the full
+ *    syntax stays available to anyone who wants it.
+ */
+/** Draft state: what the row of controls shows, before serialization. */
+export interface SpanDraft {
+    /** The value is not modellable — the text box holds it verbatim. */
+    custom: boolean;
+    /** Raw string, in custom mode only. */
+    text: string;
+    /** The breakpoint-less value; `''` when unset. */
+    base: string;
+    /** Per-breakpoint values as option strings; `''` when unset. */
+    values: Record<SpanBreakpoint, string>;
+}
+export declare const seedSpanDraft: (value: unknown) => SpanDraft;
+export declare const serializeSpanDraft: (draft: SpanDraft) => string;
+export interface BreakpointSpanProps extends BaseFieldProps {
+    /** Offer MUI's `grow` keyword. False for Offset, which has no `grow`. */
+    allowGrow?: boolean;
+    /** Lowest column count offered. 0 for Offset, 1 for Span. */
+    minSpan?: number;
+    /** Highest column count offered; the container's `columns` default. */
+    maxSpan?: number;
+    FormFieldGridProps?: FormFieldGridProps;
+}
+export declare const BreakpointSpanField: (props: BreakpointSpanProps) => import("react").JSX.Element;
+export default BreakpointSpanField;