@cratis/scene.components 4.2.0 → 4.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cratis/scene.components",
-    "version": "4.2.0",
+    "version": "4.2.1",
     "description": "The Cratis Components package: exposes @cratis/components' Arc-bound data, form and dialog composites as Scene components. Built on PrimeReact and Tailwind, and declares both as dependencies.",
     "keywords": [
         "cratis",
@@ -26,7 +26,8 @@
         "dist",
         "**/*.ts",
         "**/*.tsx",
-        "**/*.css"
+        "**/*.css",
+        "!**/for_*/**"
     ],
     "main": "dist/cjs/index.js",
     "module": "dist/esm/index.js",
@@ -53,24 +54,24 @@
         "build-storybook": "storybook build"
     },
     "dependencies": {
-        "@cratis/scene.engine": "4.2.0",
-        "@cratis/scene.model": "4.2.0",
-        "@cratis/scene.react": "4.2.0"
+        "@cratis/scene.engine": "4.2.1",
+        "@cratis/scene.model": "4.2.1",
+        "@cratis/scene.react": "4.2.1"
     },
     "devDependencies": {
-        "@cratis/arc": "22.19.1",
-        "@cratis/arc.react": "22.19.1",
-        "@cratis/components": "4.13.0",
-        "@cratis/scene.engine": "4.2.0",
-        "@cratis/scene.model": "4.2.0",
-        "@cratis/scene.react": "4.2.0",
-        "@storybook/addon-links": "^10.6.0",
-        "@storybook/react": "^10.6.0",
-        "@storybook/react-vite": "^10.6.0",
-        "primeicons": "8.0.1",
+        "@cratis/arc": "22.39.0",
+        "@cratis/arc.react": "22.39.0",
+        "@cratis/components": "4.21.1",
+        "@cratis/scene.engine": "4.2.1",
+        "@cratis/scene.model": "4.2.1",
+        "@cratis/scene.react": "4.2.1",
+        "@storybook/addon-links": "^10.6.1",
+        "@storybook/react": "^10.6.1",
+        "@storybook/react-vite": "^10.6.1",
+        "primeicons": "8.0.2",
         "react": "^19.3.0",
         "react-dom": "^19.3.0",
-        "storybook": "^10.6.0"
+        "storybook": "^10.6.1"
     },
     "peerDependencies": {
         "@cratis/arc": "^22.19.1",

package/bindings/for_bindingRegistry/when_a_command_is_registered.ts

@@ -1,30 +0,0 @@
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
-
-import { clearBindings, registerCommand, registerCommands, registeredCommandNames, resolveCommand, resolveQuery } from '../bindingRegistry';
-
-class RegisterInvoice {}
-class ApproveInvoice {}
-class RegisterInvoiceV2 {}
-
-describe('when a command is registered', () => {
-    beforeEach(() => {
-        clearBindings();
-        registerCommand('RegisterInvoice', RegisterInvoice);
-        registerCommands({ ApproveInvoice });
-    });
-
-    afterEach(() => clearBindings());
-
-    it('should resolve the class registered under the name', () => resolveCommand('RegisterInvoice')!.should.equal(RegisterInvoice));
-    it('should resolve every class registered in bulk', () => resolveCommand('ApproveInvoice')!.should.equal(ApproveInvoice));
-    it('should list every registered name in sorted order', () => registeredCommandNames().should.deep.equal(['ApproveInvoice', 'RegisterInvoice']));
-    it('should not resolve the same name as a query', () => (resolveQuery('RegisterInvoice') === undefined).should.be.true);
-
-    describe('and the same name is registered again', () => {
-        beforeEach(() => registerCommand('RegisterInvoice', RegisterInvoiceV2));
-
-        it('should resolve to the class registered last', () => resolveCommand('RegisterInvoice')!.should.equal(RegisterInvoiceV2));
-        it('should not list the name twice', () => registeredCommandNames().should.deep.equal(['ApproveInvoice', 'RegisterInvoice']));
-    });
-});

package/bindings/for_bindingRegistry/when_a_query_is_not_registered.ts

@@ -1,17 +0,0 @@
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
-
-import { clearBindings, registerQuery, resolveQuery } from '../bindingRegistry';
-
-class AllInvoices {}
-
-describe('when a query is not registered', () => {
-    beforeEach(() => {
-        clearBindings();
-        registerQuery('AllInvoices', AllInvoices);
-    });
-
-    afterEach(() => clearBindings());
-
-    it('should resolve to undefined rather than throwing', () => (resolveQuery('AllCustomers') === undefined).should.be.true);
-});

package/bindings/for_bindingRegistry/when_a_query_is_registered.ts

@@ -1,30 +0,0 @@
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
-
-import { clearBindings, registerQueries, registerQuery, registeredQueryNames, resolveCommand, resolveQuery } from '../bindingRegistry';
-
-class AllInvoices {}
-class InvoiceById {}
-class OverdueInvoices {}
-
-describe('when a query is registered', () => {
-    beforeEach(() => {
-        clearBindings();
-        registerQuery('AllInvoices', AllInvoices);
-        registerQueries({ InvoiceById, OverdueInvoices });
-    });
-
-    afterEach(() => clearBindings());
-
-    it('should resolve the class registered under the name', () => resolveQuery('AllInvoices')!.should.equal(AllInvoices));
-
-    it('should resolve every class registered in bulk', () => {
-        resolveQuery('InvoiceById')!.should.equal(InvoiceById);
-        resolveQuery('OverdueInvoices')!.should.equal(OverdueInvoices);
-    });
-
-    it('should list every registered name in sorted order', () =>
-        registeredQueryNames().should.deep.equal(['AllInvoices', 'InvoiceById', 'OverdueInvoices']));
-
-    it('should not resolve the same name as a command', () => (resolveCommand('AllInvoices') === undefined).should.be.true);
-});

package/bindings/for_bindingRegistry/when_bindings_are_cleared.ts

@@ -1,29 +0,0 @@
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
-
-import {
-    clearBindings,
-    registerCommand,
-    registerQuery,
-    registeredCommandNames,
-    registeredQueryNames,
-    resolveCommand,
-    resolveQuery,
-} from '../bindingRegistry';
-
-class AllInvoices {}
-class RegisterInvoice {}
-
-describe('when bindings are cleared', () => {
-    beforeEach(() => {
-        clearBindings();
-        registerQuery('AllInvoices', AllInvoices);
-        registerCommand('RegisterInvoice', RegisterInvoice);
-        clearBindings();
-    });
-
-    it('should no longer resolve the query', () => (resolveQuery('AllInvoices') === undefined).should.be.true);
-    it('should no longer resolve the command', () => (resolveCommand('RegisterInvoice') === undefined).should.be.true);
-    it('should list no query names', () => registeredQueryNames().should.be.empty);
-    it('should list no command names', () => registeredCommandNames().should.be.empty);
-});

package/bindings/for_bindingRegistry/when_registering_query_identities.ts

@@ -1,81 +0,0 @@
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
-
-import { expect } from 'vitest';
-import { clearBindings, registerQuery, registerQueryIdentity, registeredQueryNames, resolveExactQuery, resolveQuery, unregisterQueryIdentity } from '../bindingRegistry';
-
-class First {}
-class Replacement {}
-
-describe('when opting into collision-aware query identities', () => {
-    beforeEach(() => clearBindings());
-    afterEach(() => clearBindings());
-
-    it('replaces the same source identity on hot reload', () => {
-        registerQueryIdentity('Lookup', 'source/Lookup', First);
-        registerQueryIdentity('Lookup', 'source/Lookup', Replacement);
-        expect(resolveExactQuery('Lookup')).toBe(Replacement);
-        expect(resolveQuery('Lookup')).toBe(Replacement);
-        expect(registeredQueryNames()).toEqual(['Lookup']);
-    });
-
-    it('counts different source identities even for the same constructor', () => {
-        registerQueryIdentity('Lookup', 'one/Lookup', First);
-        registerQueryIdentity('Lookup', 'two/Lookup', First);
-        expect(resolveExactQuery('Lookup')).toBe('ambiguous');
-        expect(resolveQuery('Lookup')).toBeUndefined();
-        expect(registeredQueryNames()).toEqual(['Lookup']);
-        unregisterQueryIdentity('Lookup', 'one/Lookup');
-        expect(resolveExactQuery('Lookup')).toBe(First);
-        expect(resolveQuery('Lookup')).toBe(First);
-        unregisterQueryIdentity('Lookup', 'two/Lookup');
-        expect(resolveExactQuery('Lookup')).toBeUndefined();
-        expect(resolveQuery('Lookup')).toBeUndefined();
-        expect(registeredQueryNames()).toEqual([]);
-    });
-
-    it('keeps legacy replacement authoritative while exact resolution counts mixed candidates', () => {
-        registerQuery('Lookup', First);
-        registerQuery('Lookup', Replacement);
-        expect(resolveQuery('Lookup')).toBe(Replacement);
-        expect(resolveExactQuery('Lookup')).toBe(Replacement);
-        registerQueryIdentity('Lookup', 'source/Lookup', First);
-        expect(resolveQuery('Lookup')).toBe(Replacement);
-        expect(resolveExactQuery('Lookup')).toBe('ambiguous');
-    });
-
-    it('bridges a unique identity to legacy consumers with exact case-sensitive names and clears both maps', () => {
-        registerQueryIdentity('Lookup', 'source/Lookup', First);
-        expect(resolveQuery('Lookup')).toBe(First);
-        expect(resolveQuery('lookup')).toBeUndefined();
-        expect(resolveExactQuery('lookup')).toBeUndefined();
-        clearBindings();
-        expect(resolveQuery('Lookup')).toBeUndefined();
-        expect(resolveExactQuery('Lookup')).toBeUndefined();
-        expect(registeredQueryNames()).toEqual([]);
-    });
-
-    it('lists the sorted union without duplicates, retaining legacy names after identity removal', () => {
-        registerQueryIdentity('Zed', 'source/Zed', First);
-        registerQueryIdentity('Lookup', 'source/Lookup', First);
-        registerQuery('Lookup', Replacement);
-        registerQuery('Alpha', First);
-        expect(registeredQueryNames()).toEqual(['Alpha', 'Lookup', 'Zed']);
-        unregisterQueryIdentity('Lookup', 'source/Lookup');
-        unregisterQueryIdentity('Zed', 'source/Zed');
-        unregisterQueryIdentity('Missing', 'source/Missing');
-        expect(registeredQueryNames()).toEqual(['Alpha', 'Lookup']);
-        expect(resolveQuery('Lookup')).toBe(Replacement);
-        expect(resolveExactQuery('Lookup')).toBe(Replacement);
-    });
-
-    it('gives an existing legacy registration precedence even over multiple identities and later replacements', () => {
-        registerQueryIdentity('Lookup', 'one/Lookup', First);
-        registerQueryIdentity('Lookup', 'two/Lookup', First);
-        registerQuery('Lookup', First);
-        registerQuery('Lookup', Replacement);
-        registerQueryIdentity('Lookup', 'one/Lookup', Replacement);
-        expect(resolveQuery('Lookup')).toBe(Replacement);
-        expect(resolveExactQuery('Lookup')).toBe('ambiguous');
-    });
-});

package/bindings/for_requireArcProxy/NativeProxies.ts

@@ -1,28 +0,0 @@
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
-
-import { QueryFor, ObservableQueryFor } from '@cratis/arc/queries';
-import { Command } from '@cratis/arc/commands';
-
-export class Snapshot extends QueryFor<object[], { projectId: string }> {
-    readonly route = '/projects';
-    readonly parameterDescriptors = [];
-    readonly requiredRequestParameters = ['projectId'];
-    defaultValue = [];
-    constructor() { super(Object, true); throw new Error('Must not construct during binding'); }
-}
-
-export class Live extends ObservableQueryFor<object[], object> {
-    readonly route = '/projects';
-    readonly parameterDescriptors = [];
-    readonly requiredRequestParameters = [];
-    readonly defaultValue = [];
-    constructor() { super(Object, true); throw new Error('Must not construct during binding'); }
-}
-
-export class Save extends Command {
-    readonly route = '/save';
-    readonly propertyDescriptors = [];
-    readonly requestParameters = [];
-    constructor() { super(Object, false); throw new Error('Must not construct during binding'); }
-}

package/bindings/for_requireArcProxy/when_mounting_bound_adapters.tsx

@@ -1,73 +0,0 @@
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
-
-import { act, cleanup, render, screen } from '@testing-library/react';
-import { expect, vi } from 'vitest';
-import { externalComponent } from '../../given';
-
-// Keep the real Arc base classes; replace only the final Components renderers.
-describe('when mounting bound adapters', () => {
-    const received = vi.fn<(props: Record<string, unknown>) => void>();
-    let bindings: typeof import('../bindingRegistry');
-    let proxies: typeof import('./NativeProxies');
-    let adapters: typeof import('../ArcBoundComponents');
-    let Boundary: typeof import('../ArcRuntimeBoundary').ArcRuntimeBoundary;
-
-    beforeEach(async () => {
-        vi.resetModules();
-        received.mockClear();
-        const component = (props: Record<string, unknown>) => { received(props); return <span>Mounted native adapter</span>; };
-        vi.doMock('@cratis/components/DataTables', () => ({ DataTableForQuery: component, DataTableForObservableQuery: component }));
-        vi.doMock('@cratis/components/DataPage', () => ({ DataPage: component }));
-        vi.doMock('@cratis/components/CommandDialog', () => ({ CommandDialog: component, StepperCommandDialog: component }));
-        bindings = await import('../bindingRegistry');
-        bindings.clearBindings();
-        proxies = await import('./NativeProxies');
-        adapters = await import('../ArcBoundComponents');
-        ({ ArcRuntimeBoundary: Boundary } = await import('../ArcRuntimeBoundary'));
-        vi.spyOn(console, 'error').mockImplementation(() => undefined);
-    });
-
-    afterEach(() => {
-        cleanup();
-        bindings.clearBindings();
-        vi.restoreAllMocks();
-        vi.doUnmock('@cratis/components/DataTables');
-        vi.doUnmock('@cratis/components/DataPage');
-        vi.doUnmock('@cratis/components/CommandDialog');
-        vi.resetModules();
-    });
-
-    it('should pass both supported page kinds and both command dialog constructors unchanged', () => {
-        const { BoundDataPage, BoundObservableDataTable, BoundCommandDialog, BoundStepperCommandDialog } = adapters;
-        render(<><BoundDataPage query={proxies.Snapshot} title='' emptyMessage='' children={undefined} />
-            <BoundDataPage query={proxies.Live} title='' emptyMessage='' children={undefined} />
-            <BoundObservableDataTable query={proxies.Live} emptyMessage='' />
-            <BoundCommandDialog command={proxies.Save} title='' visible />
-            <BoundStepperCommandDialog command={proxies.Save} title='' visible /></>);
-        expect(received.mock.calls.map(([props]) => props.query ?? props.command)).toEqual([proxies.Snapshot, proxies.Live, proxies.Live, proxies.Save, proxies.Save]);
-    });
-
-    it('should visibly reject a wrong-kind registered query without selecting another query', async () => {
-        bindings.registerQuery('wrong', proxies.Save);
-        bindings.registerQuery('valid', proxies.Snapshot);
-        const { SceneDataTable } = await import('../../data/SceneDataTable');
-        await act(async () => {
-            render(<SceneDataTable element={externalComponent('Cratis.Components:dataTable', { query: 'wrong' })} slots={{}} />);
-        });
-        // The published Components boundary sanitizes exception text; assert visible failure, not
-        // its former raw-error presentation. requireArcProxy's specs cover the precise diagnostic.
-        expect(screen.getByRole('alert')).toBeTruthy();
-        expect(received).not.toHaveBeenCalled();
-    });
-
-    it('should visibly reject snapshot bindings in observable tables and query bindings in dialogs', () => {
-        const { BoundObservableDataTable, BoundCommandDialog, BoundStepperCommandDialog, BoundDataPage } = adapters;
-        render(<><Boundary><BoundObservableDataTable query={proxies.Snapshot} emptyMessage='' /></Boundary>
-            <Boundary><BoundCommandDialog command={proxies.Snapshot} title='' visible /></Boundary>
-            <Boundary><BoundStepperCommandDialog command={proxies.Live} title='' visible /></Boundary>
-            <Boundary><BoundDataPage query={proxies.Save} title='' emptyMessage='' children={undefined} /></Boundary></>);
-        expect(screen.getAllByRole('alert')).toHaveLength(4);
-        expect(received).not.toHaveBeenCalled();
-    });
-});

package/bindings/for_requireArcProxy/when_previewing_without_arc.tsx

@@ -1,37 +0,0 @@
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
-
-import { act, cleanup, render, screen } from '@testing-library/react';
-import { expect, vi } from 'vitest';
-import { externalComponent } from '../../given';
-
-describe('when previewing bound adapters without Arc', () => {
-    const loaded = vi.fn();
-
-    afterEach(() => {
-        cleanup();
-        vi.doUnmock('../ArcBoundComponents');
-        vi.resetModules();
-    });
-
-    it('should show missing bindings without importing the Arc runtime module', async () => {
-        vi.resetModules();
-        vi.doMock('../ArcBoundComponents', () => {
-            loaded();
-            throw new Error('Arc is unavailable in preview');
-        });
-        const { clearBindings } = await import('../bindingRegistry');
-        clearBindings();
-        const { SceneDataTable } = await import('../../data/SceneDataTable');
-        const { SceneObservableDataTable } = await import('../../data/SceneObservableDataTable');
-        const { SceneDataPage } = await import('../../pages/SceneDataPage');
-        const { SceneCommandDialog } = await import('../../dialogs/SceneCommandDialog');
-        const { SceneStepperCommandDialog } = await import('../../dialogs/SceneStepperCommandDialog');
-        await act(async () => {
-            render(<>{[SceneDataTable, SceneObservableDataTable, SceneDataPage, SceneCommandDialog, SceneStepperCommandDialog].map((Adapter, index) =>
-                <Adapter key={index} element={externalComponent('Cratis.Components:preview', { query: 'missing', command: 'missing' })} slots={{}} />)}</>);
-        });
-        expect(screen.getAllByText(/Unresolved .* binding 'missing'/)).toHaveLength(5);
-        expect(loaded).not.toHaveBeenCalled();
-    });
-});

package/bindings/for_requireArcProxy/when_validating_a_proxy.ts

@@ -1,44 +0,0 @@
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
-
-import { expect } from 'vitest';
-import { QueryFor, ObservableQueryFor } from '@cratis/arc/queries';
-import { Command } from '@cratis/arc/commands';
-import type { ComponentProps } from 'react';
-import type { DataTableForQuery, DataTableForObservableQuery } from '@cratis/components/DataTables';
-import type { CommandDialog } from '@cratis/components/CommandDialog';
-import { requireArcProxy } from '../requireArcProxy';
-import { registerQuery, resolveQuery, clearBindings } from '../bindingRegistry';
-import { Snapshot, Live, Save } from './NativeProxies';
-
-describe('when validating a proxy at the lazy Arc boundary', () => {
-    afterEach(clearBindings);
-
-    it('should preserve native constructors without constructing them and satisfy public component props', () => {
-        const query: ComponentProps<typeof DataTableForQuery>['query'] = requireArcProxy(Snapshot, QueryFor<object, object>, 'query');
-        const observable: ComponentProps<typeof DataTableForObservableQuery>['query'] = requireArcProxy(Live, ObservableQueryFor<object, object>, 'observable query');
-        const command: ComponentProps<typeof CommandDialog>['command'] = requireArcProxy(Save, Command<object, object>, 'command');
-        expect(query).toBe(Snapshot);
-        expect(observable).toBe(Live);
-        expect(command).toBe(Save);
-    });
-
-    it('should reject wrong kinds rather than perform an observable query as a snapshot', () => {
-        expect(() => requireArcProxy(Live, QueryFor<object, object>, 'query')).toThrow('Invalid query binding');
-        expect(() => requireArcProxy(Snapshot, ObservableQueryFor<object, object>, 'observable query')).toThrow('Invalid observable query binding');
-        expect(() => requireArcProxy(Snapshot, Command<object, object>, 'command')).toThrow('Invalid command binding');
-        expect(() => requireArcProxy(Save, QueryFor<object, object>, 'query')).toThrow('Invalid query binding');
-    });
-
-    it('should preserve arbitrary constructor registration but reject it at an Arc adapter', () => {
-        class Arbitrary { constructor(readonly input: string) {} }
-        registerQuery('arbitrary', Arbitrary);
-        expect(resolveQuery('arbitrary')).toBe(Arbitrary);
-        expect(() => requireArcProxy(Arbitrary, QueryFor<object, object>, 'query')).toThrow('Invalid query binding');
-    });
-
-    it('should reject a native subclass requiring constructor arguments without invoking it', () => {
-        class NeedsArguments extends Snapshot { constructor(readonly input: string) { super(); } }
-        expect(() => requireArcProxy(NeedsArguments, QueryFor<object, object>, 'query')).toThrow('zero-argument Arc');
-    });
-});

package/bindings/for_resolveElementBinding/when_resolving_a_command_binding.ts

@@ -1,34 +0,0 @@
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
-
-import { externalComponent } from '../../given';
-import { BindingKind } from '../BindingKind';
-import { clearBindings, registerCommand, registerQuery } from '../bindingRegistry';
-import { resolveElementBinding } from '../resolveElementBinding';
-
-class RegisterInvoice {}
-class SameNameQuery {}
-
-describe('when resolving a command binding', () => {
-    beforeEach(() => {
-        clearBindings();
-        registerCommand('RegisterInvoice', RegisterInvoice);
-        registerQuery('ApproveInvoice', SameNameQuery);
-    });
-
-    afterEach(() => clearBindings());
-
-    describe('and the element names a registered command', () => {
-        const binding = () =>
-            resolveElementBinding(externalComponent('Cratis.Components:commandForm', { command: 'RegisterInvoice' }), BindingKind.Command);
-
-        it('should carry the registered class', () => binding().target!.should.equal(RegisterInvoice));
-    });
-
-    describe('and a query happens to be registered under the same name', () => {
-        const binding = () =>
-            resolveElementBinding(externalComponent('Cratis.Components:commandForm', { command: 'ApproveInvoice' }), BindingKind.Command);
-
-        it('should not satisfy a command binding from the query registry', () => (binding().target === undefined).should.be.true);
-    });
-});

package/bindings/for_resolveElementBinding/when_resolving_a_query_binding.ts

@@ -1,45 +0,0 @@
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
-
-import { externalComponent } from '../../given';
-import { BindingKind } from '../BindingKind';
-import { clearBindings, registerQuery } from '../bindingRegistry';
-import { resolveElementBinding } from '../resolveElementBinding';
-
-class AllInvoices {}
-
-describe('when resolving a query binding', () => {
-    beforeEach(() => {
-        clearBindings();
-        registerQuery('AllInvoices', AllInvoices);
-    });
-
-    afterEach(() => clearBindings());
-
-    describe('and the element names a registered query', () => {
-        const binding = () => resolveElementBinding(externalComponent('Cratis.Components:dataTable', { query: 'AllInvoices' }), BindingKind.Query);
-
-        it('should carry the name the element asked for', () => binding().name!.should.equal('AllInvoices'));
-        it('should carry the registered class', () => binding().target!.should.equal(AllInvoices));
-    });
-
-    describe('and the element names a query nothing is registered under', () => {
-        const binding = () => resolveElementBinding(externalComponent('Cratis.Components:dataTable', { query: 'AllCustomers' }), BindingKind.Query);
-
-        it('should still carry the name, so the placeholder can report it', () => binding().name!.should.equal('AllCustomers'));
-        it('should carry no class', () => (binding().target === undefined).should.be.true);
-    });
-
-    describe('and the element names no query at all', () => {
-        const binding = () => resolveElementBinding(externalComponent('Cratis.Components:dataTable'), BindingKind.Query);
-
-        it('should carry no name', () => (binding().name === undefined).should.be.true);
-        it('should carry no class', () => (binding().target === undefined).should.be.true);
-    });
-
-    describe('and the element carries the name under the command property instead', () => {
-        const binding = () => resolveElementBinding(externalComponent('Cratis.Components:dataTable', { command: 'AllInvoices' }), BindingKind.Query);
-
-        it('should not read a command name as a query name', () => (binding().name === undefined).should.be.true);
-    });
-});

package/data/for_SceneDataTable/when_forwarding_query_arguments.tsx

@@ -1,123 +0,0 @@
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
-
-import { act, cleanup, render, screen } from '@testing-library/react';
-import { vi } from 'vitest';
-import { externalComponent } from '../../given';
-
-let InvoicesForProject: typeof import('../../bindings/for_requireArcProxy/NativeProxies').Snapshot;
-let AnotherQuery: typeof InvoicesForProject;
-
-// Load a fresh adapter so its lazy component cannot leak the peer double into other specs.
-describe('when forwarding query arguments', () => {
-    const suppliedId = 'project-with-an-explicit-id';
-    const received = vi.fn<(properties: Record<string, unknown>) => void>();
-    let SceneDataTable: typeof import('../SceneDataTable').SceneDataTable;
-    let bindings: typeof import('../../bindings');
-
-    beforeEach(async () => {
-        vi.resetModules();
-        received.mockClear();
-        vi.doMock('@cratis/components/DataTables', () => ({
-            DataTableForQuery: (properties: Record<string, unknown>) => {
-                received(properties);
-                return <div data-testid='query-table' />;
-            },
-        }));
-        ({ Snapshot: InvoicesForProject } = await import('../../bindings/for_requireArcProxy/NativeProxies'));
-        AnotherQuery = InvoicesForProject;
-        bindings = await import('../../bindings');
-        bindings.clearBindings();
-        bindings.registerQuery('InvoicesForProject', InvoicesForProject);
-        bindings.registerQuery('AnotherQuery', AnotherQuery);
-        ({ SceneDataTable } = await import('../SceneDataTable'));
-    });
-
-    afterEach(() => {
-        cleanup();
-        bindings.clearBindings();
-        vi.doUnmock('@cratis/components/DataTables');
-        vi.resetModules();
-    });
-
-    async function renderTable(properties: Record<string, unknown>) {
-        const element = externalComponent('Cratis.Components:dataTable', properties);
-        await act(async () => {
-            render(<SceneDataTable element={element} slots={{}} />);
-        });
-    }
-
-    it('should pass the exact registered constructor and explicit projectId object through the runtime boundary', async () => {
-        const queryArguments = { projectId: suppliedId };
-        await renderTable({ query: 'InvoicesForProject', queryArguments });
-        await screen.findByTestId('query-table');
-        const properties = received.mock.lastCall![0];
-        (properties.query === InvoicesForProject).should.equal(true);
-        (properties.queryArguments === queryArguments).should.equal(true);
-        properties.should.have.property('queryArguments').that.deep.equals({ projectId: suppliedId });
-    });
-
-    it('should bridge an identity-only query to an existing table without a second legacy registration', async () => {
-        bindings.clearBindings();
-        bindings.registerQueryIdentity('InvoicesForProject', 'Invoices/ForProject', InvoicesForProject);
-        const queryArguments = { projectId: suppliedId };
-        await renderTable({ query: 'InvoicesForProject', queryArguments });
-        await screen.findByTestId('query-table');
-        (received.mock.lastCall![0].query === InvoicesForProject).should.equal(true);
-        (received.mock.lastCall![0].queryArguments === queryArguments).should.equal(true);
-    });
-
-    it('should visibly reject ambiguous identity-only tables without selecting either native proxy', async () => {
-        bindings.clearBindings();
-        bindings.registerQueryIdentity('InvoicesForProject', 'One/ForProject', InvoicesForProject);
-        bindings.registerQueryIdentity('InvoicesForProject', 'Two/ForProject', AnotherQuery);
-        await renderTable({ query: 'InvoicesForProject' });
-        (screen.getByText("Unresolved query binding 'InvoicesForProject' on Cratis.Components:dataTable") !== null).should.equal(true);
-        received.mock.calls.should.have.lengthOf(0);
-    });
-
-    it('should preserve all supplied keys and values without normalization or defaults', async () => {
-        const queryArguments = { projectId: suppliedId, ProjectID: 'distinct', limit: 0, enabled: false, optional: null, filter: { names: ['one'] } };
-        await renderTable({ query: 'InvoicesForProject', queryArguments });
-        await screen.findByTestId('query-table');
-        (received.mock.lastCall![0].queryArguments === queryArguments).should.equal(true);
-    });
-
-    it('should leave omitted arguments absent from the underlying component props', async () => {
-        await renderTable({ query: 'InvoicesForProject' });
-        await screen.findByTestId('query-table');
-        Object.prototype.hasOwnProperty.call(received.mock.lastCall![0], 'queryArguments').should.equal(false);
-        (received.mock.lastCall![0].query === InvoicesForProject).should.equal(true);
-    });
-
-    it('should treat undefined arguments as omitted like the existing property readers', async () => {
-        await renderTable({ query: 'InvoicesForProject', queryArguments: undefined });
-        await screen.findByTestId('query-table');
-        Object.prototype.hasOwnProperty.call(received.mock.lastCall![0], 'queryArguments').should.equal(false);
-    });
-
-    it('should pass an explicitly empty argument object unchanged', async () => {
-        const queryArguments = {};
-        await renderTable({ query: 'InvoicesForProject', queryArguments });
-        await screen.findByTestId('query-table');
-        (received.mock.lastCall![0].queryArguments === queryArguments).should.equal(true);
-    });
-
-    for (const queryArguments of [[], ['project'], 'project', '{"projectId":"project"}', 42, false, null]) {
-        it(`should visibly reject ${JSON.stringify(queryArguments)} without mounting a query table`, async () => {
-            await renderTable({ query: 'InvoicesForProject', queryArguments });
-            (screen.getByText("Invalid queryArguments: expected an object on Cratis.Components:dataTable") !== null).should.equal(true);
-            received.mock.calls.should.have.lengthOf(0);
-            (screen.queryByTestId('query-table') === null).should.equal(true);
-        });
-    }
-
-    for (const queryArguments of [{ projectId: suppliedId }, null, []]) {
-        it(`should retain MissingBinding precedence and never choose another registered query with ${JSON.stringify(queryArguments)}`, async () => {
-            await renderTable({ query: 'UnregisteredQuery', queryArguments });
-            (screen.getByText("Unresolved query binding 'UnregisteredQuery' on Cratis.Components:dataTable") !== null).should.equal(true);
-            received.mock.calls.should.have.lengthOf(0);
-            (screen.queryByText(/Invalid queryArguments/) === null).should.equal(true);
-        });
-    }
-});