@cratis/scene.react 4.13.0 → 4.15.0

package/dist/esm/packages/PackageHostConfiguration.js.map

@@ -1 +1 @@
-{"version":3,"file":"PackageHostConfiguration.js","sources":["../../../packages/PackageHostConfiguration.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 { DialogTemplate, Layout, ScreenTemplate, Theme, UiProfile } from '@cratis/scene.model';\nimport { TemplateCatalogEntry, describeTemplateCatalog, resolvePackageDependencies } from '@cratis/scene.engine';\nimport { IconAdapterRegistry, createIconAdapterRegistry } from '../icons/IconAdapterRegistry';\nimport { ScenePackageBundle, mergePackageRegistries, validatePackageBundle } from './ScenePackageBundle';\n\nexport interface PackageHostPolicy {\n    allowExecutableImports: boolean;\n    allowNetworkAssets: boolean;\n\n    /** Whether this host is resolving optional design-time bundles in addition to runtime contributions. */\n    loadDesignTime?: boolean;\n}\n\nexport interface PackageHostConfiguration {\n    bundles: ScenePackageBundle[];\n    profile: UiProfile;\n    policy: PackageHostPolicy;\n\n    /** The Scene version the host runs, checked against each template's compatibility range when given. */\n    sceneVersion?: string;\n}\n\nexport interface ResolvedPackageHost {\n    bundles: ScenePackageBundle[];\n    components: ReturnType<typeof mergePackageRegistries>;\n    layouts: Layout[];\n    screenTemplates: ScreenTemplate[];\n    dialogTemplates: DialogTemplate[];\n    themes: Theme[];\n\n    /**\n     * Every template the approved packages provide, with compatibility, attribution and license metadata and\n     * whether it can be used with this package set. Template browsers read this rather than the raw lists.\n     */\n    templates: TemplateCatalogEntry[];\n    icons: IconAdapterRegistry;\n    assets: string[];\n    fonts: string[];\n    blocked: boolean;\n    diagnostics: string[];\n}\n\n/**\n * Resolves the approved package set a standalone or embedded React host uses.\n */\nexport function resolvePackageHost(configuration: PackageHostConfiguration): ResolvedPackageHost {\n    const diagnostics: string[] = [];\n    const names = new Map<string, number>();\n    for (const bundle of configuration.bundles) {\n        names.set(bundle.manifest.name, (names.get(bundle.manifest.name) ?? 0) + 1);\n    }\n\n    for (const [name, count] of names) {\n        if (count > 1) diagnostics.push(`Package '${name}' is approved more than once; duplicate bundles are ambiguous`);\n    }\n\n    const byName = new Map(configuration.bundles.map(bundle => [bundle.manifest.name, bundle]));\n    const selection = resolvePackageDependencies(configuration.profile.packages, configuration.bundles.map(bundle => bundle.manifest));\n    for (const missing of selection.missing) diagnostics.push(`Package '${missing.package}' depends on missing package '${missing.dependsOn}'`);\n    for (const conflict of selection.versionConflicts) {\n        diagnostics.push(`Package '${conflict.package}' requires '${conflict.dependsOn}' ${conflict.requiredRange} but approved version is ${conflict.actualVersion}`);\n    }\n    for (const cycle of selection.cycles) diagnostics.push(`Package dependency cycle: ${cycle.join(' -> ')}`);\n\n    const bundles: ScenePackageBundle[] = [];\n    const runtimeSingletons = new Map<string, string>();\n    const assets: string[] = [];\n\n    for (const packageName of selection.packages) {\n        const bundle = byName.get(packageName);\n        if (!bundle) {\n            diagnostics.push(`UI profile asks for '${packageName}' but the host did not approve a bundle for it`);\n            continue;\n        }\n\n        diagnostics.push(...validatePackageBundle(bundle).map(problem => `${packageName}: ${problem}`));\n        if (configuration.policy.loadDesignTime === true && !configuration.policy.allowExecutableImports && bundle.designTime) {\n            diagnostics.push(`Package '${packageName}' provides executable design-time contributions, but host policy forbids them`);\n        }\n\n        const packageAssets = bundle.manifest.assets ?? [];\n        if (!configuration.policy.allowNetworkAssets && packageAssets.some(asset => /^https?:\\/\\//.test(asset))) {\n            diagnostics.push(`Package '${packageName}' declares network assets, but host policy forbids them`);\n        }\n        assets.push(...packageAssets);\n\n        for (const dependency of bundle.manifest.runtimeSingletons ?? []) {\n            const owner = runtimeSingletons.get(dependency);\n            if (owner && owner !== packageName) {\n                diagnostics.push(`Runtime singleton '${dependency}' is provided by both '${owner}' and '${packageName}'`);\n            }\n            runtimeSingletons.set(dependency, packageName);\n        }\n\n        bundles.push(bundle);\n    }\n\n    const blocked = diagnostics.length > 0;\n    const approved = blocked ? [] : bundles;\n    const approvedAssets = blocked ? [] : assets;\n\n    return {\n        bundles: approved,\n        components: mergePackageRegistries(approved),\n        layouts: approved.flatMap(bundle => bundle.layouts ?? []),\n        screenTemplates: approved.flatMap(bundle => bundle.screenTemplates ?? []),\n        dialogTemplates: approved.flatMap(bundle => bundle.dialogTemplates ?? []),\n        themes: approved.flatMap(bundle => bundle.themes ?? []),\n        templates: describeTemplateCatalog(approved, configuration.sceneVersion),\n        icons: createIconAdapterRegistry(approved.map(bundle => bundle.iconLibrary?.adapter).filter(adapter => adapter !== undefined)),\n        assets: approvedAssets,\n        fonts: approvedAssets.filter(isFontAsset),\n        blocked,\n        diagnostics,\n    };\n}\n\nfunction isFontAsset(asset: string): boolean {\n    return /\\.(woff2?|otf|ttf)(\\?|$)/.test(asset) || asset.includes('/fonts/');\n}\n"],"names":["resolvePackageHost","configuration","diagnostics","names","Map","bundle","bundles","set","manifest","name","get","count","push","byName","map","selection","resolvePackageDependencies","profile","packages","missing","package","dependsOn","conflict","versionConflicts","requiredRange","actualVersion","cycle","cycles","join","runtimeSingletons","assets","packageName","validatePackageBundle","problem","policy","loadDesignTime","allowExecutableImports","designTime","packageAssets","allowNetworkAssets","some","asset","test","dependency","owner","blocked","length","approved","approvedAssets","components","mergePackageRegistries","layouts","flatMap","screenTemplates","dialogTemplates","themes","templates","describeTemplateCatalog","sceneVersion","icons","createIconAdapterRegistry","iconLibrary","adapter","filter","undefined","fonts","isFontAsset","includes"],"mappings":"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"}
+{"version":3,"file":"PackageHostConfiguration.js","sources":["../../../packages/PackageHostConfiguration.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 { DialogTemplate, Layout, ScreenTemplate, Theme, UiProfile } from '@cratis/scene.model';\nimport { TemplateCatalogEntry, describeTemplateCatalog, incompatiblePackages, resolvePackageDependencies } from '@cratis/scene.engine';\nimport { IconAdapterRegistry, createIconAdapterRegistry } from '../icons/IconAdapterRegistry';\nimport { ScenePackageBundle, mergePackageRegistries, validatePackageBundle } from './ScenePackageBundle';\nimport { isNetworkAsset } from './isNetworkAsset';\n\nexport interface PackageHostPolicy {\n    allowExecutableImports: boolean;\n    allowNetworkAssets: boolean;\n\n    /** Whether this host is resolving optional design-time bundles in addition to runtime contributions. */\n    loadDesignTime?: boolean;\n}\n\nexport interface PackageHostConfiguration {\n    bundles: ScenePackageBundle[];\n    profile: UiProfile;\n    policy: PackageHostPolicy;\n\n    /** The Scene version the host runs, checked against each template's compatibility range when given. */\n    sceneVersion?: string;\n}\n\nexport interface ResolvedPackageHost {\n    bundles: ScenePackageBundle[];\n    components: ReturnType<typeof mergePackageRegistries>;\n    layouts: Layout[];\n    screenTemplates: ScreenTemplate[];\n    dialogTemplates: DialogTemplate[];\n    themes: Theme[];\n\n    /** The layout the UI profile names, from the approved packages. Absent when the profile names none. */\n    layout?: Layout;\n\n    /** The theme the UI profile names, from the approved packages. Absent when the profile names none. */\n    theme?: Theme;\n\n    /**\n     * Every template the approved packages provide, with compatibility, attribution and license metadata and\n     * whether it can be used with this package set. Template browsers read this rather than the raw lists.\n     */\n    templates: TemplateCatalogEntry[];\n    icons: IconAdapterRegistry;\n    assets: string[];\n    fonts: string[];\n    blocked: boolean;\n    diagnostics: string[];\n}\n\n/**\n * Resolves the approved package set a standalone or embedded React host uses.\n */\nexport function resolvePackageHost(configuration: PackageHostConfiguration): ResolvedPackageHost {\n    const diagnostics: string[] = [];\n    const names = new Map<string, number>();\n    for (const bundle of configuration.bundles) {\n        names.set(bundle.manifest.name, (names.get(bundle.manifest.name) ?? 0) + 1);\n    }\n\n    for (const [name, count] of names) {\n        if (count > 1) diagnostics.push(`Package '${name}' is approved more than once; duplicate bundles are ambiguous`);\n    }\n\n    const byName = new Map(configuration.bundles.map(bundle => [bundle.manifest.name, bundle]));\n    const selection = resolvePackageDependencies(configuration.profile.packages, configuration.bundles.map(bundle => bundle.manifest));\n    for (const missing of selection.missing) diagnostics.push(`Package '${missing.package}' depends on missing package '${missing.dependsOn}'`);\n    for (const conflict of selection.versionConflicts) {\n        diagnostics.push(`Package '${conflict.package}' requires '${conflict.dependsOn}' ${conflict.requiredRange} but approved version is ${conflict.actualVersion}`);\n    }\n    for (const cycle of selection.cycles) diagnostics.push(`Package dependency cycle: ${cycle.join(' -> ')}`);\n\n    const bundles: ScenePackageBundle[] = [];\n    const runtimeSingletons = new Map<string, string>();\n    const assets: string[] = [];\n\n    for (const packageName of selection.packages) {\n        const bundle = byName.get(packageName);\n        if (!bundle) {\n            diagnostics.push(`UI profile asks for '${packageName}' but the host did not approve a bundle for it`);\n            continue;\n        }\n\n        diagnostics.push(...validatePackageBundle(bundle).map(problem => `${packageName}: ${problem}`));\n        if (configuration.policy.loadDesignTime === true && !configuration.policy.allowExecutableImports && bundle.designTime) {\n            diagnostics.push(`Package '${packageName}' provides executable design-time contributions, but host policy forbids them`);\n        }\n\n        const packageAssets = bundle.manifest.assets ?? [];\n        const networkAssets = packageAssets.filter(isNetworkAsset);\n        if (!configuration.policy.allowNetworkAssets && networkAssets.length > 0) {\n            diagnostics.push(`Package '${packageName}' declares network assets (${networkAssets.join(', ')}), but host policy forbids them`);\n        }\n        assets.push(...packageAssets);\n\n        for (const dependency of bundle.manifest.runtimeSingletons ?? []) {\n            const owner = runtimeSingletons.get(dependency);\n            if (owner && owner !== packageName) {\n                diagnostics.push(`Runtime singleton '${dependency}' is provided by both '${owner}' and '${packageName}'`);\n            }\n            runtimeSingletons.set(dependency, packageName);\n        }\n\n        bundles.push(bundle);\n    }\n\n    const layouts = bundles.flatMap(bundle => bundle.layouts ?? []);\n    const themes = bundles.flatMap(bundle => bundle.themes ?? []);\n    const layout = configuration.profile.layout ? layouts.find(candidate => candidate.name === configuration.profile.layout) : undefined;\n    const theme = configuration.profile.theme ? themes.find(candidate => candidate.name === configuration.profile.theme) : undefined;\n    if (configuration.profile.layout && !layout) {\n        diagnostics.push(`UI profile '${configuration.profile.name}' uses layout '${configuration.profile.layout}', which no approved package provides`);\n    }\n    if (configuration.profile.theme && !theme) {\n        diagnostics.push(`UI profile '${configuration.profile.name}' uses theme '${configuration.profile.theme}', which no approved package provides`);\n    } else if (theme && incompatiblePackages(theme, configuration.profile).length > 0) {\n        diagnostics.push(`Theme '${theme.name}' is not compatible with ${incompatiblePackages(theme, configuration.profile).join(', ')} in UI profile '${configuration.profile.name}'`);\n    }\n\n    const blocked = diagnostics.length > 0;\n    const approved = blocked ? [] : bundles;\n    const approvedAssets = blocked ? [] : assets;\n\n    return {\n        bundles: approved,\n        components: mergePackageRegistries(approved),\n        layouts: approved.flatMap(bundle => bundle.layouts ?? []),\n        screenTemplates: approved.flatMap(bundle => bundle.screenTemplates ?? []),\n        dialogTemplates: approved.flatMap(bundle => bundle.dialogTemplates ?? []),\n        themes: approved.flatMap(bundle => bundle.themes ?? []),\n        layout: blocked ? undefined : layout,\n        theme: blocked ? undefined : theme,\n        templates: describeTemplateCatalog(approved, configuration.sceneVersion),\n        icons: createIconAdapterRegistry(approved.map(bundle => bundle.iconLibrary?.adapter).filter(adapter => adapter !== undefined)),\n        assets: approvedAssets,\n        fonts: approvedAssets.filter(isFontAsset),\n        blocked,\n        diagnostics,\n    };\n}\n\nfunction isFontAsset(asset: string): boolean {\n    return /\\.(woff2?|otf|ttf)(\\?|$)/.test(asset) || asset.includes('/fonts/');\n}\n"],"names":["resolvePackageHost","configuration","diagnostics","names","Map","bundle","bundles","set","manifest","name","get","count","push","byName","map","selection","resolvePackageDependencies","profile","packages","missing","package","dependsOn","conflict","versionConflicts","requiredRange","actualVersion","cycle","cycles","join","runtimeSingletons","assets","packageName","validatePackageBundle","problem","policy","loadDesignTime","allowExecutableImports","designTime","packageAssets","networkAssets","filter","isNetworkAsset","allowNetworkAssets","length","dependency","owner","layouts","flatMap","themes","layout","find","candidate","undefined","theme","incompatiblePackages","blocked","approved","approvedAssets","components","mergePackageRegistries","screenTemplates","dialogTemplates","templates","describeTemplateCatalog","sceneVersion","icons","createIconAdapterRegistry","iconLibrary","adapter","fonts","isFontAsset","asset","test","includes"],"mappings":"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"}

