@antelopejs/interface-dms 0.3.4 → 0.3.6

package/dist/base/table-view/internal/tabs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabs.js","sourceRoot":"","sources":["../../../../src/base/table-view/internal/tabs.ts"],"names":[],"mappings":"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"}

package/dist/base/table-view/internal/validation.d.ts

@@ -0,0 +1,99 @@
+import { TableViewMeta } from "../meta";
+import { type FormContainerPages, type GroupedOptions, type KanbanOptions, type TableViewDisplayOption, type TableViewOptions, type TableViewQuickFilter, type TableViewTab, type TableViewViewsOptions } from "../options";
+/**
+ * `pageSize` is a whole number of rows, from 1 up to {@link MAX_TABLE_PAGE_SIZE}.
+ *
+ * @internal
+ */
+export declare function validatePageSize(controllerName: string, pageSize: number | undefined): void;
+/**
+ * Throws when a table view option names a column the controller lacks.
+ *
+ * @internal
+ */
+export declare function assertKnownColumns(controllerName: string, meta: Pick<TableViewMeta, "columns">, option: string, keys: string[]): void;
+/**
+ * Quick filters must name filterable columns: they filter with `filter_<field>`.
+ *
+ * @internal
+ */
+export declare function validateQuickFilters(controllerName: string, meta: TableViewMeta, quickFilters: TableViewQuickFilter[] | undefined): void;
+/**
+ * The kanban groups on an eligible column and shows declared columns on its
+ * cards.
+ *
+ * @internal
+ */
+export declare function validateKanbanOptions(controllerName: string, meta: TableViewMeta, kanban: KanbanOptions | undefined): void;
+/**
+ * A display a table view offers is a built-in one, named by its reserved id
+ * and drawn by the DMS (no `component` of its own), or a module's, named
+ * `<module>:<id>`.
+ *
+ * @internal
+ */
+export declare function validateDisplayIds(controllerName: string, displays: TableViewDisplayOption[] | undefined): void;
+/** What a table view's displays are declared from. */
+interface DisplayDeclarations {
+    kanban?: KanbanOptions;
+    grouped?: GroupedOptions;
+    displays?: TableViewDisplayOption[];
+}
+/**
+ * The ids of the displays a table view offers.
+ *
+ * @internal
+ */
+export declare function offeredDisplayIds(options: DisplayDeclarations): Set<string>;
+/**
+ * The default display must be one the table view offers.
+ *
+ * @internal
+ */
+export declare function validateDefaultDisplay(controllerName: string, options: DisplayDeclarations & {
+    defaultDisplay?: string;
+}): void;
+/**
+ * The grouped display sorts on its column, which must therefore be a sortable
+ * column, and a date one to be grouped by day or week.
+ *
+ * @internal
+ */
+export declare function validateGroupedOptions(controllerName: string, meta: TableViewMeta, grouped: GroupedOptions | undefined): void;
+/**
+ * A hand-ordered table writes its position column through the edit route:
+ * the column must be a writable, sortable number, and the edit action on.
+ *
+ * @internal
+ */
+export declare function validateReorder<T extends Record<string, unknown>>(controllerName: string, meta: TableViewMeta, options: TableViewOptions<T>): void;
+/**
+ * Views have unique ids, and each one names columns, a sort and a display the
+ * table view has; the default view is one of them.
+ *
+ * @internal
+ */
+export declare function validateViews(controllerName: string, meta: TableViewMeta, options: DisplayDeclarations & {
+    views?: TableViewViewsOptions;
+}): void;
+/**
+ * A declared slug for a row-scoped form page must carry the row's `:id`.
+ *
+ * @internal
+ */
+export declare function assertRowScopedFormSlugs(pages: FormContainerPages | undefined): void;
+/**
+ * A tab filters the rows or opens another page, never both.
+ *
+ * @internal
+ */
+export declare function assertTabTargets(controllerName: string, tabs: TableViewTab[] | undefined): void;
+/**
+ * Every declaration check `TableView()` runs before it builds anything: the
+ * options naming columns, displays, tabs and sizes name ones the table view
+ * can have.
+ *
+ * @internal
+ */
+export declare function validateTableViewOptions<T extends Record<string, unknown>>(controllerName: string, meta: TableViewMeta, options: TableViewOptions<T>): void;
+export {};

package/dist/base/table-view/internal/validation.js

