@cratis/scene.primereact 4.5.0 → 4.7.0

package/dist/esm/primeReactPackage.js

@@ -1,5 +1,6 @@
 import { PackageKind } from '@cratis/scene.model';
 import { primeReactComponents } from './primeReactComponents.js';
+import { primeReactDescriptors } from './primeReactDescriptors.js';
 import './theme/themePresets.js';
 import { primeReactThemes, primeReactThemeNames } from './theme/primeReactThemes.js';
 import './theme/primeReactThemePreset.js';
@@ -45,6 +46,7 @@ import 'react';
         'listBox',
         'selectButton',
         'checkbox',
+        'multiStateCheckbox',
         'radioButton',
         'toggleSwitch',
         'slider',
@@ -55,6 +57,8 @@ import 'react';
         'chips',
         'autoComplete',
         'treeSelect',
+        'editor',
+        'fileUpload',
         'button',
         'splitButton',
         'speedDial',
@@ -63,12 +67,15 @@ import 'react';
         'table',
         'column',
         'dataView',
+        'dataScroller',
         'tree',
+        'treeTable',
         'timeline',
         'paginator',
         'orderList',
         'pickList',
         'organizationChart',
+        'chart',
         'card',
         'panel',
         'accordion',
@@ -150,6 +157,7 @@ import 'react';
  */ const primeReactPackage = {
     manifest: primeReactPackageManifest,
     components: primeReactComponents,
+    descriptors: primeReactDescriptors,
     themes: primeReactThemes
 };
 

package/dist/esm/primeReactPackage.js.map