package/dist/esm/packages/index.d.ts

@@ -13,6 +13,7 @@ export * from './DesignTimeResolution';
 export * from '../navigation';
 export * from './EmbeddedPackageHost';
 export * from './loadDesignTimeContributions';
+export * from './isNetworkAsset';
 export * from './PackageHostAssets';
 export * from './PackageHostConfiguration';
 export * from './PackageHostRenderMode';

package/dist/esm/packages/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../packages/index.ts"],"names":[],"mappings":"AAGA,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../packages/index.ts"],"names":[],"mappings":"AAGA,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC"}

package/dist/esm/packages/index.js

@@ -13,6 +13,7 @@ export * from './DesignTimeResolution';
 export * from '../navigation';
 export * from './EmbeddedPackageHost';
 export * from './loadDesignTimeContributions';
+export * from './isNetworkAsset';
 export * from './PackageHostAssets';
 export * from './PackageHostConfiguration';
 export * from './PackageHostRenderMode';

package/dist/esm/packages/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../packages/index.ts"],"names":[],"mappings":"AAGA,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../packages/index.ts"],"names":[],"mappings":"AAGA,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC"}

package/dist/esm/packages/isNetworkAsset.d.ts

@@ -0,0 +1,2 @@
+export declare function isNetworkAsset(asset: string): boolean;
+//# sourceMappingURL=isNetworkAsset.d.ts.map