@@ -0,0 +1,297 @@
+"use strict";
+// The declaration checks the TableView factory runs before building anything:
+// every option naming a column, a display or a form slug must name one the
+// table view actually has.
+//
+// Split out of factory-helpers.ts.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validatePageSize = validatePageSize;
+exports.assertKnownColumns = assertKnownColumns;
+exports.validateQuickFilters = validateQuickFilters;
+exports.validateKanbanOptions = validateKanbanOptions;
+exports.validateDisplayIds = validateDisplayIds;
+exports.offeredDisplayIds = offeredDisplayIds;
+exports.validateDefaultDisplay = validateDefaultDisplay;
+exports.validateGroupedOptions = validateGroupedOptions;
+exports.validateReorder = validateReorder;
+exports.validateViews = validateViews;
+exports.assertRowScopedFormSlugs = assertRowScopedFormSlugs;
+exports.assertTabTargets = assertTabTargets;
+exports.validateTableViewOptions = validateTableViewOptions;
+const interface_core_1 = require("@antelopejs/interface-core");
+const metadata_1 = require("@antelopejs/interface-data-api/metadata");
+const data_types_1 = require("../../data-types");
+const options_1 = require("../options");
+/**
+ * `pageSize` is a whole number of rows, from 1 up to {@link MAX_TABLE_PAGE_SIZE}.
+ *
+ * @internal
+ */
+function validatePageSize(controllerName, pageSize) {
+    if (pageSize === undefined)
+        return;
+    if (!Number.isInteger(pageSize) ||
+        pageSize < 1 ||
+        pageSize > options_1.MAX_TABLE_PAGE_SIZE) {
+        throw new Error(`TableView pageSize on ${controllerName} must be a whole number from 1 to ${options_1.MAX_TABLE_PAGE_SIZE} (got ${pageSize})`);
+    }
+}
+/**
+ * Throws when a table view option names a column the controller lacks.
+ *
+ * @internal
+ */
+function assertKnownColumns(controllerName, meta, option, keys) {
+    for (const key of keys) {
+        if (!meta.columns[key]) {
+            throw new Error(`TableView ${option} on ${controllerName} references unknown column "${key}"`);
+        }
+    }
+}
+/**
+ * Quick filters must name filterable columns: they filter with `filter_<field>`.
+ *
+ * @internal
+ */
+function validateQuickFilters(controllerName, meta, quickFilters) {
+    for (const { field } of quickFilters ?? []) {
+        const column = meta.columns[field];
+        if (!column) {
+            throw new Error(`TableView quickFilters on ${controllerName} references unknown column "${field}"`);
+        }
+        if (!column.filterable) {
+            throw new Error(`TableView quickFilters on ${controllerName}: column "${field}" must be filterable`);
+        }
+    }
+}
+const KANBAN_GROUP_TYPE_ELIGIBILITY = {
+    select: (type) => !type.options?.multiple,
+    boolean: () => true,
+    status: () => true,
+};
+function validateKanbanField(controllerName, meta, groupByField) {
+    const groupColumn = meta.columns[groupByField];
+    if (!groupColumn) {
+        throw new Error(`TableView kanban groupByField on ${controllerName} references unknown column "${groupByField}"`);
+    }
+    const typeId = (0, data_types_1.getDataTypeId)(groupColumn.type);
+    const isEligible = typeId !== undefined &&
+        KANBAN_GROUP_TYPE_ELIGIBILITY[typeId]?.(groupColumn.type);
+    if (!isEligible) {
+        throw new Error(`TableView kanban groupByField "${groupByField}" on ${controllerName} must be a non-multiple SelectType, a BooleanType or a StatusType column (got "${typeId}")`);
+    }
+}
+/**
+ * The kanban groups on an eligible column and shows declared columns on its
+ * cards.
+ *
+ * @internal
+ */
+function validateKanbanOptions(controllerName, meta, kanban) {
+    if (!kanban)
+        return;
+    validateKanbanField(controllerName, meta, kanban.groupByField);
+}
+/** Display ids the DMS keeps for its built-in displays. */
+const RESERVED_DISPLAY_IDS = [
+    options_1.TABLE_DISPLAY_ID,
+    options_1.KANBAN_DISPLAY_ID,
+    options_1.CARDS_DISPLAY_ID,
+    options_1.GROUPED_DISPLAY_ID,
+];
+// `<module>:<id>`: the module's name, then the display's own id.
+const MODULE_DISPLAY_ID = /^[a-z0-9][\w-]*:[\w-]+$/i;
+/**
+ * A display a table view offers is a built-in one, named by its reserved id
+ * and drawn by the DMS (no `component` of its own), or a module's, named
+ * `<module>:<id>`.
+ *
+ * @internal
+ */
+function validateDisplayIds(controllerName, displays) {
+    for (const { id, component } of displays ?? []) {
+        if (RESERVED_DISPLAY_IDS.includes(id)) {
+            if (component) {
+                throw new Error(`TableView on ${controllerName} gives the built-in display "${id}" a component: a module display takes an id of its own, "<module>:${id}"`);
+            }
+            continue;
+        }
+        if (!MODULE_DISPLAY_ID.test(id)) {
+            throw new Error(`TableView on ${controllerName} offers display "${id}": a module display is named "<module>:<id>", e.g. "saas:plan-cards"`);
+        }
+    }
+}
+/**
+ * The ids of the displays a table view offers.
+ *
+ * @internal
+ */
+function offeredDisplayIds(options) {
+    const { kanban, grouped, displays } = options;
+    return new Set([
+        options_1.TABLE_DISPLAY_ID,
+        ...(kanban ? [options_1.KANBAN_DISPLAY_ID] : []),
+        ...(grouped ? [options_1.GROUPED_DISPLAY_ID] : []),
+        ...(displays?.map((display) => display.id) ?? []),
+    ]);
+}
+/**
+ * The default display must be one the table view offers.
+ *
+ * @internal
+ */
+function validateDefaultDisplay(controllerName, options) {
+    const { defaultDisplay } = options;
+    if (!defaultDisplay)
+        return;
+    if (!offeredDisplayIds(options).has(defaultDisplay)) {
+        throw new Error(`TableView on ${controllerName} defaults to display "${defaultDisplay}" which is not declared in displays`);
+    }
+}
+function isSortableColumn(meta, key) {
+    const fields = (0, interface_core_1.GetMetadata)(meta.target, metadata_1.DataAPIMeta).fields;
+    return fields[key]?.sortable !== undefined;
+}
+const DAY_GROUPING_TYPE_ID = "date";
+/**
+ * The grouped display sorts on its column, which must therefore be a sortable
+ * column, and a date one to be grouped by day or week.
+ *
+ * @internal
+ */
+function validateGroupedOptions(controllerName, meta, grouped) {
+    if (!grouped)
+        return;
+    const { groupByField, by } = grouped;
+    const column = meta.columns[groupByField];
+    if (!column) {
+        throw new Error(`TableView grouped groupByField on ${controllerName} references unknown column "${groupByField}"`);
+    }
+    if (!isSortableColumn(meta, groupByField)) {
+        throw new Error(`TableView grouped groupByField "${groupByField}" on ${controllerName} must be @Sortable(): the rows are listed sorted on it`);
+    }
+    const typeId = (0, data_types_1.getDataTypeId)(column.type);
+    if (by && by !== "value" && typeId !== DAY_GROUPING_TYPE_ID) {
+        throw new Error(`TableView grouped on ${controllerName} groups "${groupByField}" by ${by}, which needs a DateType column (got "${typeId}")`);
+    }
+}
+const NUMBER_TYPE_ID = "number";
+/**
+ * A hand-ordered table writes its position column through the edit route:
+ * the column must be a writable, sortable number, and the edit action on.
+ *
+ * @internal
+ */
+function validateReorder(controllerName, meta, options) {
+    const field = options.reorder?.field;
+    if (!field)
+        return;
+    const where = `TableView reorder field "${field}" on ${controllerName}`;
+    const column = meta.columns[field];
+    if (!column || (0, data_types_1.getDataTypeId)(column.type) !== NUMBER_TYPE_ID) {
+        throw new Error(`${where} must be a NumberType column`);
+    }
+    const fieldMeta = (0, interface_core_1.GetMetadata)(meta.target, metadata_1.DataAPIMeta)
+        .fields[field];
+    if (fieldMeta?.sortable === undefined) {
+        throw new Error(`${where} must be @Sortable(): the rows are listed sorted on it`);
+    }
+    if (fieldMeta.mode === metadata_1.AccessMode.ReadOnly) {
+        throw new Error(`${where} must be writable: moving a row edits it`);
+    }
+    if (options.rowActions?.edit === false) {
+        throw new Error(`${where} needs the edit action: moving a row edits it`);
+    }
+}
+function assertViewFilters(where, meta, view) {
+    for (const { accessorKey } of view.filters ?? []) {
+        if (!meta.columns[accessorKey]?.filterable) {
+            throw new Error(`${where} filters on "${accessorKey}", which is not a filterable column`);
+        }
+    }
+    for (const { field } of view.sort ?? []) {
+        if (!meta.columns[field] || !isSortableColumn(meta, field)) {
+            throw new Error(`${where} sorts on "${field}", which is not a @Sortable() column`);
+        }
+    }
+    const { visible = [], hidden = [], order = [] } = view.columns ?? {};
+    for (const key of [...visible, ...hidden, ...order]) {
+        if (!meta.columns[key]) {
+            throw new Error(`${where} references unknown column "${key}"`);
+        }
+    }
+}
+/**
+ * Views have unique ids, and each one names columns, a sort and a display the
+ * table view has; the default view is one of them.
+ *
+ * @internal
+ */
+function validateViews(controllerName, meta, options) {
+    const { views } = options;
+    if (!views)
+        return;
+    const displays = offeredDisplayIds(options);
+    const ids = new Set();
+    for (const view of views.items) {
+        const where = `TableView view "${view.id}" on ${controllerName}`;
+        if (ids.has(view.id)) {
+            throw new Error(`${where} is declared twice: view ids are unique`);
+        }
+        ids.add(view.id);
+        assertViewFilters(where, meta, view);
+        if (view.display && !displays.has(view.display)) {
+            throw new Error(`${where} opens display "${view.display}", which the table does not offer`);
+        }
+    }
+    if (views.defaultView && !ids.has(views.defaultView)) {
+        throw new Error(`TableView on ${controllerName} defaults to view "${views.defaultView}", which is not declared`);
+    }
+}
+/** The kinds addressing one row, whose slug therefore has to carry an `:id`. */
+const ROW_SCOPED_FORM_PAGE_KINDS = ["edit", "details"];
+/**
+ * A declared slug for a row-scoped form page must carry the row's `:id`.
+ *
+ * @internal
+ */
+function assertRowScopedFormSlugs(pages) {
+    for (const kind of ROW_SCOPED_FORM_PAGE_KINDS) {
+        const declared = pages?.[kind]?.urlSlug;
+        if (declared && !declared.includes(":id")) {
+            throw new Error(`TableView formContainer.pages.${kind}.urlSlug must contain :id placeholder. Got: ${declared}`);
+        }
+    }
+}
+/**
+ * A tab filters the rows or opens another page, never both.
+ *
+ * @internal
+ */
+function assertTabTargets(controllerName, tabs) {
+    for (const tab of tabs ?? []) {
+        if (tab.filter && tab.to) {
+            throw new Error(`TableView tab "${tab.id}" on ${controllerName} gives both a filter and a link (to): a tab filters the rows or opens another page, not both`);
+        }
+    }
+}
+/**
+ * Every declaration check `TableView()` runs before it builds anything: the
+ * options naming columns, displays, tabs and sizes name ones the table view
+ * can have.
+ *
+ * @internal
+ */
+function validateTableViewOptions(controllerName, meta, options) {
+    validateKanbanOptions(controllerName, meta, options.kanban);
+    assertKnownColumns(controllerName, meta, "card fields", options.card?.fields ?? []);
+    validateGroupedOptions(controllerName, meta, options.grouped);
+    validateDisplayIds(controllerName, options.displays);
+    validateDefaultDisplay(controllerName, options);
+    validateViews(controllerName, meta, options);
+    validateReorder(controllerName, meta, options);
+    validateQuickFilters(controllerName, meta, options.quickFilters);
+    validatePageSize(controllerName, options.pageSize);
+    assertTabTargets(controllerName, options.tabs);
+}
+//# sourceMappingURL=validation.js.map