@@ -1 +1 @@
-{"version":3,"file":"primeReactPackage.js","sources":["../../primeReactPackage.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { PackageKind, ScenePackage } from '@cratis/scene.model';\nimport { ScenePackageBundle } from '@cratis/scene.react';\nimport { primeReactComponents } from './primeReactComponents';\nimport { primeReactThemeNames, primeReactThemes } from './theme';\n\n/**\n * The `PrimeReact` package's declaration - what a `ui profile` lists by name and what a\n * `PackageDependency` refers to.\n *\n * The component list is written out rather than derived from the registry, on purpose. A manifest is\n * read by Stage's build and Studio's design-time queries *without loading a single component*, so it has\n * to stand on its own as the statement of what this package offers. Keeping it as its own list is also\n * what gives `validatePackageBundle` something real to check: two independently maintained lists that\n * must agree, rather than one list compared against itself.\n */\nexport const primeReactPackageManifest: ScenePackage = {\n    name: 'PrimeReact',\n    version: '11.1.0',\n    kind: PackageKind.ComponentLibrary,\n\n    /**\n     * PrimeReact's own components need nothing from Tailwind - they are skinned by the `--p-*` custom\n     * properties the active `@primeuix/themes` preset emits. The dependency is here because *this\n     * package's wrappers* use Tailwind utility classes\n     * for the layout around them: the row a checkbox and its label sit on, the column a radio group\n     * stacks into, the grid a summary lays its pairs out in. A profile that activates this package\n     * without Tailwind renders those wrappers unstyled, so declaring it is what makes the profile picker\n     * offer Tailwind alongside PrimeReact instead of leaving the gap to be discovered on screen.\n     */\n    dependencies: [{ name: 'Tailwind' }],\n\n    components: [\n        'inputText', 'inputTextarea', 'inputNumber', 'password', 'floatLabel', 'iconField', 'dropdown', 'multiSelect',\n        'listBox', 'selectButton', 'checkbox', 'radioButton', 'toggleSwitch', 'slider', 'rating', 'knob', 'calendar', 'colorPicker',\n        'chips', 'autoComplete', 'treeSelect', 'button', 'splitButton', 'speedDial', 'buttonGroup', 'dataTable', 'table',\n        'column', 'dataView', 'tree', 'timeline', 'paginator', 'orderList', 'pickList', 'organizationChart',\n        'card', 'panel', 'accordion', 'fieldset', 'divider', 'splitter', 'scrollPanel', 'tabView', 'toolbar', 'stepper', 'dialog',\n        'confirmDialog', 'overlayPanel', 'sidebar', 'tooltip', 'menu', 'menubar', 'breadcrumb', 'tabMenu', 'steps', 'tieredMenu',\n        'panelMenu', 'contextMenu', 'megaMenu', 'dock', 'message', 'inlineMessage', 'toast', 'image', 'galleria', 'carousel', 'avatar',\n        'badge', 'chip', 'tag', 'progressBar', 'progressSpinner', 'skeleton', 'scrollTop', 'blockUI', 'inplace', 'terminal', 'text',\n        'title', 'field', 'section', 'summary', 'action',\n    ],\n\n    /**\n     * Empty, and it stays empty. A layout is an application's base navigational look - one per\n     * application - and choosing it is a decision about the product, not about which widgets are\n     * available. A component library supplies the vocabulary a layout is built *from*; a\n     * {@link PackageKind.Blueprint} package supplies the layout itself.\n     */\n    layouts: [],\n\n    /**\n     * Empty for the same reason `layouts` is. A screen template is a reusable page shape at module,\n     * feature or slice level - \"list with filters and a detail pane\" - and it is composed *out of* the\n     * names declared above. Shipping one here would mean this package had opinions about how a screen is\n     * arranged, which is a Blueprint's job and not a component library's.\n     */\n    screenTemplates: [],\n\n    /**\n     * Empty, as above: a dialog template is a reusable dialog shape, composed from these components by a\n     * Blueprint package rather than provided by the library the components come from.\n     */\n    dialogTemplates: [],\n\n    themes: primeReactThemeNames,\n\n    displayName: 'PrimeReact',\n    description: 'PrimeReact 11 components and PrimeTek\\'s @primeuix/themes presets, mapped onto Scene\\'s abstract component names.',\n    module: '@cratis/scene.primereact',\n    // PrimeReact 11 is PrimeTek's commercial PrimeUI, not MIT as version 10 was. The Community\n    // tier is free for eligible projects but still requires a key, so an author selecting this\n    // package needs to see the terms before they select it, not after a banner appears.\n    license: 'PrimeUI Community / Commercial',\n    licenseUrl: 'https://primeui.dev/licenses/community',\n};\n\n/**\n * The `PrimeReact` package as a loadable bundle - the manifest plus the React components and themes\n * behind the names it declares.\n */\nexport const primeReactPackage: ScenePackageBundle = {\n    manifest: primeReactPackageManifest,\n    components: primeReactComponents,\n    themes: primeReactThemes,\n};\n"],"names":["primeReactPackageManifest","name","version","kind","PackageKind","ComponentLibrary","dependencies","components","layouts","screenTemplates","dialogTemplates","themes","primeReactThemeNames","displayName","description","module","license","licenseUrl","primeReactPackage","manifest","primeReactComponents","primeReactThemes"],"mappings":";;;;;;;AAAA;AACA;AAOA;;;;;;;;;UAUaA,yBAAAA,GAA0C;IACnDC,IAAAA,EAAM,YAAA;IACNC,OAAAA,EAAS,QAAA;AACTC,IAAAA,IAAAA,EAAMC,YAAYC,gBAAgB;AAElC;;;;;;;;AAQC,QACDC,YAAAA,EAAc;AAAC,QAAA;YAAEL,IAAAA,EAAM;AAAW;AAAE,KAAA;IAEpCM,UAAAA,EAAY;AACR,QAAA,WAAA;AAAa,QAAA,eAAA;AAAiB,QAAA,aAAA;AAAe,QAAA,UAAA;AAAY,QAAA,YAAA;AAAc,QAAA,WAAA;AAAa,QAAA,UAAA;AAAY,QAAA,aAAA;AAChG,QAAA,SAAA;AAAW,QAAA,cAAA;AAAgB,QAAA,UAAA;AAAY,QAAA,aAAA;AAAe,QAAA,cAAA;AAAgB,QAAA,QAAA;AAAU,QAAA,QAAA;AAAU,QAAA,MAAA;AAAQ,QAAA,UAAA;AAAY,QAAA,aAAA;AAC9G,QAAA,OAAA;AAAS,QAAA,cAAA;AAAgB,QAAA,YAAA;AAAc,QAAA,QAAA;AAAU,QAAA,aAAA;AAAe,QAAA,WAAA;AAAa,QAAA,aAAA;AAAe,QAAA,WAAA;AAAa,QAAA,OAAA;AACzG,QAAA,QAAA;AAAU,QAAA,UAAA;AAAY,QAAA,MAAA;AAAQ,QAAA,UAAA;AAAY,QAAA,WAAA;AAAa,QAAA,WAAA;AAAa,QAAA,UAAA;AAAY,QAAA,mBAAA;AAChF,QAAA,MAAA;AAAQ,QAAA,OAAA;AAAS,QAAA,WAAA;AAAa,QAAA,UAAA;AAAY,QAAA,SAAA;AAAW,QAAA,UAAA;AAAY,QAAA,aAAA;AAAe,QAAA,SAAA;AAAW,QAAA,SAAA;AAAW,QAAA,SAAA;AAAW,QAAA,QAAA;AACjH,QAAA,eAAA;AAAiB,QAAA,cAAA;AAAgB,QAAA,SAAA;AAAW,QAAA,SAAA;AAAW,QAAA,MAAA;AAAQ,QAAA,SAAA;AAAW,QAAA,YAAA;AAAc,QAAA,SAAA;AAAW,QAAA,OAAA;AAAS,QAAA,YAAA;AAC5G,QAAA,WAAA;AAAa,QAAA,aAAA;AAAe,QAAA,UAAA;AAAY,QAAA,MAAA;AAAQ,QAAA,SAAA;AAAW,QAAA,eAAA;AAAiB,QAAA,OAAA;AAAS,QAAA,OAAA;AAAS,QAAA,UAAA;AAAY,QAAA,UAAA;AAAY,QAAA,QAAA;AACtH,QAAA,OAAA;AAAS,QAAA,MAAA;AAAQ,QAAA,KAAA;AAAO,QAAA,aAAA;AAAe,QAAA,iBAAA;AAAmB,QAAA,UAAA;AAAY,QAAA,WAAA;AAAa,QAAA,SAAA;AAAW,QAAA,SAAA;AAAW,QAAA,UAAA;AAAY,QAAA,MAAA;AACrH,QAAA,OAAA;AAAS,QAAA,OAAA;AAAS,QAAA,SAAA;AAAW,QAAA,SAAA;AAAW,QAAA;AAC3C,KAAA;AAED;;;;;AAKC,QACDC,SAAS,EAAE;AAEX;;;;;AAKC,QACDC,iBAAiB,EAAE;AAEnB;;;AAGC,QACDC,iBAAiB,EAAE;IAEnBC,MAAAA,EAAQC,oBAAAA;IAERC,WAAAA,EAAa,YAAA;IACbC,WAAAA,EAAa,mHAAA;IACbC,MAAAA,EAAQ,0BAAA;;;;IAIRC,OAAAA,EAAS,gCAAA;IACTC,UAAAA,EAAY;AAChB;AAEA;;;UAIaC,iBAAAA,GAAwC;IACjDC,QAAAA,EAAUnB,yBAAAA;IACVO,UAAAA,EAAYa,oBAAAA;IACZT,MAAAA,EAAQU;AACZ;;"}
+{"version":3,"file":"primeReactPackage.js","sources":["../../primeReactPackage.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { PackageKind, ScenePackage } from '@cratis/scene.model';\nimport { ScenePackageBundle } from '@cratis/scene.react';\nimport { primeReactComponents } from './primeReactComponents';\nimport { primeReactDescriptors } from './primeReactDescriptors';\nimport { primeReactThemeNames, primeReactThemes } from './theme';\n\n/**\n * The `PrimeReact` package's declaration - what a `ui profile` lists by name and what a\n * `PackageDependency` refers to.\n *\n * The component list is written out rather than derived from the registry, on purpose. A manifest is\n * read by Stage's build and Studio's design-time queries *without loading a single component*, so it has\n * to stand on its own as the statement of what this package offers. Keeping it as its own list is also\n * what gives `validatePackageBundle` something real to check: two independently maintained lists that\n * must agree, rather than one list compared against itself.\n */\nexport const primeReactPackageManifest: ScenePackage = {\n    name: 'PrimeReact',\n    version: '11.1.0',\n    kind: PackageKind.ComponentLibrary,\n\n    /**\n     * PrimeReact's own components need nothing from Tailwind - they are skinned by the `--p-*` custom\n     * properties the active `@primeuix/themes` preset emits. The dependency is here because *this\n     * package's wrappers* use Tailwind utility classes\n     * for the layout around them: the row a checkbox and its label sit on, the column a radio group\n     * stacks into, the grid a summary lays its pairs out in. A profile that activates this package\n     * without Tailwind renders those wrappers unstyled, so declaring it is what makes the profile picker\n     * offer Tailwind alongside PrimeReact instead of leaving the gap to be discovered on screen.\n     */\n    dependencies: [{ name: 'Tailwind' }],\n\n    components: [\n        'inputText', 'inputTextarea', 'inputNumber', 'password', 'floatLabel', 'iconField', 'dropdown', 'multiSelect',\n        'listBox', 'selectButton', 'checkbox', 'multiStateCheckbox', 'radioButton', 'toggleSwitch', 'slider', 'rating', 'knob', 'calendar', 'colorPicker',\n        'chips', 'autoComplete', 'treeSelect', 'editor', 'fileUpload', 'button', 'splitButton', 'speedDial', 'buttonGroup', 'dataTable', 'table',\n        'column', 'dataView', 'dataScroller', 'tree', 'treeTable', 'timeline', 'paginator', 'orderList', 'pickList', 'organizationChart', 'chart',\n        'card', 'panel', 'accordion', 'fieldset', 'divider', 'splitter', 'scrollPanel', 'tabView', 'toolbar', 'stepper', 'dialog',\n        'confirmDialog', 'overlayPanel', 'sidebar', 'tooltip', 'menu', 'menubar', 'breadcrumb', 'tabMenu', 'steps', 'tieredMenu',\n        'panelMenu', 'contextMenu', 'megaMenu', 'dock', 'message', 'inlineMessage', 'toast', 'image', 'galleria', 'carousel', 'avatar',\n        'badge', 'chip', 'tag', 'progressBar', 'progressSpinner', 'skeleton', 'scrollTop', 'blockUI', 'inplace', 'terminal', 'text',\n        'title', 'field', 'section', 'summary', 'action',\n    ],\n\n    /**\n     * Empty, and it stays empty. A layout is an application's base navigational look - one per\n     * application - and choosing it is a decision about the product, not about which widgets are\n     * available. A component library supplies the vocabulary a layout is built *from*; a\n     * {@link PackageKind.Blueprint} package supplies the layout itself.\n     */\n    layouts: [],\n\n    /**\n     * Empty for the same reason `layouts` is. A screen template is a reusable page shape at module,\n     * feature or slice level - \"list with filters and a detail pane\" - and it is composed *out of* the\n     * names declared above. Shipping one here would mean this package had opinions about how a screen is\n     * arranged, which is a Blueprint's job and not a component library's.\n     */\n    screenTemplates: [],\n\n    /**\n     * Empty, as above: a dialog template is a reusable dialog shape, composed from these components by a\n     * Blueprint package rather than provided by the library the components come from.\n     */\n    dialogTemplates: [],\n\n    themes: primeReactThemeNames,\n\n    displayName: 'PrimeReact',\n    description: 'PrimeReact 11 components and PrimeTek\\'s @primeuix/themes presets, mapped onto Scene\\'s abstract component names.',\n    module: '@cratis/scene.primereact',\n    // PrimeReact 11 is PrimeTek's commercial PrimeUI, not MIT as version 10 was. The Community\n    // tier is free for eligible projects but still requires a key, so an author selecting this\n    // package needs to see the terms before they select it, not after a banner appears.\n    license: 'PrimeUI Community / Commercial',\n    licenseUrl: 'https://primeui.dev/licenses/community',\n};\n\n/**\n * The `PrimeReact` package as a loadable bundle - the manifest plus the React components and themes\n * behind the names it declares.\n */\nexport const primeReactPackage: ScenePackageBundle = {\n    manifest: primeReactPackageManifest,\n    components: primeReactComponents,\n    descriptors: primeReactDescriptors,\n    themes: primeReactThemes,\n};\n"],"names":["primeReactPackageManifest","name","version","kind","PackageKind","ComponentLibrary","dependencies","components","layouts","screenTemplates","dialogTemplates","themes","primeReactThemeNames","displayName","description","module","license","licenseUrl","primeReactPackage","manifest","primeReactComponents","descriptors","primeReactDescriptors","primeReactThemes"],"mappings":";;;;;;;;AAAA;AACA;AAQA;;;;;;;;;UAUaA,yBAAAA,GAA0C;IACnDC,IAAAA,EAAM,YAAA;IACNC,OAAAA,EAAS,QAAA;AACTC,IAAAA,IAAAA,EAAMC,YAAYC,gBAAgB;AAElC;;;;;;;;AAQC,QACDC,YAAAA,EAAc;AAAC,QAAA;YAAEL,IAAAA,EAAM;AAAW;AAAE,KAAA;IAEpCM,UAAAA,EAAY;AACR,QAAA,WAAA;AAAa,QAAA,eAAA;AAAiB,QAAA,aAAA;AAAe,QAAA,UAAA;AAAY,QAAA,YAAA;AAAc,QAAA,WAAA;AAAa,QAAA,UAAA;AAAY,QAAA,aAAA;AAChG,QAAA,SAAA;AAAW,QAAA,cAAA;AAAgB,QAAA,UAAA;AAAY,QAAA,oBAAA;AAAsB,QAAA,aAAA;AAAe,QAAA,cAAA;AAAgB,QAAA,QAAA;AAAU,QAAA,QAAA;AAAU,QAAA,MAAA;AAAQ,QAAA,UAAA;AAAY,QAAA,aAAA;AACpI,QAAA,OAAA;AAAS,QAAA,cAAA;AAAgB,QAAA,YAAA;AAAc,QAAA,QAAA;AAAU,QAAA,YAAA;AAAc,QAAA,QAAA;AAAU,QAAA,aAAA;AAAe,QAAA,WAAA;AAAa,QAAA,aAAA;AAAe,QAAA,WAAA;AAAa,QAAA,OAAA;AACjI,QAAA,QAAA;AAAU,QAAA,UAAA;AAAY,QAAA,cAAA;AAAgB,QAAA,MAAA;AAAQ,QAAA,WAAA;AAAa,QAAA,UAAA;AAAY,QAAA,WAAA;AAAa,QAAA,WAAA;AAAa,QAAA,UAAA;AAAY,QAAA,mBAAA;AAAqB,QAAA,OAAA;AAClI,QAAA,MAAA;AAAQ,QAAA,OAAA;AAAS,QAAA,WAAA;AAAa,QAAA,UAAA;AAAY,QAAA,SAAA;AAAW,QAAA,UAAA;AAAY,QAAA,aAAA;AAAe,QAAA,SAAA;AAAW,QAAA,SAAA;AAAW,QAAA,SAAA;AAAW,QAAA,QAAA;AACjH,QAAA,eAAA;AAAiB,QAAA,cAAA;AAAgB,QAAA,SAAA;AAAW,QAAA,SAAA;AAAW,QAAA,MAAA;AAAQ,QAAA,SAAA;AAAW,QAAA,YAAA;AAAc,QAAA,SAAA;AAAW,QAAA,OAAA;AAAS,QAAA,YAAA;AAC5G,QAAA,WAAA;AAAa,QAAA,aAAA;AAAe,QAAA,UAAA;AAAY,QAAA,MAAA;AAAQ,QAAA,SAAA;AAAW,QAAA,eAAA;AAAiB,QAAA,OAAA;AAAS,QAAA,OAAA;AAAS,QAAA,UAAA;AAAY,QAAA,UAAA;AAAY,QAAA,QAAA;AACtH,QAAA,OAAA;AAAS,QAAA,MAAA;AAAQ,QAAA,KAAA;AAAO,QAAA,aAAA;AAAe,QAAA,iBAAA;AAAmB,QAAA,UAAA;AAAY,QAAA,WAAA;AAAa,QAAA,SAAA;AAAW,QAAA,SAAA;AAAW,QAAA,UAAA;AAAY,QAAA,MAAA;AACrH,QAAA,OAAA;AAAS,QAAA,OAAA;AAAS,QAAA,SAAA;AAAW,QAAA,SAAA;AAAW,QAAA;AAC3C,KAAA;AAED;;;;;AAKC,QACDC,SAAS,EAAE;AAEX;;;;;AAKC,QACDC,iBAAiB,EAAE;AAEnB;;;AAGC,QACDC,iBAAiB,EAAE;IAEnBC,MAAAA,EAAQC,oBAAAA;IAERC,WAAAA,EAAa,YAAA;IACbC,WAAAA,EAAa,mHAAA;IACbC,MAAAA,EAAQ,0BAAA;;;;IAIRC,OAAAA,EAAS,gCAAA;IACTC,UAAAA,EAAY;AAChB;AAEA;;;UAIaC,iBAAAA,GAAwC;IACjDC,QAAAA,EAAUnB,yBAAAA;IACVO,UAAAA,EAAYa,oBAAAA;IACZC,WAAAA,EAAaC,qBAAAA;IACbX,MAAAA,EAAQY;AACZ;;"}