package/dist/esm/packages/isNetworkAsset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isNetworkAsset.d.ts","sourceRoot":"","sources":["../../../packages/isNetworkAsset.ts"],"names":[],"mappings":"AASA,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAKrD"}

package/dist/esm/packages/isNetworkAsset.js

@@ -0,0 +1,16 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Whether loading an asset reaches beyond the host: an absolute URL with any scheme other than `data:`
+ * or `blob:` (`https://`, `http://`, `ws://`, `ftp://`), or a protocol-relative `//host/...` reference. A
+ * package-relative path or a bare module specifier such as `@cratis/components/styles` is resolved by the
+ * host from what it bundled, so it is not a network asset.
+ */ function isNetworkAsset(asset) {
+    const trimmed = asset.trim();
+    if (trimmed.startsWith('//')) return true;
+    const scheme = /^([a-zA-Z][a-zA-Z0-9+.-]*):/.exec(trimmed)?.[1]?.toLowerCase();
+    return scheme !== undefined && scheme !== 'data' && scheme !== 'blob';
+}
+
+export { isNetworkAsset };
+//# sourceMappingURL=isNetworkAsset.js.map

package/dist/esm/packages/isNetworkAsset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isNetworkAsset.js","sources":["../../../packages/isNetworkAsset.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 * Whether loading an asset reaches beyond the host: an absolute URL with any scheme other than `data:`\n * or `blob:` (`https://`, `http://`, `ws://`, `ftp://`), or a protocol-relative `//host/...` reference. A\n * package-relative path or a bare module specifier such as `@cratis/components/styles` is resolved by the\n * host from what it bundled, so it is not a network asset.\n */\nexport function isNetworkAsset(asset: string): boolean {\n    const trimmed = asset.trim();\n    if (trimmed.startsWith('//')) return true;\n    const scheme = /^([a-zA-Z][a-zA-Z0-9+.-]*):/.exec(trimmed)?.[1]?.toLowerCase();\n    return scheme !== undefined && scheme !== 'data' && scheme !== 'blob';\n}\n"],"names":["isNetworkAsset","asset","trimmed","trim","startsWith","scheme","exec","toLowerCase","undefined"],"mappings":"AAAA;AACA;AAEA;;;;;IAMO,SAASA,cAAAA,CAAeC,KAAa,EAAA;IACxC,MAAMC,OAAAA,GAAUD,MAAME,IAAI,EAAA;AAC1B,IAAA,IAAID,OAAAA,CAAQE,UAAU,CAAC,IAAA,CAAA,EAAO,OAAO,IAAA;AACrC,IAAA,MAAMC,SAAS,6BAAA,CAA8BC,IAAI,CAACJ,OAAAA,CAAAA,GAAW,EAAE,EAAEK,WAAAA,EAAAA;AACjE,IAAA,OAAOF,MAAAA,KAAWG,SAAAA,IAAaH,MAAAA,KAAW,MAAA,IAAUA,MAAAA,KAAW,MAAA;AACnE;;"}