package/dist/base/table-view/internal/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../../src/base/table-view/internal/validation.ts"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,2EAA2E;AAC3E,2BAA2B;AAC3B,EAAE;AACF,mCAAmC;;AAgCnC,4CAcC;AAOD,gDAaC;AAOD,oDAkBC;AA6CD,sDAOC;AAmBD,gDAmBC;AAcD,8CAQC;AAOD,wDAWC;AAkBD,wDAwBC;AAUD,0CAyBC;AAmCD,sCA2BC;AAUD,4DAWC;AAOD,4CAWC;AASD,4DAoBC;AAzaD,+DAAyD;AACzD,sEAGiD;AACjD,iDAAiD;AAEjD,wCAeoB;AAEpB;;;;GAIG;AACH,SAAgB,gBAAgB,CAC9B,cAAsB,EACtB,QAA4B;IAE5B,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO;IACnC,IACE,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC;QAC3B,QAAQ,GAAG,CAAC;QACZ,QAAQ,GAAG,6BAAmB,EAC9B,CAAC;QACD,MAAM,IAAI,KAAK,CACb,yBAAyB,cAAc,qCAAqC,6BAAmB,SAAS,QAAQ,GAAG,CACpH,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,kBAAkB,CAChC,cAAsB,EACtB,IAAoC,EACpC,MAAc,EACd,IAAc;IAEd,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,aAAa,MAAM,OAAO,cAAc,+BAA+B,GAAG,GAAG,CAC9E,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,oBAAoB,CAClC,cAAsB,EACtB,IAAmB,EACnB,YAAgD;IAEhD,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,YAAY,IAAI,EAAE,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACb,6BAA6B,cAAc,+BAA+B,KAAK,GAAG,CACnF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,6BAA6B,cAAc,aAAa,KAAK,sBAAsB,CACpF,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAMD,MAAM,6BAA6B,GAG/B;IACF,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ;IACzC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI;IACnB,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI;CACnB,CAAC;AAEF,SAAS,mBAAmB,CAC1B,cAAsB,EACtB,IAAmB,EACnB,YAAoB;IAEpB,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/C,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,oCAAoC,cAAc,+BAA+B,YAAY,GAAG,CACjG,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,IAAA,0BAAa,EAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,UAAU,GACd,MAAM,KAAK,SAAS;QACpB,6BAA6B,CAAC,MAAM,CAAC,EAAE,CACrC,WAAW,CAAC,IAA6B,CAC1C,CAAC;IACJ,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACb,kCAAkC,YAAY,QAAQ,cAAc,kFAAkF,MAAM,IAAI,CACjK,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,qBAAqB,CACnC,cAAsB,EACtB,IAAmB,EACnB,MAAiC;IAEjC,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,mBAAmB,CAAC,cAAc,EAAE,IAAI,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;AACjE,CAAC;AAED,2DAA2D;AAC3D,MAAM,oBAAoB,GAAsB;IAC9C,0BAAgB;IAChB,2BAAiB;IACjB,0BAAgB;IAChB,4BAAkB;CACnB,CAAC;AACF,iEAAiE;AACjE,MAAM,iBAAiB,GAAG,0BAA0B,CAAC;AAErD;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAChC,cAAsB,EACtB,QAA8C;IAE9C,KAAK,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,QAAQ,IAAI,EAAE,EAAE,CAAC;QAC/C,IAAI,oBAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACtC,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CACb,gBAAgB,cAAc,gCAAgC,EAAE,qEAAqE,EAAE,GAAG,CAC3I,CAAC;YACJ,CAAC;YACD,SAAS;QACX,CAAC;QACD,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,gBAAgB,cAAc,oBAAoB,EAAE,sEAAsE,CAC3H,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AASD;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,OAA4B;IAC5D,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAC9C,OAAO,IAAI,GAAG,CAAS;QACrB,0BAAgB;QAChB,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,2BAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,4BAAkB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;KAClD,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,SAAgB,sBAAsB,CACpC,cAAsB,EACtB,OAA0D;IAE1D,MAAM,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;IACnC,IAAI,CAAC,cAAc;QAAE,OAAO;IAC5B,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CACb,gBAAgB,cAAc,yBAAyB,cAAc,qCAAqC,CAC3G,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAmB,EAAE,GAAW;IACxD,MAAM,MAAM,GAAG,IAAA,4BAAW,EACxB,IAAI,CAAC,MAAyB,EAC9B,sBAAW,CACZ,CAAC,MAAM,CAAC;IACT,OAAO,MAAM,CAAC,GAAG,CAAC,EAAE,QAAQ,KAAK,SAAS,CAAC;AAC7C,CAAC;AAED,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAEpC;;;;;GAKG;AACH,SAAgB,sBAAsB,CACpC,cAAsB,EACtB,IAAmB,EACnB,OAAmC;IAEnC,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,qCAAqC,cAAc,+BAA+B,YAAY,GAAG,CAClG,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,mCAAmC,YAAY,QAAQ,cAAc,wDAAwD,CAC9H,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,IAAA,0BAAa,EAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,EAAE,IAAI,EAAE,KAAK,OAAO,IAAI,MAAM,KAAK,oBAAoB,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CACb,wBAAwB,cAAc,YAAY,YAAY,QAAQ,EAAE,yCAAyC,MAAM,IAAI,CAC5H,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,cAAc,GAAG,QAAQ,CAAC;AAEhC;;;;;GAKG;AACH,SAAgB,eAAe,CAC7B,cAAsB,EACtB,IAAmB,EACnB,OAA4B;IAE5B,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC;IACrC,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,MAAM,KAAK,GAAG,4BAA4B,KAAK,QAAQ,cAAc,EAAE,CAAC;IACxE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,IAAI,IAAA,0BAAa,EAAC,MAAM,CAAC,IAAI,CAAC,KAAK,cAAc,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,8BAA8B,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,SAAS,GAAG,IAAA,4BAAW,EAAC,IAAI,CAAC,MAAyB,EAAE,sBAAW,CAAC;SACvE,MAAM,CAAC,KAAK,CAAC,CAAC;IACjB,IAAI,SAAS,EAAE,QAAQ,KAAK,SAAS,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,wDAAwD,CACjE,CAAC;IACJ,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,KAAK,qBAAU,CAAC,QAAQ,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,0CAA0C,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,EAAE,IAAI,KAAK,KAAK,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,+CAA+C,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CACxB,KAAa,EACb,IAAmB,EACnB,IAAmB;IAEnB,KAAK,MAAM,EAAE,WAAW,EAAE,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;QACjD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,gBAAgB,WAAW,qCAAqC,CACzE,CAAC;QACJ,CAAC;IACH,CAAC;IACD,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;YAC3D,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,cAAc,KAAK,sCAAsC,CAClE,CAAC;QACJ,CAAC;IACH,CAAC;IACD,MAAM,EAAE,OAAO,GAAG,EAAE,EAAE,MAAM,GAAG,EAAE,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IACrE,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;QACpD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,+BAA+B,GAAG,GAAG,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAC3B,cAAsB,EACtB,IAAmB,EACnB,OAAgE;IAEhE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAC1B,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,mBAAmB,IAAI,CAAC,EAAE,QAAQ,cAAc,EAAE,CAAC;QACjE,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,yCAAyC,CAAC,CAAC;QACrE,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,iBAAiB,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACrC,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,mBAAmB,IAAI,CAAC,OAAO,mCAAmC,CAC3E,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CACb,gBAAgB,cAAc,sBAAsB,KAAK,CAAC,WAAW,0BAA0B,CAChG,CAAC;IACJ,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,MAAM,0BAA0B,GAAG,CAAC,MAAM,EAAE,SAAS,CAAU,CAAC;AAEhE;;;;GAIG;AACH,SAAgB,wBAAwB,CACtC,KAAqC;IAErC,KAAK,MAAM,IAAI,IAAI,0BAA0B,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAG,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QACxC,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CACb,iCAAiC,IAAI,+CAA+C,QAAQ,EAAE,CAC/F,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,gBAAgB,CAC9B,cAAsB,EACtB,IAAgC;IAEhC,KAAK,MAAM,GAAG,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC;QAC7B,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,kBAAkB,GAAG,CAAC,EAAE,QAAQ,cAAc,8FAA8F,CAC7I,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,wBAAwB,CACtC,cAAsB,EACtB,IAAmB,EACnB,OAA4B;IAE5B,qBAAqB,CAAC,cAAc,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5D,kBAAkB,CAChB,cAAc,EACd,IAAI,EACJ,aAAa,EACb,OAAO,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAC3B,CAAC;IACF,sBAAsB,CAAC,cAAc,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9D,kBAAkB,CAAC,cAAc,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrD,sBAAsB,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IAChD,aAAa,CAAC,cAAc,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7C,eAAe,CAAC,cAAc,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/C,oBAAoB,CAAC,cAAc,EAAE,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACjE,gBAAgB,CAAC,cAAc,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnD,gBAAgB,CAAC,cAAc,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC"}