package/dist/esm/properties.d.ts

@@ -10,6 +10,7 @@ export declare function numberProperty(element: SceneElement, name: string, fall
 export declare function arrayProperty(element: SceneElement, name: string): unknown[];
 export declare function stringArrayProperty(element: SceneElement, name: string): string[];
 export declare function recordArrayProperty(element: SceneElement, name: string): Record<string, unknown>[];
+export declare function recordProperty(element: SceneElement, name: string): Record<string, unknown> | undefined;
 export declare function optionsProperty(element: SceneElement, name: string): SelectOption[];
 export declare function severityProperty(element: SceneElement, name: string): PrimeSeverity | undefined;
 export declare function severityProperty(element: SceneElement, name: string, fallback: PrimeSeverity): PrimeSeverity;

package/dist/esm/properties.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"properties.d.ts","sourceRoot":"","sources":["../../properties.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAoB9C,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AACxF,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;AAc9F,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAC1F,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC;AAiBjG,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AACxF,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;AAiB9F,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAG5E;AASD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEjF;AAYD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAIlG;AAcD,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CAiBnF;AAoBD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;AACjG,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,aAAa,CAAC"}
+{"version":3,"file":"properties.d.ts","sourceRoot":"","sources":["../../properties.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAoB9C,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AACxF,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;AAc9F,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAC1F,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC;AAiBjG,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AACxF,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;AAiB9F,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAG5E;AASD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEjF;AAYD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAIlG;AASD,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAKvG;AAcD,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CAiBnF;AAoBD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;AACjG,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,aAAa,CAAC"}

package/dist/esm/properties.js

@@ -56,6 +56,16 @@ function numberProperty(element, name, fallback) {
  */ function recordArrayProperty(element, name) {
     return arrayProperty(element, name).filter((entry)=>typeof entry === 'object' && entry !== undefined && entry !== null && !Array.isArray(entry));
 }
+/**
+ * Reads one structured value off a Scene element.
+ *
+ * Chart data and options intentionally stay as authored objects: these adapters pass their vocabulary to
+ * their underlying library instead of choosing a partial Scene-owned chart schema that would discard
+ * future Chart.js fields during a legacy migration.
+ */ function recordProperty(element, name) {
+    const value = element.properties[name];
+    return typeof value === 'object' && value !== undefined && value !== null && !Array.isArray(value) ? value : undefined;
+}
 /**
  * Reads a selection component's options off a Scene element, normalizing both shapes a screen may use.
  *
@@ -94,5 +104,5 @@ function severityProperty(element, name, fallback) {
     return severities.includes(translated) ? translated : fallback;
 }
 
-export { arrayProperty, booleanProperty, numberProperty, optionsProperty, recordArrayProperty, severityProperty, stringArrayProperty, stringProperty };
+export { arrayProperty, booleanProperty, numberProperty, optionsProperty, recordArrayProperty, recordProperty, severityProperty, stringArrayProperty, stringProperty };
 //# sourceMappingURL=properties.js.map

package/dist/esm/properties.js.map

@@ -1 +1 @@
-{"version":3,"file":"properties.js","sources":["../../properties.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { SceneElement } from '@cratis/scene.model';\nimport { PrimeSeverity } from './PrimeSeverity';\nimport { SelectOption } from './SelectOption';\n\n/** Every severity PrimeReact 11 knows, so an unrecognized one can fall back rather than reach a component. */\nconst severities: PrimeSeverity[] = ['secondary', 'info', 'success', 'warn', 'danger', 'help', 'contrast'];\n\n/**\n * Reads a string configuration value off a Scene element.\n *\n * `SceneElement.properties` is `Record<string, unknown>` because a screen's properties come from\n * authored model data, not from a compiler that knows this package's expectations. Every adapter\n * therefore has to narrow before it can use a value, and doing that with a cast would defeat the point -\n * a mistyped property would sail through and blow up inside PrimeReact instead of quietly falling back\n * here. These helpers are the single narrowing point, so a wrong type behaves exactly like an absent\n * one everywhere.\n *\n * @param element The element whose properties to read.\n * @param name The property name.\n * @param fallback The value to use when the property is missing or is not a string.\n * @returns The string value, or `fallback` (`undefined` when none was given).\n */\nexport function stringProperty(element: SceneElement, name: string): string | undefined;\nexport function stringProperty(element: SceneElement, name: string, fallback: string): string;\nexport function stringProperty(element: SceneElement, name: string, fallback?: string): string | undefined {\n    const value = element.properties[name];\n    return typeof value === 'string' ? value : fallback;\n}\n\n/**\n * Reads a boolean configuration value off a Scene element.\n *\n * @param element The element whose properties to read.\n * @param name The property name.\n * @param fallback The value to use when the property is missing or is not a boolean.\n * @returns The boolean value, or `fallback` (`undefined` when none was given).\n */\nexport function booleanProperty(element: SceneElement, name: string): boolean | undefined;\nexport function booleanProperty(element: SceneElement, name: string, fallback: boolean): boolean;\nexport function booleanProperty(element: SceneElement, name: string, fallback?: boolean): boolean | undefined {\n    const value = element.properties[name];\n    return typeof value === 'boolean' ? value : fallback;\n}\n\n/**\n * Reads a numeric configuration value off a Scene element.\n *\n * `NaN` is rejected alongside non-numbers: it is a number by `typeof` but never a usable size, count or\n * bound, and letting it through would surface as an unexplained blank component rather than a fallback.\n *\n * @param element The element whose properties to read.\n * @param name The property name.\n * @param fallback The value to use when the property is missing or is not a usable number.\n * @returns The numeric value, or `fallback` (`undefined` when none was given).\n */\nexport function numberProperty(element: SceneElement, name: string): number | undefined;\nexport function numberProperty(element: SceneElement, name: string, fallback: number): number;\nexport function numberProperty(element: SceneElement, name: string, fallback?: number): number | undefined {\n    const value = element.properties[name];\n    return typeof value === 'number' && !Number.isNaN(value) ? value : fallback;\n}\n\n/**\n * Reads an array configuration value off a Scene element, as raw entries.\n *\n * Always returns an array - an absent or wrongly typed property becomes an empty one - because every\n * caller is about to map over it, and a component rendering nothing is a far better failure than one\n * throwing on `undefined.map`.\n *\n * @param element The element whose properties to read.\n * @param name The property name.\n * @returns The entries, or an empty array when the property is missing or is not an array.\n */\nexport function arrayProperty(element: SceneElement, name: string): unknown[] {\n    const value = element.properties[name];\n    return Array.isArray(value) ? value : [];\n}\n\n/**\n * Reads an array of strings off a Scene element, dropping any entry that is not one.\n *\n * @param element The element whose properties to read.\n * @param name The property name.\n * @returns The string entries, in order.\n */\nexport function stringArrayProperty(element: SceneElement, name: string): string[] {\n    return arrayProperty(element, name).filter((entry): entry is string => typeof entry === 'string');\n}\n\n/**\n * Reads an array of objects off a Scene element, dropping any entry that is not one.\n *\n * This is the shape row data, column definitions and menu items all arrive in, so it is the common\n * bottom step every structured reader in this package builds on.\n *\n * @param element The element whose properties to read.\n * @param name The property name.\n * @returns The object entries, in order.\n */\nexport function recordArrayProperty(element: SceneElement, name: string): Record<string, unknown>[] {\n    return arrayProperty(element, name).filter(\n        (entry): entry is Record<string, unknown> => typeof entry === 'object' && entry !== undefined && entry !== null && !Array.isArray(entry)\n    );\n}\n\n/**\n * Reads a selection component's options off a Scene element, normalizing both shapes a screen may use.\n *\n * A screen written by hand tends to say `options: ['Draft', 'Published']`; one generated from a model\n * says `options: [{ label: 'Draft', value: 'draft' }]`. Both are reasonable, so both are accepted and\n * flattened to {@link SelectOption} - an entry with only a label uses that label as its value, which is\n * exactly what the shorthand means.\n *\n * @param element The element whose properties to read.\n * @param name The property name.\n * @returns The normalized options, in order, skipping entries that carry no usable label.\n */\nexport function optionsProperty(element: SceneElement, name: string): SelectOption[] {\n    const options: SelectOption[] = [];\n    for (const entry of arrayProperty(element, name)) {\n        if (typeof entry === 'string') {\n            options.push({ label: entry, value: entry });\n            continue;\n        }\n\n        if (typeof entry !== 'object' || entry === undefined || entry === null || Array.isArray(entry)) continue;\n\n        const record = entry as Record<string, unknown>;\n        const label = typeof record.label === 'string' ? record.label : undefined;\n        const value = typeof record.value === 'string' ? record.value : label;\n        if (label !== undefined && value !== undefined) options.push({ label, value });\n    }\n\n    return options;\n}\n\n/**\n * Reads a severity off a Scene element, in the vocabulary PrimeReact 11 uses.\n *\n * This exists because PrimeReact renamed one severity between v10 and v11 - `warning` became `warn` - and\n * the rename is silent in the worst way. The v11 prop types are string-literal unions, so an unchanged\n * `warning` does not fail to compile when it arrives through `stringProperty`; it simply falls through to\n * the default color, and a screen authored against the old vocabulary loses its warning styling without\n * anything reporting a problem.\n *\n * Six adapters need that translation, which is five too many to leave copied. Putting it here also keeps\n * the promise the rest of this file makes: properties are narrowed in exactly one place, so an\n * unrecognized value behaves the same way everywhere - like an absent one, rather than like a broken one.\n *\n * @param element The element whose properties to read.\n * @param name The property name, `severity` for every current caller.\n * @param fallback The severity to use when the property is missing or is not one PrimeReact knows.\n * @returns The severity, or `fallback` (`undefined` when none was given).\n */\nexport function severityProperty(element: SceneElement, name: string): PrimeSeverity | undefined;\nexport function severityProperty(element: SceneElement, name: string, fallback: PrimeSeverity): PrimeSeverity;\nexport function severityProperty(element: SceneElement, name: string, fallback?: PrimeSeverity): PrimeSeverity | undefined {\n    const authored = stringProperty(element, name);\n    const translated = authored === 'warning' ? 'warn' : authored;\n    return severities.includes(translated as PrimeSeverity) ? (translated as PrimeSeverity) : fallback;\n}\n"],"names":["severities","stringProperty","element","name","fallback","value","properties","booleanProperty","numberProperty","Number","isNaN","arrayProperty","Array","isArray","stringArrayProperty","filter","entry","recordArrayProperty","undefined","optionsProperty","options","push","label","record","severityProperty","authored","translated","includes"],"mappings":"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"}
+{"version":3,"file":"properties.js","sources":["../../properties.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { SceneElement } from '@cratis/scene.model';\nimport { PrimeSeverity } from './PrimeSeverity';\nimport { SelectOption } from './SelectOption';\n\n/** Every severity PrimeReact 11 knows, so an unrecognized one can fall back rather than reach a component. */\nconst severities: PrimeSeverity[] = ['secondary', 'info', 'success', 'warn', 'danger', 'help', 'contrast'];\n\n/**\n * Reads a string configuration value off a Scene element.\n *\n * `SceneElement.properties` is `Record<string, unknown>` because a screen's properties come from\n * authored model data, not from a compiler that knows this package's expectations. Every adapter\n * therefore has to narrow before it can use a value, and doing that with a cast would defeat the point -\n * a mistyped property would sail through and blow up inside PrimeReact instead of quietly falling back\n * here. These helpers are the single narrowing point, so a wrong type behaves exactly like an absent\n * one everywhere.\n *\n * @param element The element whose properties to read.\n * @param name The property name.\n * @param fallback The value to use when the property is missing or is not a string.\n * @returns The string value, or `fallback` (`undefined` when none was given).\n */\nexport function stringProperty(element: SceneElement, name: string): string | undefined;\nexport function stringProperty(element: SceneElement, name: string, fallback: string): string;\nexport function stringProperty(element: SceneElement, name: string, fallback?: string): string | undefined {\n    const value = element.properties[name];\n    return typeof value === 'string' ? value : fallback;\n}\n\n/**\n * Reads a boolean configuration value off a Scene element.\n *\n * @param element The element whose properties to read.\n * @param name The property name.\n * @param fallback The value to use when the property is missing or is not a boolean.\n * @returns The boolean value, or `fallback` (`undefined` when none was given).\n */\nexport function booleanProperty(element: SceneElement, name: string): boolean | undefined;\nexport function booleanProperty(element: SceneElement, name: string, fallback: boolean): boolean;\nexport function booleanProperty(element: SceneElement, name: string, fallback?: boolean): boolean | undefined {\n    const value = element.properties[name];\n    return typeof value === 'boolean' ? value : fallback;\n}\n\n/**\n * Reads a numeric configuration value off a Scene element.\n *\n * `NaN` is rejected alongside non-numbers: it is a number by `typeof` but never a usable size, count or\n * bound, and letting it through would surface as an unexplained blank component rather than a fallback.\n *\n * @param element The element whose properties to read.\n * @param name The property name.\n * @param fallback The value to use when the property is missing or is not a usable number.\n * @returns The numeric value, or `fallback` (`undefined` when none was given).\n */\nexport function numberProperty(element: SceneElement, name: string): number | undefined;\nexport function numberProperty(element: SceneElement, name: string, fallback: number): number;\nexport function numberProperty(element: SceneElement, name: string, fallback?: number): number | undefined {\n    const value = element.properties[name];\n    return typeof value === 'number' && !Number.isNaN(value) ? value : fallback;\n}\n\n/**\n * Reads an array configuration value off a Scene element, as raw entries.\n *\n * Always returns an array - an absent or wrongly typed property becomes an empty one - because every\n * caller is about to map over it, and a component rendering nothing is a far better failure than one\n * throwing on `undefined.map`.\n *\n * @param element The element whose properties to read.\n * @param name The property name.\n * @returns The entries, or an empty array when the property is missing or is not an array.\n */\nexport function arrayProperty(element: SceneElement, name: string): unknown[] {\n    const value = element.properties[name];\n    return Array.isArray(value) ? value : [];\n}\n\n/**\n * Reads an array of strings off a Scene element, dropping any entry that is not one.\n *\n * @param element The element whose properties to read.\n * @param name The property name.\n * @returns The string entries, in order.\n */\nexport function stringArrayProperty(element: SceneElement, name: string): string[] {\n    return arrayProperty(element, name).filter((entry): entry is string => typeof entry === 'string');\n}\n\n/**\n * Reads an array of objects off a Scene element, dropping any entry that is not one.\n *\n * This is the shape row data, column definitions and menu items all arrive in, so it is the common\n * bottom step every structured reader in this package builds on.\n *\n * @param element The element whose properties to read.\n * @param name The property name.\n * @returns The object entries, in order.\n */\nexport function recordArrayProperty(element: SceneElement, name: string): Record<string, unknown>[] {\n    return arrayProperty(element, name).filter(\n        (entry): entry is Record<string, unknown> => typeof entry === 'object' && entry !== undefined && entry !== null && !Array.isArray(entry)\n    );\n}\n\n/**\n * Reads one structured value off a Scene element.\n *\n * Chart data and options intentionally stay as authored objects: these adapters pass their vocabulary to\n * their underlying library instead of choosing a partial Scene-owned chart schema that would discard\n * future Chart.js fields during a legacy migration.\n */\nexport function recordProperty(element: SceneElement, name: string): Record<string, unknown> | undefined {\n    const value = element.properties[name];\n    return typeof value === 'object' && value !== undefined && value !== null && !Array.isArray(value)\n        ? value as Record<string, unknown>\n        : undefined;\n}\n\n/**\n * Reads a selection component's options off a Scene element, normalizing both shapes a screen may use.\n *\n * A screen written by hand tends to say `options: ['Draft', 'Published']`; one generated from a model\n * says `options: [{ label: 'Draft', value: 'draft' }]`. Both are reasonable, so both are accepted and\n * flattened to {@link SelectOption} - an entry with only a label uses that label as its value, which is\n * exactly what the shorthand means.\n *\n * @param element The element whose properties to read.\n * @param name The property name.\n * @returns The normalized options, in order, skipping entries that carry no usable label.\n */\nexport function optionsProperty(element: SceneElement, name: string): SelectOption[] {\n    const options: SelectOption[] = [];\n    for (const entry of arrayProperty(element, name)) {\n        if (typeof entry === 'string') {\n            options.push({ label: entry, value: entry });\n            continue;\n        }\n\n        if (typeof entry !== 'object' || entry === undefined || entry === null || Array.isArray(entry)) continue;\n\n        const record = entry as Record<string, unknown>;\n        const label = typeof record.label === 'string' ? record.label : undefined;\n        const value = typeof record.value === 'string' ? record.value : label;\n        if (label !== undefined && value !== undefined) options.push({ label, value });\n    }\n\n    return options;\n}\n\n/**\n * Reads a severity off a Scene element, in the vocabulary PrimeReact 11 uses.\n *\n * This exists because PrimeReact renamed one severity between v10 and v11 - `warning` became `warn` - and\n * the rename is silent in the worst way. The v11 prop types are string-literal unions, so an unchanged\n * `warning` does not fail to compile when it arrives through `stringProperty`; it simply falls through to\n * the default color, and a screen authored against the old vocabulary loses its warning styling without\n * anything reporting a problem.\n *\n * Six adapters need that translation, which is five too many to leave copied. Putting it here also keeps\n * the promise the rest of this file makes: properties are narrowed in exactly one place, so an\n * unrecognized value behaves the same way everywhere - like an absent one, rather than like a broken one.\n *\n * @param element The element whose properties to read.\n * @param name The property name, `severity` for every current caller.\n * @param fallback The severity to use when the property is missing or is not one PrimeReact knows.\n * @returns The severity, or `fallback` (`undefined` when none was given).\n */\nexport function severityProperty(element: SceneElement, name: string): PrimeSeverity | undefined;\nexport function severityProperty(element: SceneElement, name: string, fallback: PrimeSeverity): PrimeSeverity;\nexport function severityProperty(element: SceneElement, name: string, fallback?: PrimeSeverity): PrimeSeverity | undefined {\n    const authored = stringProperty(element, name);\n    const translated = authored === 'warning' ? 'warn' : authored;\n    return severities.includes(translated as PrimeSeverity) ? (translated as PrimeSeverity) : fallback;\n}\n"],"names":["severities","stringProperty","element","name","fallback","value","properties","booleanProperty","numberProperty","Number","isNaN","arrayProperty","Array","isArray","stringArrayProperty","filter","entry","recordArrayProperty","undefined","recordProperty","optionsProperty","options","push","label","record","severityProperty","authored","translated","includes"],"mappings":"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"}

package/dist/esm/resolveEnumeration.d.ts

@@ -0,0 +1,3 @@
+import { EnumerationResolution } from './EnumerationResolution';
+export declare function resolveEnumeration<TMember extends string>(property: string, value: unknown, members: Record<string, TMember>, fallback: TMember): EnumerationResolution<TMember>;
+//# sourceMappingURL=resolveEnumeration.d.ts.map

package/dist/esm/resolveEnumeration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveEnumeration.d.ts","sourceRoot":"","sources":["../../resolveEnumeration.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAsBhE,wBAAgB,kBAAkB,CAAC,OAAO,SAAS,MAAM,EACrD,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,EAAE,OAAO,GAClB,qBAAqB,CAAC,OAAO,CAAC,CAmBhC"}

package/dist/esm/resolveEnumeration.js

@@ -0,0 +1,53 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Resolves an authored value to a member of one of this package's string enums.
+ *
+ * Three forms are accepted, and the stored value is never rewritten:
+ * - the canonical string value the enum declares (`'checkbox'`), which new documents use;
+ * - the ordinal of the original .NET enum (`3`), which migrated documents carry. The ordinal is the member's
+ *   position in declaration order, so that order is part of the stored-data contract and must not change;
+ * - the .NET member name in its original Pascal case (`'Checkbox'`), which a JSON serialization of that enum
+ *   produces.
+ *
+ * An absent value is the one default. Anything else - an out-of-range or fractional ordinal, a numeric
+ * string, a differently cased name, `null` - resolves to a finding with a message, because the intended
+ * behavior cannot be known and a silent fallback hides a mistyped document.
+ *
+ * @param property The property name, used in the message.
+ * @param value The authored value.
+ * @param members The enum object.
+ * @param fallback The member an absent value means.
+ * @returns The resolved member, or the finding.
+ */ function resolveEnumeration(property, value, members, fallback) {
+    if (value === undefined) return {
+        isValid: true,
+        value: fallback
+    };
+    const canonical = Object.values(members);
+    if (typeof value === 'number' && Number.isInteger(value) && value >= 0 && value < canonical.length) {
+        return {
+            isValid: true,
+            value: canonical[value]
+        };
+    }
+    if (typeof value === 'string') {
+        if (canonical.includes(value)) return {
+            isValid: true,
+            value: value
+        };
+        if (Object.hasOwn(members, value)) return {
+            isValid: true,
+            value: members[value]
+        };
+    }
+    const shown = typeof value === 'string' ? `'${value}'` : JSON.stringify(value) ?? String(value);
+    return {
+        isValid: false,
+        value,
+        message: `Unsupported ${property} ${shown}. Use one of ${canonical.join(', ')}, or a legacy ordinal from 0 to ${canonical.length - 1}.`
+    };
+}
+
+export { resolveEnumeration };
+//# sourceMappingURL=resolveEnumeration.js.map

package/dist/esm/resolveEnumeration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveEnumeration.js","sources":["../../resolveEnumeration.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { EnumerationResolution } from './EnumerationResolution';\n\n/**\n * Resolves an authored value to a member of one of this package's string enums.\n *\n * Three forms are accepted, and the stored value is never rewritten:\n * - the canonical string value the enum declares (`'checkbox'`), which new documents use;\n * - the ordinal of the original .NET enum (`3`), which migrated documents carry. The ordinal is the member's\n *   position in declaration order, so that order is part of the stored-data contract and must not change;\n * - the .NET member name in its original Pascal case (`'Checkbox'`), which a JSON serialization of that enum\n *   produces.\n *\n * An absent value is the one default. Anything else - an out-of-range or fractional ordinal, a numeric\n * string, a differently cased name, `null` - resolves to a finding with a message, because the intended\n * behavior cannot be known and a silent fallback hides a mistyped document.\n *\n * @param property The property name, used in the message.\n * @param value The authored value.\n * @param members The enum object.\n * @param fallback The member an absent value means.\n * @returns The resolved member, or the finding.\n */\nexport function resolveEnumeration<TMember extends string>(\n    property: string,\n    value: unknown,\n    members: Record<string, TMember>,\n    fallback: TMember\n): EnumerationResolution<TMember> {\n    if (value === undefined) return { isValid: true, value: fallback };\n\n    const canonical = Object.values(members);\n    if (typeof value === 'number' && Number.isInteger(value) && value >= 0 && value < canonical.length) {\n        return { isValid: true, value: canonical[value] };\n    }\n\n    if (typeof value === 'string') {\n        if (canonical.includes(value as TMember)) return { isValid: true, value: value as TMember };\n        if (Object.hasOwn(members, value)) return { isValid: true, value: members[value] };\n    }\n\n    const shown = typeof value === 'string' ? `'${value}'` : JSON.stringify(value) ?? String(value);\n    return {\n        isValid: false,\n        value,\n        message: `Unsupported ${property} ${shown}. Use one of ${canonical.join(', ')}, or a legacy ordinal from 0 to ${canonical.length - 1}.`,\n    };\n}\n"],"names":["resolveEnumeration","property","value","members","fallback","undefined","isValid","canonical","Object","values","Number","isInteger","length","includes","hasOwn","shown","JSON","stringify","String","message","join"],"mappings":"AAAA;AACA;AAIA;;;;;;;;;;;;;;;;;;;IAoBO,SAASA,kBAAAA,CACZC,QAAgB,EAChBC,KAAc,EACdC,OAAgC,EAChCC,QAAiB,EAAA;IAEjB,IAAIF,KAAAA,KAAUG,WAAW,OAAO;QAAEC,OAAAA,EAAS,IAAA;QAAMJ,KAAAA,EAAOE;AAAS,KAAA;IAEjE,MAAMG,SAAAA,GAAYC,MAAAA,CAAOC,MAAM,CAACN,OAAAA,CAAAA;AAChC,IAAA,IAAI,OAAOD,KAAAA,KAAU,QAAA,IAAYQ,MAAAA,CAAOC,SAAS,CAACT,KAAAA,CAAAA,IAAUA,KAAAA,IAAS,CAAA,IAAKA,KAAAA,GAAQK,SAAAA,CAAUK,MAAM,EAAE;QAChG,OAAO;YAAEN,OAAAA,EAAS,IAAA;YAAMJ,KAAAA,EAAOK,SAAS,CAACL,KAAAA;AAAO,SAAA;AACpD,IAAA;IAEA,IAAI,OAAOA,UAAU,QAAA,EAAU;AAC3B,QAAA,IAAIK,SAAAA,CAAUM,QAAQ,CAACX,KAAAA,CAAAA,EAAmB,OAAO;YAAEI,OAAAA,EAAS,IAAA;YAAMJ,KAAAA,EAAOA;AAAiB,SAAA;AAC1F,QAAA,IAAIM,MAAAA,CAAOM,MAAM,CAACX,OAAAA,EAASD,QAAQ,OAAO;YAAEI,OAAAA,EAAS,IAAA;YAAMJ,KAAAA,EAAOC,OAAO,CAACD,KAAAA;AAAO,SAAA;AACrF,IAAA;AAEA,IAAA,MAAMa,KAAAA,GAAQ,OAAOb,KAAAA,KAAU,QAAA,GAAW,CAAC,CAAC,EAAEA,KAAAA,CAAM,CAAC,CAAC,GAAGc,IAAAA,CAAKC,SAAS,CAACf,UAAUgB,MAAAA,CAAOhB,KAAAA,CAAAA;IACzF,OAAO;QACHI,OAAAA,EAAS,KAAA;AACTJ,QAAAA,KAAAA;QACAiB,OAAAA,EAAS,CAAC,YAAY,EAAElB,QAAAA,CAAS,CAAC,EAAEc,KAAAA,CAAM,aAAa,EAAER,SAAAA,CAAUa,IAAI,CAAC,IAAA,CAAA,CAAM,gCAAgC,EAAEb,SAAAA,CAAUK,MAAM,GAAG,CAAA,CAAE,CAAC;AAC1I,KAAA;AACJ;;"}

package/dist/esm/structurallyEqual.d.ts

@@ -0,0 +1,2 @@
+export declare function structurallyEqual(left: unknown, right: unknown): boolean;
+//# sourceMappingURL=structurallyEqual.d.ts.map

package/dist/esm/structurallyEqual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structurallyEqual.d.ts","sourceRoot":"","sources":["../../structurallyEqual.ts"],"names":[],"mappings":"AAWA,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAaxE"}

package/dist/esm/structurallyEqual.js

@@ -0,0 +1,25 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Compares values that can survive a Scene document serialization round trip.
+ *
+ * Authored data (chart datasets, option values, current values) arrives as plain JSON. Every edit to a
+ * Scene document clones the whole document, so the same data gets a new object identity with no change in
+ * content; reference equality would treat each unrelated edit as a change. Primitives compare with
+ * `Object.is`, so `0` and `-0`, or `NaN` and `NaN`, are told apart exactly as `Object.is` does.
+ */ function structurallyEqual(left, right) {
+    if (Object.is(left, right)) return true;
+    if (Array.isArray(left) || Array.isArray(right)) {
+        return Array.isArray(left) && Array.isArray(right) && left.length === right.length && left.every((value, index)=>structurallyEqual(value, right[index]));
+    }
+    if (!isRecord(left) || !isRecord(right)) return false;
+    const leftKeys = Object.keys(left).sort();
+    const rightKeys = Object.keys(right).sort();
+    return leftKeys.length === rightKeys.length && leftKeys.every((key, index)=>key === rightKeys[index] && structurallyEqual(left[key], right[key]));
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object';
+}
+
+export { structurallyEqual };
+//# sourceMappingURL=structurallyEqual.js.map

package/dist/esm/structurallyEqual.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structurallyEqual.js","sources":["../../structurallyEqual.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\n/**\n * Compares values that can survive a Scene document serialization round trip.\n *\n * Authored data (chart datasets, option values, current values) arrives as plain JSON. Every edit to a\n * Scene document clones the whole document, so the same data gets a new object identity with no change in\n * content; reference equality would treat each unrelated edit as a change. Primitives compare with\n * `Object.is`, so `0` and `-0`, or `NaN` and `NaN`, are told apart exactly as `Object.is` does.\n */\nexport function structurallyEqual(left: unknown, right: unknown): boolean {\n    if (Object.is(left, right)) return true;\n    if (Array.isArray(left) || Array.isArray(right)) {\n        return Array.isArray(left) && Array.isArray(right)\n            && left.length === right.length\n            && left.every((value, index) => structurallyEqual(value, right[index]));\n    }\n\n    if (!isRecord(left) || !isRecord(right)) return false;\n    const leftKeys = Object.keys(left).sort();\n    const rightKeys = Object.keys(right).sort();\n    return leftKeys.length === rightKeys.length\n        && leftKeys.every((key, index) => key === rightKeys[index] && structurallyEqual(left[key], right[key]));\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n    return value !== null && typeof value === 'object';\n}\n"],"names":["structurallyEqual","left","right","Object","is","Array","isArray","length","every","value","index","isRecord","leftKeys","keys","sort","rightKeys","key"],"mappings":"AAAA;AACA;AAEA;;;;;;;AAOC,IACM,SAASA,iBAAAA,CAAkBC,IAAa,EAAEC,KAAc,EAAA;AAC3D,IAAA,IAAIC,MAAAA,CAAOC,EAAE,CAACH,IAAAA,EAAMC,QAAQ,OAAO,IAAA;AACnC,IAAA,IAAIG,MAAMC,OAAO,CAACL,SAASI,KAAAA,CAAMC,OAAO,CAACJ,KAAAA,CAAAA,EAAQ;QAC7C,OAAOG,KAAAA,CAAMC,OAAO,CAACL,IAAAA,CAAAA,IAASI,KAAAA,CAAMC,OAAO,CAACJ,KAAAA,CAAAA,IACrCD,IAAAA,CAAKM,MAAM,KAAKL,KAAAA,CAAMK,MAAM,IAC5BN,IAAAA,CAAKO,KAAK,CAAC,CAACC,KAAAA,EAAOC,QAAUV,iBAAAA,CAAkBS,KAAAA,EAAOP,KAAK,CAACQ,KAAAA,CAAM,CAAA,CAAA;AAC7E,IAAA;AAEA,IAAA,IAAI,CAACC,QAAAA,CAASV,IAAAA,CAAAA,IAAS,CAACU,QAAAA,CAAST,QAAQ,OAAO,KAAA;AAChD,IAAA,MAAMU,QAAAA,GAAWT,MAAAA,CAAOU,IAAI,CAACZ,MAAMa,IAAI,EAAA;AACvC,IAAA,MAAMC,SAAAA,GAAYZ,MAAAA,CAAOU,IAAI,CAACX,OAAOY,IAAI,EAAA;IACzC,OAAOF,QAAAA,CAASL,MAAM,KAAKQ,SAAAA,CAAUR,MAAM,IACpCK,QAAAA,CAASJ,KAAK,CAAC,CAACQ,GAAAA,EAAKN,KAAAA,GAAUM,QAAQD,SAAS,CAACL,KAAAA,CAAM,IAAIV,iBAAAA,CAAkBC,IAAI,CAACe,GAAAA,CAAI,EAAEd,KAAK,CAACc,GAAAA,CAAI,CAAA,CAAA;AAC7G;AAEA,SAASL,SAASF,KAAc,EAAA;IAC5B,OAAOA,KAAAA,KAAU,IAAA,IAAQ,OAAOA,KAAAA,KAAU,QAAA;AAC9C;;"}

package/dist/esm/treeNodes.d.ts

@@ -1,5 +1,6 @@
 import { TreeNode } from './TreeNode';
 import { SceneElement } from '@cratis/scene.model';
-export declare function toTreeNodes(entries: unknown[], parentKey?: string): TreeNode[];
+export declare function toTreeNodes(entries: unknown[], parentKey?: string, usedKeys?: Set<string>): TreeNode[];
+export declare function countUnreadableEntries(entries: unknown[]): number;
 export declare function treeNodesProperty(element: SceneElement, name: string): TreeNode[];
 //# sourceMappingURL=treeNodes.d.ts.map

package/dist/esm/treeNodes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"treeNodes.d.ts","sourceRoot":"","sources":["../../treeNodes.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAgBnD,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,SAAS,SAAK,GAAG,QAAQ,EAAE,CAuB1E;AASD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,CAEjF"}
+{"version":3,"file":"treeNodes.d.ts","sourceRoot":"","sources":["../../treeNodes.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAwBnD,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,SAAS,SAAK,EAAE,QAAQ,GAAE,GAAG,CAAC,MAAM,CAAa,GAAG,QAAQ,EAAE,CAyB7G;AASD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,CAOjE;AAqBD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,CAEjF"}

package/dist/esm/treeNodes.js

@@ -11,35 +11,69 @@ import { arrayProperty } from './properties.js';
  * expands the wrong rows the moment two siblings share a label. Deriving the key from the path makes it
  * unique and stable across re-renders without asking the author for anything.
  *
+ * An authored key may be a string or a number (a numeric id is a natural key); it is kept as a string. Keys
+ * are unique across the whole tree: a node whose authored key was already taken by an earlier node falls back
+ * to its path key, so two nodes can never share expansion or selection.
+ *
+ * An entry that is a string, number or boolean is a leaf labeled with it. Anything else that is not a record
+ * (`null`, a nested array) cannot be a node and is skipped; see {@link countUnreadableEntries}.
+ *
  * @param entries The raw entries to convert.
  * @param parentKey The key of the node these entries belong to, used to build stable child keys.
+ * @param usedKeys The keys already given out in this tree, shared down the recursion.
  * @returns The converted nodes, in order.
- */ function toTreeNodes(entries, parentKey = '') {
+ */ function toTreeNodes(entries, parentKey = '', usedKeys = new Set()) {
     const nodes = [];
     entries.forEach((entry, index)=>{
         const path = parentKey === '' ? `${index}` : `${parentKey}-${index}`;
-        if (typeof entry === 'string') {
+        if (typeof entry === 'string' || typeof entry === 'number' || typeof entry === 'boolean') {
             nodes.push({
-                key: path,
-                label: entry
+                key: uniqueKey(undefined, path, usedKeys),
+                label: String(entry)
             });
             return;
         }
         if (typeof entry !== 'object' || entry === undefined || entry === null || Array.isArray(entry)) return;
         const record = entry;
         const node = {
-            key: typeof record.key === 'string' ? record.key : path
+            key: uniqueKey(authoredKey(record.key), path, usedKeys)
         };
         if (typeof record.label === 'string') node.label = record.label;
         if (typeof record.icon === 'string') node.icon = record.icon;
         if (typeof record.className === 'string') node.className = record.className;
         if (typeof record.leaf === 'boolean') node.leaf = record.leaf;
-        if (typeof record.data === 'object' && record.data !== null) node.data = record.data;
-        if (Array.isArray(record.children)) node.children = toTreeNodes(record.children, node.key);
+        if (typeof record.expanded === 'boolean') node.expanded = record.expanded;
+        if (typeof record.selectable === 'boolean') node.selectable = record.selectable;
+        if (record.data !== undefined && record.data !== null) node.data = record.data;
+        if (Array.isArray(record.children)) node.children = toTreeNodes(record.children, node.key, usedKeys);
         nodes.push(node);
     });
     return nodes;
 }
+/**
+ * Counts the entries `toTreeNodes` skips, so a control can say that some of its data was not shown instead
+ * of silently showing less.
+ *
+ * @param entries The raw entries.
+ * @returns How many entries, at any depth, were neither a scalar nor a record.
+ */ function countUnreadableEntries(entries) {
+    return entries.reduce((count, entry)=>{
+        if (typeof entry === 'string' || typeof entry === 'number' || typeof entry === 'boolean') return count;
+        if (typeof entry !== 'object' || entry === null || Array.isArray(entry)) return count + 1;
+        const children = entry.children;
+        return count + (Array.isArray(children) ? countUnreadableEntries(children) : 0);
+    }, 0);
+}
+function authoredKey(value) {
+    if (typeof value === 'string' && value !== '') return value;
+    return typeof value === 'number' && Number.isFinite(value) ? String(value) : undefined;
+}
+function uniqueKey(authored, path, usedKeys) {
+    let key = authored !== undefined && !usedKeys.has(authored) ? authored : path;
+    while(usedKeys.has(key))key = `${key}~`;
+    usedKeys.add(key);
+    return key;
+}
 /**
  * Reads a tree model off a Scene element's properties.
  *
@@ -50,5 +84,5 @@ import { arrayProperty } from './properties.js';
     return toTreeNodes(arrayProperty(element, name));
 }
 
-export { toTreeNodes, treeNodesProperty };
+export { countUnreadableEntries, toTreeNodes, treeNodesProperty };
 //# sourceMappingURL=treeNodes.js.map

package/dist/esm/treeNodes.js.map

@@ -1 +1 @@
-{"version":3,"file":"treeNodes.js","sources":["../../treeNodes.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { TreeNode } from './TreeNode';\nimport { SceneElement } from '@cratis/scene.model';\nimport { arrayProperty } from './properties';\n\n/**\n * Turns raw authored entries into the `TreeNode` model PrimeReact's tree, tree table, tree select and\n * organization chart all share.\n *\n * A `key` is synthesized from the node's path when an author did not supply one. That is not cosmetic:\n * PrimeReact keys expansion, selection and virtual scrolling off `key`, so a tree of unkeyed nodes\n * expands the wrong rows the moment two siblings share a label. Deriving the key from the path makes it\n * unique and stable across re-renders without asking the author for anything.\n *\n * @param entries The raw entries to convert.\n * @param parentKey The key of the node these entries belong to, used to build stable child keys.\n * @returns The converted nodes, in order.\n */\nexport function toTreeNodes(entries: unknown[], parentKey = ''): TreeNode[] {\n    const nodes: TreeNode[] = [];\n    entries.forEach((entry, index) => {\n        const path = parentKey === '' ? `${index}` : `${parentKey}-${index}`;\n        if (typeof entry === 'string') {\n            nodes.push({ key: path, label: entry });\n            return;\n        }\n\n        if (typeof entry !== 'object' || entry === undefined || entry === null || Array.isArray(entry)) return;\n\n        const record = entry as Record<string, unknown>;\n        const node: TreeNode = { key: typeof record.key === 'string' ? record.key : path };\n        if (typeof record.label === 'string') node.label = record.label;\n        if (typeof record.icon === 'string') node.icon = record.icon;\n        if (typeof record.className === 'string') node.className = record.className;\n        if (typeof record.leaf === 'boolean') node.leaf = record.leaf;\n        if (typeof record.data === 'object' && record.data !== null) node.data = record.data;\n        if (Array.isArray(record.children)) node.children = toTreeNodes(record.children, node.key as string);\n        nodes.push(node);\n    });\n\n    return nodes;\n}\n\n/**\n * Reads a tree model off a Scene element's properties.\n *\n * @param element The element whose properties to read.\n * @param name The property name holding the entries.\n * @returns The converted nodes, empty when the property is missing or is not an array.\n */\nexport function treeNodesProperty(element: SceneElement, name: string): TreeNode[] {\n    return toTreeNodes(arrayProperty(element, name));\n}\n"],"names":["toTreeNodes","entries","parentKey","nodes","forEach","entry","index","path","push","key","label","undefined","Array","isArray","record","node","icon","className","leaf","data","children","treeNodesProperty","element","name","arrayProperty"],"mappings":";;AAAA;AACA;AAMA;;;;;;;;;;;;AAYC,IACM,SAASA,WAAAA,CAAYC,OAAkB,EAAEC,YAAY,EAAE,EAAA;AAC1D,IAAA,MAAMC,QAAoB,EAAE;IAC5BF,OAAAA,CAAQG,OAAO,CAAC,CAACC,KAAAA,EAAOC,KAAAA,GAAAA;QACpB,MAAMC,IAAAA,GAAOL,SAAAA,KAAc,EAAA,GAAK,CAAA,EAAGI,KAAAA,CAAAA,CAAO,GAAG,CAAA,EAAGJ,SAAAA,CAAU,CAAC,EAAEI,KAAAA,CAAAA,CAAO;QACpE,IAAI,OAAOD,UAAU,QAAA,EAAU;AAC3BF,YAAAA,KAAAA,CAAMK,IAAI,CAAC;gBAAEC,GAAAA,EAAKF,IAAAA;gBAAMG,KAAAA,EAAOL;AAAM,aAAA,CAAA;AACrC,YAAA;AACJ,QAAA;QAEA,IAAI,OAAOA,KAAAA,KAAU,QAAA,IAAYA,KAAAA,KAAUM,SAAAA,IAAaN,UAAU,IAAA,IAAQO,KAAAA,CAAMC,OAAO,CAACR,KAAAA,CAAAA,EAAQ;AAEhG,QAAA,MAAMS,MAAAA,GAAST,KAAAA;AACf,QAAA,MAAMU,IAAAA,GAAiB;AAAEN,YAAAA,GAAAA,EAAK,OAAOK,MAAAA,CAAOL,GAAG,KAAK,QAAA,GAAWK,MAAAA,CAAOL,GAAG,GAAGF;AAAK,SAAA;QACjF,IAAI,OAAOO,OAAOJ,KAAK,KAAK,UAAUK,IAAAA,CAAKL,KAAK,GAAGI,MAAAA,CAAOJ,KAAK;QAC/D,IAAI,OAAOI,OAAOE,IAAI,KAAK,UAAUD,IAAAA,CAAKC,IAAI,GAAGF,MAAAA,CAAOE,IAAI;QAC5D,IAAI,OAAOF,OAAOG,SAAS,KAAK,UAAUF,IAAAA,CAAKE,SAAS,GAAGH,MAAAA,CAAOG,SAAS;QAC3E,IAAI,OAAOH,OAAOI,IAAI,KAAK,WAAWH,IAAAA,CAAKG,IAAI,GAAGJ,MAAAA,CAAOI,IAAI;AAC7D,QAAA,IAAI,OAAOJ,MAAAA,CAAOK,IAAI,KAAK,QAAA,IAAYL,MAAAA,CAAOK,IAAI,KAAK,IAAA,EAAMJ,IAAAA,CAAKI,IAAI,GAAGL,OAAOK,IAAI;AACpF,QAAA,IAAIP,KAAAA,CAAMC,OAAO,CAACC,MAAAA,CAAOM,QAAQ,CAAA,EAAGL,IAAAA,CAAKK,QAAQ,GAAGpB,WAAAA,CAAYc,MAAAA,CAAOM,QAAQ,EAAEL,KAAKN,GAAG,CAAA;AACzFN,QAAAA,KAAAA,CAAMK,IAAI,CAACO,IAAAA,CAAAA;AACf,IAAA,CAAA,CAAA;IAEA,OAAOZ,KAAAA;AACX;AAEA;;;;;;AAMC,IACM,SAASkB,iBAAAA,CAAkBC,OAAqB,EAAEC,IAAY,EAAA;IACjE,OAAOvB,WAAAA,CAAYwB,cAAcF,OAAAA,EAASC,IAAAA,CAAAA,CAAAA;AAC9C;;"}
+{"version":3,"file":"treeNodes.js","sources":["../../treeNodes.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { TreeNode } from './TreeNode';\nimport { SceneElement } from '@cratis/scene.model';\nimport { arrayProperty } from './properties';\n\n/**\n * Turns raw authored entries into the `TreeNode` model PrimeReact's tree, tree table, tree select and\n * organization chart all share.\n *\n * A `key` is synthesized from the node's path when an author did not supply one. That is not cosmetic:\n * PrimeReact keys expansion, selection and virtual scrolling off `key`, so a tree of unkeyed nodes\n * expands the wrong rows the moment two siblings share a label. Deriving the key from the path makes it\n * unique and stable across re-renders without asking the author for anything.\n *\n * An authored key may be a string or a number (a numeric id is a natural key); it is kept as a string. Keys\n * are unique across the whole tree: a node whose authored key was already taken by an earlier node falls back\n * to its path key, so two nodes can never share expansion or selection.\n *\n * An entry that is a string, number or boolean is a leaf labeled with it. Anything else that is not a record\n * (`null`, a nested array) cannot be a node and is skipped; see {@link countUnreadableEntries}.\n *\n * @param entries The raw entries to convert.\n * @param parentKey The key of the node these entries belong to, used to build stable child keys.\n * @param usedKeys The keys already given out in this tree, shared down the recursion.\n * @returns The converted nodes, in order.\n */\nexport function toTreeNodes(entries: unknown[], parentKey = '', usedKeys: Set<string> = new Set()): TreeNode[] {\n    const nodes: TreeNode[] = [];\n    entries.forEach((entry, index) => {\n        const path = parentKey === '' ? `${index}` : `${parentKey}-${index}`;\n        if (typeof entry === 'string' || typeof entry === 'number' || typeof entry === 'boolean') {\n            nodes.push({ key: uniqueKey(undefined, path, usedKeys), label: String(entry) });\n            return;\n        }\n\n        if (typeof entry !== 'object' || entry === undefined || entry === null || Array.isArray(entry)) return;\n\n        const record = entry as Record<string, unknown>;\n        const node: TreeNode = { key: uniqueKey(authoredKey(record.key), path, usedKeys) };\n        if (typeof record.label === 'string') node.label = record.label;\n        if (typeof record.icon === 'string') node.icon = record.icon;\n        if (typeof record.className === 'string') node.className = record.className;\n        if (typeof record.leaf === 'boolean') node.leaf = record.leaf;\n        if (typeof record.expanded === 'boolean') node.expanded = record.expanded;\n        if (typeof record.selectable === 'boolean') node.selectable = record.selectable;\n        if (record.data !== undefined && record.data !== null) node.data = record.data;\n        if (Array.isArray(record.children)) node.children = toTreeNodes(record.children, node.key as string, usedKeys);\n        nodes.push(node);\n    });\n\n    return nodes;\n}\n\n/**\n * Counts the entries `toTreeNodes` skips, so a control can say that some of its data was not shown instead\n * of silently showing less.\n *\n * @param entries The raw entries.\n * @returns How many entries, at any depth, were neither a scalar nor a record.\n */\nexport function countUnreadableEntries(entries: unknown[]): number {\n    return entries.reduce<number>((count, entry) => {\n        if (typeof entry === 'string' || typeof entry === 'number' || typeof entry === 'boolean') return count;\n        if (typeof entry !== 'object' || entry === null || Array.isArray(entry)) return count + 1;\n        const children = (entry as { children?: unknown }).children;\n        return count + (Array.isArray(children) ? countUnreadableEntries(children) : 0);\n    }, 0);\n}\n\nfunction authoredKey(value: unknown): string | undefined {\n    if (typeof value === 'string' && value !== '') return value;\n    return typeof value === 'number' && Number.isFinite(value) ? String(value) : undefined;\n}\n\nfunction uniqueKey(authored: string | undefined, path: string, usedKeys: Set<string>): string {\n    let key = authored !== undefined && !usedKeys.has(authored) ? authored : path;\n    while (usedKeys.has(key)) key = `${key}~`;\n    usedKeys.add(key);\n    return key;\n}\n\n/**\n * Reads a tree model off a Scene element's properties.\n *\n * @param element The element whose properties to read.\n * @param name The property name holding the entries.\n * @returns The converted nodes, empty when the property is missing or is not an array.\n */\nexport function treeNodesProperty(element: SceneElement, name: string): TreeNode[] {\n    return toTreeNodes(arrayProperty(element, name));\n}\n"],"names":["toTreeNodes","entries","parentKey","usedKeys","Set","nodes","forEach","entry","index","path","push","key","uniqueKey","undefined","label","String","Array","isArray","record","node","authoredKey","icon","className","leaf","expanded","selectable","data","children","countUnreadableEntries","reduce","count","value","Number","isFinite","authored","has","add","treeNodesProperty","element","name","arrayProperty"],"mappings":"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"}