package/dist/esm/renderer/RenderBindingScopeContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RenderBindingScopeContext.d.ts","sourceRoot":"","sources":["../../../renderer/RenderBindingScopeContext.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAA2D,MAAM,OAAO,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,YAAY,EAA4B,MAAM,sBAAsB,CAAC;AAW/F,MAAM,WAAW,+BAA+B;IAC5C,QAAQ,EAAE,SAAS,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,cAAc,CAAC,EAAE,eAAe,CAAC;IACjC,yBAAyB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC;CAC1F;AAKD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,+BAA+B,+BAShF;AA4BD,wBAAgB,wBAAwB,IAAI,eAAe,CAI1D;AAED,wBAAgB,qBAAqB,IAAI,YAAY,CAEpD"}
+{"version":3,"file":"RenderBindingScopeContext.d.ts","sourceRoot":"","sources":["../../../renderer/RenderBindingScopeContext.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAA2D,MAAM,OAAO,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,YAAY,EAA8C,MAAM,sBAAsB,CAAC;AAWjH,MAAM,WAAW,+BAA+B;IAC5C,QAAQ,EAAE,SAAS,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,cAAc,CAAC,EAAE,eAAe,CAAC;IACjC,yBAAyB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC;CAC1F;AAUD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,+BAA+B,+BAShF;AA2BD,wBAAgB,wBAAwB,IAAI,eAAe,CAI1D;AAED,wBAAgB,qBAAqB,IAAI,YAAY,CAEpD"}

package/dist/esm/renderer/RenderBindingScopeContext.js

@@ -1,16 +1,22 @@
-import { jsx, Fragment } from 'react/jsx-runtime';
+import { jsx } from 'react/jsx-runtime';
 import { useContext, createContext, useRef, useMemo, useCallback } from 'react';
-import { resolveBindingExpression } from '@cratis/scene.engine';
+import { nestBindingScope, resolveBindingExpression } from '@cratis/scene.engine';
 import { BindingNullBehavior } from '@cratis/scene.model';
 import { BindingOutputProvider, useBindingOutputScope } from './BindingOutputContext.js';
 
 const Context = /*#__PURE__*/ createContext(undefined);
 /**
  * Provides the inherited reactive binding scope for a rendered Scene tree.
+ *
+ * The outermost provider owns the component output scope. A provider rendered inside another - a nested
+ * template or region - nests its own data context, query results and component outputs over the inherited
+ * scope with `nestBindingScope`, so a detail region bound to the selected row reads that row while still
+ * seeing the screen's queries and every component's outputs.
  */ function RenderBindingScopeProvider(props) {
     const current = useContext(Context);
-    if (current) return /*#__PURE__*/ jsx(Fragment, {
-        children: props.children
+    if (current) return /*#__PURE__*/ jsx(RenderBindingScopeInner, {
+        ...props,
+        parent: current.scope
     });
     return /*#__PURE__*/ jsx(BindingOutputProvider, {
         onOutputsChanged: props.onComponentOutputsChanged,
@@ -19,20 +25,24 @@ const Context = /*#__PURE__*/ createContext(undefined);
         })
     });
 }
-function RenderBindingScopeInner({ children, dataContext, queryResults, componentOutputs, resolveBinding }) {
+function RenderBindingScopeInner({ children, dataContext, queryResults, componentOutputs, resolveBinding, parent }) {
     const outputs = useBindingOutputScope();
     const previousValues = useRef(new Map());
-    const scope = useMemo(()=>({
+    const scope = useMemo(()=>{
+        const own = {
             dataContext,
             queryResults,
             componentOutputs: {
                 ...componentOutputs ?? {},
                 ...outputs
             }
-        }), [
+        };
+        return parent ? nestBindingScope(parent, own) : own;
+    }, [
         componentOutputs,
         dataContext,
         outputs,
+        parent,
         queryResults
     ]);
     const resolver = useCallback((binding)=>{

package/dist/esm/renderer/RenderBindingScopeContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"RenderBindingScopeContext.js","sources":["../../../renderer/RenderBindingScopeContext.tsx"],"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 { ReactNode, createContext, useCallback, useContext, useMemo, useRef } from 'react';\nimport { BindingResolver, BindingScope, resolveBindingExpression } from '@cratis/scene.engine';\nimport { BindingExpression, BindingNullBehavior } from '@cratis/scene.model';\nimport { BindingOutputProvider, useBindingOutputScope } from './BindingOutputContext';\n\ninterface RenderBindingScopeValue {\n    resolveBinding: BindingResolver;\n    scope: BindingScope;\n}\n\nconst Context = createContext<RenderBindingScopeValue | undefined>(undefined);\n\nexport interface RenderBindingScopeProviderProps {\n    children: ReactNode;\n    dataContext?: unknown;\n    queryResults?: Record<string, unknown>;\n    componentOutputs?: Record<string, Record<string, unknown>>;\n    resolveBinding?: BindingResolver;\n    onComponentOutputsChanged?: (outputs: Record<string, Record<string, unknown>>) => void;\n}\n\n/**\n * Provides the inherited reactive binding scope for a rendered Scene tree.\n */\nexport function RenderBindingScopeProvider(props: RenderBindingScopeProviderProps) {\n    const current = useContext(Context);\n    if (current) return <>{props.children}</>;\n\n    return (\n        <BindingOutputProvider onOutputsChanged={props.onComponentOutputsChanged}>\n            <RenderBindingScopeInner {...props} />\n        </BindingOutputProvider>\n    );\n}\n\nfunction RenderBindingScopeInner({ children, dataContext, queryResults, componentOutputs, resolveBinding }: RenderBindingScopeProviderProps) {\n    const outputs = useBindingOutputScope();\n    const previousValues = useRef(new Map<string, unknown>());\n    const scope = useMemo<BindingScope>(() => ({\n        dataContext,\n        queryResults,\n        componentOutputs: { ...(componentOutputs ?? {}), ...outputs },\n    }), [componentOutputs, dataContext, outputs, queryResults]);\n\n    const resolver = useCallback<BindingResolver>((binding: BindingExpression) => {\n        if (!binding.kind && resolveBinding) return resolveBinding(binding);\n\n        const key = JSON.stringify(binding);\n        const value = resolveBindingExpression(binding, scope);\n        if (binding.nullBehavior === BindingNullBehavior.Preserve && value === undefined) {\n            return previousValues.current.get(key);\n        }\n\n        if (value !== undefined) previousValues.current.set(key, value);\n        return value;\n    }, [resolveBinding, scope]);\n\n    const value = useMemo<RenderBindingScopeValue>(() => ({ resolveBinding: resolver, scope }), [resolver, scope]);\n    return <Context.Provider value={value}>{children}</Context.Provider>;\n}\n\nexport function useRenderBindingResolver(): BindingResolver {\n    const context = useContext(Context);\n    if (!context) throw new Error('No Scene render binding scope is available.');\n    return context.resolveBinding;\n}\n\nexport function useRenderBindingScope(): BindingScope {\n    return useContext(Context)?.scope ?? {};\n}\n"],"names":["Context","createContext","undefined","RenderBindingScopeProvider","props","current","useContext","_jsx","_Fragment","children","BindingOutputProvider","onOutputsChanged","onComponentOutputsChanged","RenderBindingScopeInner","dataContext","queryResults","componentOutputs","resolveBinding","outputs","useBindingOutputScope","previousValues","useRef","Map","scope","useMemo","resolver","useCallback","binding","kind","key","JSON","stringify","value","resolveBindingExpression","nullBehavior","BindingNullBehavior","Preserve","get","set","Provider","useRenderBindingResolver","context","Error","useRenderBindingScope"],"mappings":";;;;;;AAaA,MAAMA,wBAAUC,aAAAA,CAAmDC,SAAAA,CAAAA;AAWnE;;IAGO,SAASC,0BAAAA,CAA2BC,KAAsC,EAAA;AAC7E,IAAA,MAAMC,UAAUC,UAAAA,CAAWN,OAAAA,CAAAA;AAC3B,IAAA,IAAIK,SAAS,qBAAOE,GAAA,CAAAC,QAAA,EAAA;AAAGJ,QAAAA,QAAAA,EAAAA,KAAAA,CAAMK;;AAE7B,IAAA,qBACIF,GAAA,CAACG,qBAAAA,EAAAA;AAAsBC,QAAAA,gBAAAA,EAAkBP,MAAMQ,yBAAyB;AACpE,QAAA,QAAA,gBAAAL,GAAA,CAACM,uBAAAA,EAAAA;AAAyB,YAAA,GAAGT;;;AAGzC;AAEA,SAASS,uBAAAA,CAAwB,EAAEJ,QAAQ,EAAEK,WAAW,EAAEC,YAAY,EAAEC,gBAAgB,EAAEC,cAAc,EAAmC,EAAA;AACvI,IAAA,MAAMC,OAAAA,GAAUC,qBAAAA,EAAAA;IAChB,MAAMC,cAAAA,GAAiBC,OAAO,IAAIC,GAAAA,EAAAA,CAAAA;IAClC,MAAMC,KAAAA,GAAQC,OAAAA,CAAsB,KAAO;AACvCV,YAAAA,WAAAA;AACAC,YAAAA,YAAAA;YACAC,gBAAAA,EAAkB;gBAAE,GAAIA,gBAAAA,IAAoB,EAAE;AAAG,gBAAA,GAAGE;AAAQ;AAChE,SAAA,CAAA,EAAI;AAACF,QAAAA,gBAAAA;AAAkBF,QAAAA,WAAAA;AAAaI,QAAAA,OAAAA;AAASH,QAAAA;AAAa,KAAA,CAAA;IAE1D,MAAMU,QAAAA,GAAWC,YAA6B,CAACC,OAAAA,GAAAA;AAC3C,QAAA,IAAI,CAACA,OAAAA,CAAQC,IAAI,IAAIX,cAAAA,EAAgB,OAAOA,cAAAA,CAAeU,OAAAA,CAAAA;QAE3D,MAAME,GAAAA,GAAMC,IAAAA,CAAKC,SAAS,CAACJ,OAAAA,CAAAA;QAC3B,MAAMK,KAAAA,GAAQC,yBAAyBN,OAAAA,EAASJ,KAAAA,CAAAA;AAChD,QAAA,IAAII,QAAQO,YAAY,KAAKC,oBAAoBC,QAAQ,IAAIJ,UAAU9B,SAAAA,EAAW;AAC9E,YAAA,OAAOkB,cAAAA,CAAef,OAAO,CAACgC,GAAG,CAACR,GAAAA,CAAAA;AACtC,QAAA;AAEA,QAAA,IAAIG,UAAU9B,SAAAA,EAAWkB,cAAAA,CAAef,OAAO,CAACiC,GAAG,CAACT,GAAAA,EAAKG,KAAAA,CAAAA;QACzD,OAAOA,KAAAA;IACX,CAAA,EAAG;AAACf,QAAAA,cAAAA;AAAgBM,QAAAA;AAAM,KAAA,CAAA;IAE1B,MAAMS,KAAAA,GAAQR,OAAAA,CAAiC,KAAO;YAAEP,cAAAA,EAAgBQ,QAAAA;AAAUF,YAAAA;AAAM,SAAA,CAAA,EAAI;AAACE,QAAAA,QAAAA;AAAUF,QAAAA;AAAM,KAAA,CAAA;IAC7G,qBAAOhB,GAAA,CAACP,QAAQuC,QAAQ,EAAA;QAACP,KAAAA,EAAOA,KAAAA;AAAQvB,QAAAA,QAAAA,EAAAA;;AAC5C;AAEO,SAAS+B,wBAAAA,GAAAA;AACZ,IAAA,MAAMC,UAAUnC,UAAAA,CAAWN,OAAAA,CAAAA;AAC3B,IAAA,IAAI,CAACyC,OAAAA,EAAS,MAAM,IAAIC,KAAAA,CAAM,6CAAA,CAAA;AAC9B,IAAA,OAAOD,QAAQxB,cAAc;AACjC;AAEO,SAAS0B,qBAAAA,GAAAA;IACZ,OAAOrC,UAAAA,CAAWN,OAAAA,CAAAA,EAAUuB,KAAAA,IAAS,EAAC;AAC1C;;"}
+{"version":3,"file":"RenderBindingScopeContext.js","sources":["../../../renderer/RenderBindingScopeContext.tsx"],"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 { ReactNode, createContext, useCallback, useContext, useMemo, useRef } from 'react';\nimport { BindingResolver, BindingScope, nestBindingScope, resolveBindingExpression } from '@cratis/scene.engine';\nimport { BindingExpression, BindingNullBehavior } from '@cratis/scene.model';\nimport { BindingOutputProvider, useBindingOutputScope } from './BindingOutputContext';\n\ninterface RenderBindingScopeValue {\n    resolveBinding: BindingResolver;\n    scope: BindingScope;\n}\n\nconst Context = createContext<RenderBindingScopeValue | undefined>(undefined);\n\nexport interface RenderBindingScopeProviderProps {\n    children: ReactNode;\n    dataContext?: unknown;\n    queryResults?: Record<string, unknown>;\n    componentOutputs?: Record<string, Record<string, unknown>>;\n    resolveBinding?: BindingResolver;\n    onComponentOutputsChanged?: (outputs: Record<string, Record<string, unknown>>) => void;\n}\n\n/**\n * Provides the inherited reactive binding scope for a rendered Scene tree.\n *\n * The outermost provider owns the component output scope. A provider rendered inside another - a nested\n * template or region - nests its own data context, query results and component outputs over the inherited\n * scope with `nestBindingScope`, so a detail region bound to the selected row reads that row while still\n * seeing the screen's queries and every component's outputs.\n */\nexport function RenderBindingScopeProvider(props: RenderBindingScopeProviderProps) {\n    const current = useContext(Context);\n    if (current) return <RenderBindingScopeInner {...props} parent={current.scope} />;\n\n    return (\n        <BindingOutputProvider onOutputsChanged={props.onComponentOutputsChanged}>\n            <RenderBindingScopeInner {...props} />\n        </BindingOutputProvider>\n    );\n}\n\nfunction RenderBindingScopeInner({ children, dataContext, queryResults, componentOutputs, resolveBinding, parent }: RenderBindingScopeProviderProps & { parent?: BindingScope }) {\n    const outputs = useBindingOutputScope();\n    const previousValues = useRef(new Map<string, unknown>());\n    const scope = useMemo<BindingScope>(() => {\n        const own = { dataContext, queryResults, componentOutputs: { ...(componentOutputs ?? {}), ...outputs } };\n        return parent ? nestBindingScope(parent, own) : own;\n    }, [componentOutputs, dataContext, outputs, parent, queryResults]);\n\n    const resolver = useCallback<BindingResolver>((binding: BindingExpression) => {\n        if (!binding.kind && resolveBinding) return resolveBinding(binding);\n\n        const key = JSON.stringify(binding);\n        const value = resolveBindingExpression(binding, scope);\n        if (binding.nullBehavior === BindingNullBehavior.Preserve && value === undefined) {\n            return previousValues.current.get(key);\n        }\n\n        if (value !== undefined) previousValues.current.set(key, value);\n        return value;\n    }, [resolveBinding, scope]);\n\n    const value = useMemo<RenderBindingScopeValue>(() => ({ resolveBinding: resolver, scope }), [resolver, scope]);\n    return <Context.Provider value={value}>{children}</Context.Provider>;\n}\n\nexport function useRenderBindingResolver(): BindingResolver {\n    const context = useContext(Context);\n    if (!context) throw new Error('No Scene render binding scope is available.');\n    return context.resolveBinding;\n}\n\nexport function useRenderBindingScope(): BindingScope {\n    return useContext(Context)?.scope ?? {};\n}\n"],"names":["Context","createContext","undefined","RenderBindingScopeProvider","props","current","useContext","_jsx","RenderBindingScopeInner","parent","scope","BindingOutputProvider","onOutputsChanged","onComponentOutputsChanged","children","dataContext","queryResults","componentOutputs","resolveBinding","outputs","useBindingOutputScope","previousValues","useRef","Map","useMemo","own","nestBindingScope","resolver","useCallback","binding","kind","key","JSON","stringify","value","resolveBindingExpression","nullBehavior","BindingNullBehavior","Preserve","get","set","Provider","useRenderBindingResolver","context","Error","useRenderBindingScope"],"mappings":"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"}

package/dist/esm/renderer/index.d.ts

@@ -3,6 +3,7 @@ export * from './BindingOutputContext';
 export * from './ComponentRegistry';
 export * from './RenderBindingScopeContext';
 export * from './UnresolvedComponent';
+export * from './useBoundQuery';
 export * from './createReactRenderer';
 export * from './InteractiveComponent';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/renderer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../renderer/index.ts"],"names":[],"mappings":"AAGA,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../renderer/index.ts"],"names":[],"mappings":"AAGA,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC"}

package/dist/esm/renderer/index.js

@@ -3,6 +3,7 @@ export * from './BindingOutputContext';
 export * from './ComponentRegistry';
 export * from './RenderBindingScopeContext';
 export * from './UnresolvedComponent';
+export * from './useBoundQuery';
 export * from './createReactRenderer';
 export * from './InteractiveComponent';
 //# sourceMappingURL=index.js.map

package/dist/esm/renderer/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../renderer/index.ts"],"names":[],"mappings":"AAGA,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../renderer/index.ts"],"names":[],"mappings":"AAGA,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC"}

package/dist/esm/renderer/useBoundQuery.d.ts

@@ -0,0 +1,3 @@
+import { QueryPerformer } from './AbortableQueryRunner';
+export declare function useBoundQuery(query: string, argumentsValue: unknown, perform: QueryPerformer): Record<string, unknown>;
+//# sourceMappingURL=useBoundQuery.d.ts.map

package/dist/esm/renderer/useBoundQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBoundQuery.d.ts","sourceRoot":"","sources":["../../../renderer/useBoundQuery.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAWxD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiCtH"}

package/dist/esm/renderer/useBoundQuery.js

@@ -0,0 +1,48 @@
+import { useMemo, useState, useRef, useEffect } from 'react';
+import { QueryBindingState } from '@cratis/scene.engine';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Runs a bound query whenever its arguments change and returns the accepted query results.
+ *
+ * Each change of arguments rebinds the query: the previous run is aborted and, should its answer still
+ * arrive, discarded by `QueryBindingState` - a slow result for a previous selection never replaces the
+ * current one. Arguments of `undefined` mean the binding is cleared, as when a selection is cleared, so the
+ * result is removed, and so is it when the current run fails - a failed rebind must not leave the previous
+ * selection's data on screen. The results are keyed by `query`, ready to pass as a scope's `queryResults`.
+ */ function useBoundQuery(query, argumentsValue, perform) {
+    const state = useMemo(()=>new QueryBindingState(), []);
+    const [results, setResults] = useState({});
+    const key = argumentsValue === undefined ? undefined : JSON.stringify(argumentsValue);
+    const latestArguments = useRef(argumentsValue);
+    latestArguments.current = argumentsValue;
+    // The arguments are compared by value through `key`; the effect reads them from `latestArguments`.
+    useEffect(()=>{
+        const argumentsForRun = latestArguments.current;
+        if (argumentsForRun === undefined) {
+            state.clear(query);
+            setResults(state.queryResults);
+            return undefined;
+        }
+        const controller = new AbortController();
+        const ticket = state.begin(query);
+        perform(query, argumentsForRun, controller.signal).then((result)=>{
+            if (state.complete(ticket, result)) setResults(state.queryResults);
+        }, ()=>{
+            if (controller.signal.aborted || !state.complete(ticket, undefined)) return;
+            state.clear(query);
+            setResults(state.queryResults);
+        });
+        return ()=>controller.abort();
+    }, [
+        key,
+        perform,
+        query,
+        state
+    ]);
+    return results;
+}
+
+export { useBoundQuery };
+//# sourceMappingURL=useBoundQuery.js.map

package/dist/esm/renderer/useBoundQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBoundQuery.js","sources":["../../../renderer/useBoundQuery.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 { useEffect, useMemo, useRef, useState } from 'react';\nimport { QueryBindingState } from '@cratis/scene.engine';\nimport { QueryPerformer } from './AbortableQueryRunner';\n\n/**\n * Runs a bound query whenever its arguments change and returns the accepted query results.\n *\n * Each change of arguments rebinds the query: the previous run is aborted and, should its answer still\n * arrive, discarded by `QueryBindingState` - a slow result for a previous selection never replaces the\n * current one. Arguments of `undefined` mean the binding is cleared, as when a selection is cleared, so the\n * result is removed, and so is it when the current run fails - a failed rebind must not leave the previous\n * selection's data on screen. The results are keyed by `query`, ready to pass as a scope's `queryResults`.\n */\nexport function useBoundQuery(query: string, argumentsValue: unknown, perform: QueryPerformer): Record<string, unknown> {\n    const state = useMemo(() => new QueryBindingState(), []);\n    const [results, setResults] = useState<Record<string, unknown>>({});\n    const key = argumentsValue === undefined ? undefined : JSON.stringify(argumentsValue);\n    const latestArguments = useRef(argumentsValue);\n    latestArguments.current = argumentsValue;\n\n    // The arguments are compared by value through `key`; the effect reads them from `latestArguments`.\n    useEffect(() => {\n        const argumentsForRun = latestArguments.current;\n        if (argumentsForRun === undefined) {\n            state.clear(query);\n            setResults(state.queryResults);\n            return undefined;\n        }\n\n        const controller = new AbortController();\n        const ticket = state.begin(query);\n        perform(query, argumentsForRun, controller.signal).then(\n            result => {\n                if (state.complete(ticket, result)) setResults(state.queryResults);\n            },\n            () => {\n                if (controller.signal.aborted || !state.complete(ticket, undefined)) return;\n                state.clear(query);\n                setResults(state.queryResults);\n            },\n        );\n\n        return () => controller.abort();\n    }, [key, perform, query, state]);\n\n    return results;\n}\n"],"names":["useBoundQuery","query","argumentsValue","perform","state","useMemo","QueryBindingState","results","setResults","useState","key","undefined","JSON","stringify","latestArguments","useRef","current","useEffect","argumentsForRun","clear","queryResults","controller","AbortController","ticket","begin","signal","then","result","complete","aborted","abort"],"mappings":";;;AAAA;AACA;AAMA;;;;;;;;AAQC,IACM,SAASA,aAAAA,CAAcC,KAAa,EAAEC,cAAuB,EAAEC,OAAuB,EAAA;AACzF,IAAA,MAAMC,KAAAA,GAAQC,OAAAA,CAAQ,IAAM,IAAIC,qBAAqB,EAAE,CAAA;AACvD,IAAA,MAAM,CAACC,OAAAA,EAASC,UAAAA,CAAW,GAAGC,SAAkC,EAAC,CAAA;AACjE,IAAA,MAAMC,MAAMR,cAAAA,KAAmBS,SAAAA,GAAYA,SAAAA,GAAYC,IAAAA,CAAKC,SAAS,CAACX,cAAAA,CAAAA;AACtE,IAAA,MAAMY,kBAAkBC,MAAAA,CAAOb,cAAAA,CAAAA;AAC/BY,IAAAA,eAAAA,CAAgBE,OAAO,GAAGd,cAAAA;;IAG1Be,SAAAA,CAAU,IAAA;QACN,MAAMC,eAAAA,GAAkBJ,gBAAgBE,OAAO;AAC/C,QAAA,IAAIE,oBAAoBP,SAAAA,EAAW;AAC/BP,YAAAA,KAAAA,CAAMe,KAAK,CAAClB,KAAAA,CAAAA;AACZO,YAAAA,UAAAA,CAAWJ,MAAMgB,YAAY,CAAA;YAC7B,OAAOT,SAAAA;AACX,QAAA;AAEA,QAAA,MAAMU,aAAa,IAAIC,eAAAA,EAAAA;QACvB,MAAMC,MAAAA,GAASnB,KAAAA,CAAMoB,KAAK,CAACvB,KAAAA,CAAAA;AAC3BE,QAAAA,OAAAA,CAAQF,OAAOiB,eAAAA,EAAiBG,UAAAA,CAAWI,MAAM,CAAA,CAAEC,IAAI,CACnDC,CAAAA,MAAAA,GAAAA;AACI,YAAA,IAAIvB,MAAMwB,QAAQ,CAACL,QAAQI,MAAAA,CAAAA,EAASnB,UAAAA,CAAWJ,MAAMgB,YAAY,CAAA;QACrE,CAAA,EACA,IAAA;YACI,IAAIC,UAAAA,CAAWI,MAAM,CAACI,OAAO,IAAI,CAACzB,KAAAA,CAAMwB,QAAQ,CAACL,MAAAA,EAAQZ,SAAAA,CAAAA,EAAY;AACrEP,YAAAA,KAAAA,CAAMe,KAAK,CAAClB,KAAAA,CAAAA;AACZO,YAAAA,UAAAA,CAAWJ,MAAMgB,YAAY,CAAA;AACjC,QAAA,CAAA,CAAA;QAGJ,OAAO,IAAMC,WAAWS,KAAK,EAAA;IACjC,CAAA,EAAG;AAACpB,QAAAA,GAAAA;AAAKP,QAAAA,OAAAA;AAASF,QAAAA,KAAAA;AAAOG,QAAAA;AAAM,KAAA,CAAA;IAE/B,OAAOG,OAAAA;AACX;;"}