package/dist/base/table-view/internal/views.d.ts

@@ -0,0 +1,14 @@
+import type { TableViewViewsOptions, TableViewViewsSerialized } from "../options";
+/**
+ * The views as the options carry them: their permission stays server-side.
+ *
+ * @internal
+ */
+export declare function serializeTableViewViews(views: TableViewViewsOptions | undefined): TableViewViewsSerialized | undefined;
+/**
+ * The views served to one request: a view whose permission the caller lacks
+ * is left out. A default view left out falls back to the table's own state.
+ *
+ * @internal
+ */
+export declare function resolveTableViewViews(permissions: Set<string>, declared: TableViewViewsOptions | undefined, serialized: TableViewViewsSerialized | undefined, componentPermissionId: string): Promise<TableViewViewsSerialized | undefined>;

package/dist/base/table-view/internal/views.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeTableViewViews = serializeTableViewViews;
+exports.resolveTableViewViews = resolveTableViewViews;
+const permission_gate_1 = require("../../../internal/permission-gate");
+/**
+ * The views as the options carry them: their permission stays server-side.
+ *
+ * @internal
+ */
+function serializeTableViewViews(views) {
+    if (!views)
+        return undefined;
+    return {
+        ...views,
+        items: views.items.map(({ permission: _permission, permissionId: _permissionId, ...view }) => view),
+    };
+}
+/**
+ * The views served to one request: a view whose permission the caller lacks
+ * is left out. A default view left out falls back to the table's own state.
+ *
+ * @internal
+ */
+async function resolveTableViewViews(permissions, declared, serialized, componentPermissionId) {
+    if (!declared || !serialized)
+        return serialized;
+    const items = [];
+    for (const [index, view] of serialized.items.entries()) {
+        const gate = declared.items[index];
+        if (await (0, permission_gate_1.holdsPermissionGate)(permissions, gate, componentPermissionId)) {
+            items.push(view);
+        }
+    }
+    const hasDefault = items.some((view) => view.id === serialized.defaultView);
+    return {
+        ...serialized,
+        items,
+        defaultView: hasDefault ? serialized.defaultView : undefined,
+    };
+}
+//# sourceMappingURL=views.js.map

package/dist/base/table-view/internal/views.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"views.js","sourceRoot":"","sources":["../../../../src/base/table-view/internal/views.ts"],"names":[],"mappings":";;AAYA,0DAcC;AAQD,sDAoBC;AAtDD,uEAAwE;AAOxE;;;;GAIG;AACH,SAAgB,uBAAuB,CACrC,KAAwC;IAExC,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,OAAO;QACL,GAAG,KAAK;QACR,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CACpB,CAAC,EACC,UAAU,EAAE,WAAW,EACvB,YAAY,EAAE,aAAa,EAC3B,GAAG,IAAI,EACR,EAA2B,EAAE,CAAC,IAAI,CACpC;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,qBAAqB,CACzC,WAAwB,EACxB,QAA2C,EAC3C,UAAgD,EAChD,qBAA6B;IAE7B,IAAI,CAAC,QAAQ,IAAI,CAAC,UAAU;QAAE,OAAO,UAAU,CAAC;IAChD,MAAM,KAAK,GAA8B,EAAE,CAAC;IAC5C,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,MAAM,IAAA,qCAAmB,EAAC,WAAW,EAAE,IAAI,EAAE,qBAAqB,CAAC,EAAE,CAAC;YACxE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,UAAU,CAAC,WAAW,CAAC,CAAC;IAC5E,OAAO;QACL,GAAG,UAAU;QACb,KAAK;QACL,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;KAC7D,CAAC;AACJ,CAAC"}

package/dist/base/table-view/internal/writer.d.ts

@@ -0,0 +1,39 @@
+import type { PageMetadata } from "../../../page/metadata";
+import type { TableViewCapabilities } from "./factory-helpers";
+import type { TableViewAccess, TableViewMeta } from "../meta";
+import type { TableViewRowActionOptions } from "../options";
+/**
+ * Where the controller derivation that lifts the restriction is documented.
+ *
+ * @internal
+ */
+export declare const DERIVE_CONTROLLER_DOCS = "the DMS docs, \"Show the same data in two writing screens: derive the controller\" (docs/04.components/13.derived-controller.md)";
+/** What a TableView can write, from the routes and forms its controller offers. */
+type TableViewWriteCapabilities = Pick<TableViewCapabilities, "hasNewForm" | "hasEditForm" | "hasDeleteEndpoint" | "archiveMode">;
+/** The writing TableView a page mounted over a controller. */
+interface WritingTableViewClaim {
+    /** Permission id of the TableView. */
+    owner: string;
+    /** The registration of the page carrying it. */
+    page: PageMetadata;
+}
+/**
+ * `write` when the TableView enables at least one action that changes rows
+ * through the data routes -- add, duplicate, edit, delete, archive or
+ * restore -- and the controller offers it; `read` otherwise.
+ *
+ * @internal
+ */
+export declare function tableViewAccess(rowActions: TableViewRowActionOptions<any> | undefined, capabilities: TableViewWriteCapabilities): TableViewAccess;
+/**
+ * Record the writing TableView a page mounts over a controller, refusing a
+ * second one.
+ *
+ * A claim only stands in the way while the page registration holding it is
+ * live: a page re-registering after a hot reload replaces that registration,
+ * and a page that went away leaves the controller to the next writer.
+ *
+ * @internal
+ */
+export declare function claimWritingTableView(meta: TableViewMeta, controllerName: string, claim: WritingTableViewClaim): void;
+export {};

package/dist/base/table-view/internal/writer.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DERIVE_CONTROLLER_DOCS = void 0;
+exports.tableViewAccess = tableViewAccess;
+exports.claimWritingTableView = claimWritingTableView;
+const registry_1 = require("../../../page/internal/registry");
+const writer_1 = require("../writer");
+/**
+ * Where the controller derivation that lifts the restriction is documented.
+ *
+ * @internal
+ */
+exports.DERIVE_CONTROLLER_DOCS = 'the DMS docs, "Show the same data in two writing screens: derive the controller" (docs/04.components/13.derived-controller.md)';
+const isEnabled = (config) => config === undefined ||
+    (typeof config === "boolean" ? config : config.isEnabled !== false);
+/**
+ * `write` when the TableView enables at least one action that changes rows
+ * through the data routes -- add, duplicate, edit, delete, archive or
+ * restore -- and the controller offers it; `read` otherwise.
+ *
+ * @internal
+ */
+function tableViewAccess(rowActions, capabilities) {
+    const writes = [
+        capabilities.hasNewForm &&
+            (isEnabled(rowActions?.add) || isEnabled(rowActions?.duplicate)),
+        capabilities.hasEditForm && isEnabled(rowActions?.edit),
+        capabilities.hasDeleteEndpoint && isEnabled(rowActions?.delete),
+        capabilities.archiveMode &&
+            (isEnabled(rowActions?.archive) || isEnabled(rowActions?.restore)),
+    ];
+    return writes.some(Boolean) ? "write" : "read";
+}
+const claims = new WeakMap();
+/**
+ * Record the writing TableView a page mounts over a controller, refusing a
+ * second one.
+ *
+ * A claim only stands in the way while the page registration holding it is
+ * live: a page re-registering after a hot reload replaces that registration,
+ * and a page that went away leaves the controller to the next writer.
+ *
+ * @internal
+ */
+function claimWritingTableView(meta, controllerName, claim) {
+    const held = claims.get(meta);
+    const heldPageId = held?.page.pageInfo?.fullId ?? "";
+    if (held &&
+        held.owner !== claim.owner &&
+        registry_1.pageMetadataByFullId.get(heldPageId) === held.page) {
+        throw new writer_1.WritingTableViewConflictError(`[dms] TableView "${held.owner}" (page "${heldPageId}") and TableView "${claim.owner}" (page "${claim.page.pageInfo?.fullId}") both write through the data controller ${controllerName}. A data controller has one writing TableView: make the other one read-only (rowActions add, duplicate, edit and delete set to false, no archiveMode), or give it a controller of its own derived from ${controllerName} -- see ${exports.DERIVE_CONTROLLER_DOCS}.`);
+    }
+    claims.set(meta, claim);
+}
+//# sourceMappingURL=writer.js.map

package/dist/base/table-view/internal/writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.js","sourceRoot":"","sources":["../../../../src/base/table-view/internal/writer.ts"],"names":[],"mappings":";;;AAyCA,0CAaC;AAcD,sDAiBC;AApFD,8DAAuE;AAKvE,sCAA0D;AAE1D;;;;GAIG;AACU,QAAA,sBAAsB,GACjC,gIAAgI,CAAC;AAgBnI,MAAM,SAAS,GAAG,CAAC,MAA6C,EAAW,EAAE,CAC3E,MAAM,KAAK,SAAS;IACpB,CAAC,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC;AAEtE;;;;;;GAMG;AACH,SAAgB,eAAe,CAC7B,UAAsD,EACtD,YAAwC;IAExC,MAAM,MAAM,GAAG;QACb,YAAY,CAAC,UAAU;YACrB,CAAC,SAAS,CAAC,UAAU,EAAE,GAAG,CAAC,IAAI,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QAClE,YAAY,CAAC,WAAW,IAAI,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC;QACvD,YAAY,CAAC,iBAAiB,IAAI,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;QAC/D,YAAY,CAAC,WAAW;YACtB,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;KACrE,CAAC;IACF,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;AACjD,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,OAAO,EAAwC,CAAC;AAEnE;;;;;;;;;GASG;AACH,SAAgB,qBAAqB,CACnC,IAAmB,EACnB,cAAsB,EACtB,KAA4B;IAE5B,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,UAAU,GAAG,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,CAAC;IACrD,IACE,IAAI;QACJ,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK;QAC1B,+BAAoB,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,IAAI,EAClD,CAAC;QACD,MAAM,IAAI,sCAA6B,CACrC,oBAAoB,IAAI,CAAC,KAAK,YAAY,UAAU,qBAAqB,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,6CAA6C,cAAc,0MAA0M,cAAc,WAAW,8BAAsB,GAAG,CACnb,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC1B,CAAC"}