@cratis/scene.engine 3.7.0 → 4.0.0

package/ActionDispatcher.ts

@@ -0,0 +1,87 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { NotificationLevel } from '@cratis/scene.model';
+
+/**
+ * What came back from executing a command.
+ *
+ * Validation and authorization failures are outcomes rather than exceptions, because the model already describes
+ * them and a form has to show them next to the field they belong to.
+ */
+export interface CommandOutcome {
+    isSuccess: boolean;
+    validationErrors?: { member: string; message: string }[];
+    exceptionMessages?: string[];
+    response?: unknown;
+}
+
+/**
+ * What came back from a dialog that closed.
+ */
+export interface DialogOutcome {
+    isConfirmed: boolean;
+    result?: unknown;
+}
+
+/**
+ * The seam a renderer implements, one method per action kind.
+ *
+ * The engine decides *what* happens and in what order; the dispatcher performs the effects. That split is what
+ * keeps the sequencing - continuations, short-circuits, ordering - testable without a DOM, and what lets a
+ * non-React renderer inherit the semantics instead of reimplementing them.
+ *
+ * Every method that can fail returns an outcome rather than throwing, so a failure is something the engine can
+ * branch on with `on failure` instead of something that unwinds the whole interaction.
+ */
+export interface ActionDispatcher {
+    /**
+     * Submits a command.
+     */
+    executeCommand(command: string, args: Record<string, unknown>): Promise<CommandOutcome>;
+
+    /**
+     * Goes to a screen. The dispatcher decides what address that is, if its platform has addresses at all.
+     */
+    navigate(screen: string, args: Record<string, unknown>): Promise<void> | void;
+
+    /**
+     * Goes back.
+     */
+    navigateBack(): Promise<void> | void;
+
+    /**
+     * Opens a dialog and resolves when it closes.
+     */
+    openDialog(dialogTemplate: string, args: Record<string, unknown>): Promise<DialogOutcome>;
+
+    /**
+     * Closes the innermost dialog.
+     */
+    closeDialog(result?: unknown): Promise<void> | void;
+
+    /**
+     * Re-runs a query.
+     */
+    refreshQuery(query: string): Promise<void>;
+
+    /**
+     * Writes screen state.
+     */
+    setState(target: string, value: unknown): void;
+
+    /**
+     * Surfaces a message.
+     */
+    notify(level: NotificationLevel, message: string): void;
+
+    /**
+     * Asks the user to confirm, and resolves with what they chose.
+     */
+    confirm(message: string): Promise<boolean>;
+
+    /**
+     * Fires an application trigger.
+     */
+    raise(trigger: string, args: Record<string, unknown>): Promise<void>;
+}

package/buildStarterProfile.ts

@@ -1,7 +1,7 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { SizeClass, UiProfile, UiStarter } from '@cratis/scene.model';
+import { TargetSizeClass, UiProfile, UiStarter } from '@cratis/scene.model';
 
 /**
  * Builds the sandboxed {@link UiProfile} a {@link UiStarter}'s gallery boots through - part of
@@ -16,6 +16,6 @@ import { SizeClass, UiProfile, UiStarter } from '@cratis/scene.model';
  * @param defaultSizeClass The size class assumed when the renderer cannot otherwise determine one.
  * @returns A {@link UiProfile} named after the starter, scoped to exactly its own `packages`.
  */
-export function buildStarterProfile(starter: UiStarter, targetPlatform: string, defaultSizeClass?: SizeClass): UiProfile {
+export function buildStarterProfile(starter: UiStarter, targetPlatform: string, defaultSizeClass?: TargetSizeClass): UiProfile {
     return { name: starter.name, targetPlatform, packages: starter.packages, defaultSizeClass };
 }

package/dist/cjs/buildStarterProfile.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildStarterProfile.js","sources":["../../buildStarterProfile.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 { SizeClass, UiProfile, UiStarter } from '@cratis/scene.model';\n\n/**\n * Builds the sandboxed {@link UiProfile} a {@link UiStarter}'s gallery boots through - part of\n * Cratis/Scene#6. Studio runs a starter's gallery screens as a working mini-app rather than a simulated\n * preview, so the gallery needs a real profile scoped to exactly the starter's own package list, not the\n * consuming project's eventual profile. Studio's design-time tooling and Stage's build-time resolution\n * use the C# twin of this function in `Cratis.Scene.Engine`; both sides are asserted against the same\n * shared fixture corpus so they cannot drift apart.\n *\n * @param starter The {@link UiStarter} to build the profile for.\n * @param targetPlatform The platform the gallery runs on (e.g. `web`).\n * @param defaultSizeClass The size class assumed when the renderer cannot otherwise determine one.\n * @returns A {@link UiProfile} named after the starter, scoped to exactly its own `packages`.\n */\nexport function buildStarterProfile(starter: UiStarter, targetPlatform: string, defaultSizeClass?: SizeClass): UiProfile {\n    return { name: starter.name, targetPlatform, packages: starter.packages, defaultSizeClass };\n}\n"],"names":["buildStarterProfile","starter","targetPlatform","defaultSizeClass","name","packages"],"mappings":";;AAAA;AACA;AAIA;;;;;;;;;;;;AAYC,IACM,SAASA,mBAAAA,CAAoBC,OAAkB,EAAEC,cAAsB,EAAEC,gBAA4B,EAAA;IACxG,OAAO;AAAEC,QAAAA,IAAAA,EAAMH,QAAQG,IAAI;AAAEF,QAAAA,cAAAA;AAAgBG,QAAAA,QAAAA,EAAUJ,QAAQI,QAAQ;AAAEF,QAAAA;AAAiB,KAAA;AAC9F;;"}
+{"version":3,"file":"buildStarterProfile.js","sources":["../../buildStarterProfile.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 { TargetSizeClass, UiProfile, UiStarter } from '@cratis/scene.model';\n\n/**\n * Builds the sandboxed {@link UiProfile} a {@link UiStarter}'s gallery boots through - part of\n * Cratis/Scene#6. Studio runs a starter's gallery screens as a working mini-app rather than a simulated\n * preview, so the gallery needs a real profile scoped to exactly the starter's own package list, not the\n * consuming project's eventual profile. Studio's design-time tooling and Stage's build-time resolution\n * use the C# twin of this function in `Cratis.Scene.Engine`; both sides are asserted against the same\n * shared fixture corpus so they cannot drift apart.\n *\n * @param starter The {@link UiStarter} to build the profile for.\n * @param targetPlatform The platform the gallery runs on (e.g. `web`).\n * @param defaultSizeClass The size class assumed when the renderer cannot otherwise determine one.\n * @returns A {@link UiProfile} named after the starter, scoped to exactly its own `packages`.\n */\nexport function buildStarterProfile(starter: UiStarter, targetPlatform: string, defaultSizeClass?: TargetSizeClass): UiProfile {\n    return { name: starter.name, targetPlatform, packages: starter.packages, defaultSizeClass };\n}\n"],"names":["buildStarterProfile","starter","targetPlatform","defaultSizeClass","name","packages"],"mappings":";;AAAA;AACA;AAIA;;;;;;;;;;;;AAYC,IACM,SAASA,mBAAAA,CAAoBC,OAAkB,EAAEC,cAAsB,EAAEC,gBAAkC,EAAA;IAC9G,OAAO;AAAEC,QAAAA,IAAAA,EAAMH,QAAQG,IAAI;AAAEF,QAAAA,cAAAA;AAAgBG,QAAAA,QAAAA,EAAUJ,QAAQI,QAAQ;AAAEF,QAAAA;AAAiB,KAAA;AAC9F;;"}

package/dist/cjs/index.js

@@ -18,6 +18,8 @@ var packageCatalog = require('./packageCatalog.js');
 var resolveScreenTemplates = require('./resolveScreenTemplates.js');
 var buildStarterProfile = require('./buildStarterProfile.js');
 var incompatibleStarterThemes = require('./incompatibleStarterThemes.js');
+var runActions = require('./runActions.js');
+var resolveBehaviors = require('./resolveBehaviors.js');
 
 
 
@@ -62,4 +64,11 @@ exports.isScreenTemplateResolutionValid = resolveScreenTemplates.isScreenTemplat
 exports.resolveScreenTemplates = resolveScreenTemplates.resolveScreenTemplates;
 exports.buildStarterProfile = buildStarterProfile.buildStarterProfile;
 exports.incompatibleStarterThemes = incompatibleStarterThemes.incompatibleStarterThemes;
+exports.InteractionStop = runActions.InteractionStop;
+exports.runActions = runActions.runActions;
+exports.runBindings = runActions.runBindings;
+exports.resolveApplicationTriggerBehaviors = resolveBehaviors.resolveApplicationTriggerBehaviors;
+exports.resolveBehaviors = resolveBehaviors.resolveBehaviors;
+exports.resolveEventBehaviors = resolveBehaviors.resolveEventBehaviors;
+exports.resolveIntervalBehaviors = resolveBehaviors.resolveIntervalBehaviors;
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/cjs/resolveBehaviors.js

@@ -0,0 +1,104 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Whether the trigger is the built-in kind asked for.
+ */ function isKind(trigger, kind) {
+    return trigger.kind === kind;
+}
+/**
+ * Collects the bindings that respond to a built-in interaction kind, in the order they run.
+ *
+ * Attachments are **additive**: a behavior on a template and a behavior on an element both run, rather than the
+ * more specific one replacing the less specific one. The order is outermost attachment first, declaration order
+ * within a level, and any behavior that declares an `order` sorts by it.
+ *
+ * The additive rule is what lets a module say 'confirm every destructive action' without every screen beneath it
+ * having to cooperate - but it also means the order has to be deterministic, or the same document behaves
+ * differently between runs. That is why this is a pure function over an ordered list rather than something
+ * assembled while rendering.
+ *
+ * @param attachments The attachment levels, outermost first.
+ * @param kind The built-in interaction kind that occurred.
+ * @returns The bindings to run, in order.
+ */ function resolveBehaviors(attachments, kind) {
+    const resolved = [];
+    attachments.forEach((attachment, level)=>{
+        let declaration = 0;
+        for (const behavior of attachment.behaviors ?? []){
+            for (const binding of behavior.bindings ?? []){
+                if (!isKind(binding.trigger, kind)) continue;
+                resolved.push({
+                    entry: {
+                        level: attachment.level,
+                        behaviorName: behavior.name,
+                        binding
+                    },
+                    level: attachment.depth ?? level,
+                    declaration: declaration++,
+                    order: behavior.order
+                });
+            }
+        }
+    });
+    // An explicit order wins over position; everything else keeps the order it was written in. Sorting is
+    // stable on (order, level, declaration) so the result never depends on the sort implementation.
+    return resolved.sort((left, right)=>{
+        if (left.order !== right.order) {
+            if (left.order === undefined) return 1;
+            if (right.order === undefined) return -1;
+            return left.order - right.order;
+        }
+        return left.level !== right.level ? left.level - right.level : left.declaration - right.declaration;
+    }).map((candidate)=>candidate.entry);
+}
+/**
+ * Collects the bindings that respond to a named application trigger firing.
+ *
+ * @param attachments The attachment levels, outermost first.
+ * @param triggerName The application trigger that fired.
+ * @returns The bindings to run, in order.
+ */ function resolveApplicationTriggerBehaviors(attachments, triggerName) {
+    return collect(attachments, (trigger)=>trigger.triggerName === triggerName);
+}
+/**
+ * Collects the bindings that respond to a modeled domain event being observed.
+ *
+ * @param attachments The attachment levels, outermost first.
+ * @param eventName The event that was observed.
+ * @returns The bindings to run, in order.
+ */ function resolveEventBehaviors(attachments, eventName) {
+    return collect(attachments, (trigger)=>trigger.eventName === eventName);
+}
+/**
+ * Collects every interval binding, so a host can schedule them.
+ *
+ * @param attachments The attachment levels, outermost first.
+ * @returns The interval bindings, in order.
+ */ function resolveIntervalBehaviors(attachments) {
+    return collect(attachments, (trigger)=>typeof trigger.seconds === 'number');
+}
+function collect(attachments, matches) {
+    const resolved = [];
+    for (const attachment of attachments){
+        for (const behavior of attachment.behaviors ?? []){
+            for (const binding of behavior.bindings ?? []){
+                if (matches(binding.trigger)) {
+                    resolved.push({
+                        level: attachment.level,
+                        behaviorName: behavior.name,
+                        binding
+                    });
+                }
+            }
+        }
+    }
+    return resolved;
+}
+
+exports.resolveApplicationTriggerBehaviors = resolveApplicationTriggerBehaviors;
+exports.resolveBehaviors = resolveBehaviors;
+exports.resolveEventBehaviors = resolveEventBehaviors;
+exports.resolveIntervalBehaviors = resolveIntervalBehaviors;
+//# sourceMappingURL=resolveBehaviors.js.map

package/dist/cjs/resolveBehaviors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveBehaviors.js","sources":["../../resolveBehaviors.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 { Behavior, InteractionBinding, InteractionTrigger, InteractionTriggerKind } from '@cratis/scene.model';\n\n/**\n * One level of the containment tree a behavior can be attached to, outermost first.\n *\n * Named rather than positional so a finding can say *where* a behavior came from - 'the module's behavior ran\n * before the element's' is only a useful thing to report if the level has a name.\n */\nexport interface BehaviorAttachment {\n    level: string;\n    behaviors: Behavior[];\n\n    /**\n     * How deeply nested this attachment is, with 0 the outermost.\n     *\n     * Optional, defaulting to the position in the list. Stating it explicitly is what lets a caller assemble the\n     * list in whatever order is convenient - walking a tree upwards from the element, for instance - without the\n     * resolved order silently depending on that choice.\n     */\n    depth?: number;\n}\n\n/**\n * One binding to run, with the attachment it came from.\n */\nexport interface ResolvedBinding {\n    level: string;\n    behaviorName?: string;\n    binding: InteractionBinding;\n}\n\n/**\n * Whether the trigger is the built-in kind asked for.\n */\nfunction isKind(trigger: InteractionTrigger, kind: InteractionTriggerKind): boolean {\n    return (trigger as { kind?: InteractionTriggerKind }).kind === kind;\n}\n\n/**\n * Collects the bindings that respond to a built-in interaction kind, in the order they run.\n *\n * Attachments are **additive**: a behavior on a template and a behavior on an element both run, rather than the\n * more specific one replacing the less specific one. The order is outermost attachment first, declaration order\n * within a level, and any behavior that declares an `order` sorts by it.\n *\n * The additive rule is what lets a module say 'confirm every destructive action' without every screen beneath it\n * having to cooperate - but it also means the order has to be deterministic, or the same document behaves\n * differently between runs. That is why this is a pure function over an ordered list rather than something\n * assembled while rendering.\n *\n * @param attachments The attachment levels, outermost first.\n * @param kind The built-in interaction kind that occurred.\n * @returns The bindings to run, in order.\n */\nexport function resolveBehaviors(attachments: BehaviorAttachment[], kind: InteractionTriggerKind): ResolvedBinding[] {\n    const resolved: { entry: ResolvedBinding; level: number; declaration: number; order?: number }[] = [];\n\n    attachments.forEach((attachment, level) => {\n        let declaration = 0;\n        for (const behavior of (attachment.behaviors ?? [])) {\n            for (const binding of (behavior.bindings ?? [])) {\n                if (!isKind(binding.trigger, kind)) continue;\n\n                resolved.push({\n                    entry: { level: attachment.level, behaviorName: behavior.name, binding },\n                    level: attachment.depth ?? level,\n                    declaration: declaration++,\n                    order: behavior.order,\n                });\n            }\n        }\n    });\n\n    // An explicit order wins over position; everything else keeps the order it was written in. Sorting is\n    // stable on (order, level, declaration) so the result never depends on the sort implementation.\n    return resolved\n        .sort((left, right) => {\n            if (left.order !== right.order) {\n                if (left.order === undefined) return 1;\n                if (right.order === undefined) return -1;\n                return left.order - right.order;\n            }\n\n            return left.level !== right.level ? left.level - right.level : left.declaration - right.declaration;\n        })\n        .map(candidate => candidate.entry);\n}\n\n/**\n * Collects the bindings that respond to a named application trigger firing.\n *\n * @param attachments The attachment levels, outermost first.\n * @param triggerName The application trigger that fired.\n * @returns The bindings to run, in order.\n */\nexport function resolveApplicationTriggerBehaviors(attachments: BehaviorAttachment[], triggerName: string): ResolvedBinding[] {\n    return collect(attachments, trigger => (trigger as { triggerName?: string }).triggerName === triggerName);\n}\n\n/**\n * Collects the bindings that respond to a modeled domain event being observed.\n *\n * @param attachments The attachment levels, outermost first.\n * @param eventName The event that was observed.\n * @returns The bindings to run, in order.\n */\nexport function resolveEventBehaviors(attachments: BehaviorAttachment[], eventName: string): ResolvedBinding[] {\n    return collect(attachments, trigger => (trigger as { eventName?: string }).eventName === eventName);\n}\n\n/**\n * Collects every interval binding, so a host can schedule them.\n *\n * @param attachments The attachment levels, outermost first.\n * @returns The interval bindings, in order.\n */\nexport function resolveIntervalBehaviors(attachments: BehaviorAttachment[]): ResolvedBinding[] {\n    return collect(attachments, trigger => typeof (trigger as { seconds?: number }).seconds === 'number');\n}\n\nfunction collect(attachments: BehaviorAttachment[], matches: (trigger: InteractionTrigger) => boolean): ResolvedBinding[] {\n    const resolved: ResolvedBinding[] = [];\n    for (const attachment of attachments) {\n        for (const behavior of (attachment.behaviors ?? [])) {\n            for (const binding of (behavior.bindings ?? [])) {\n                if (matches(binding.trigger)) {\n                    resolved.push({ level: attachment.level, behaviorName: behavior.name, binding });\n                }\n            }\n        }\n    }\n\n    return resolved;\n}\n"],"names":["isKind","trigger","kind","resolveBehaviors","attachments","resolved","forEach","attachment","level","declaration","behavior","behaviors","binding","bindings","push","entry","behaviorName","name","depth","order","sort","left","right","undefined","map","candidate","resolveApplicationTriggerBehaviors","triggerName","collect","resolveEventBehaviors","eventName","resolveIntervalBehaviors","seconds","matches"],"mappings":"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"}

package/dist/cjs/runActions.js

@@ -0,0 +1,219 @@
+'use strict';
+
+var scene_model = require('@cratis/scene.model');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Why an interaction stopped before running everything it was given.
+ */ var InteractionStop = /*#__PURE__*/ function(InteractionStop) {
+    /** Everything ran. */ InteractionStop["Completed"] = "Completed";
+    /** A `confirm` was declined, so the actions it gates did not run. */ InteractionStop["Declined"] = "Declined";
+    /** A navigation happened, so anything after it belonged to a screen that is gone. */ InteractionStop["Navigated"] = "Navigated";
+    /** An action could not be realized and was reported. */ InteractionStop["Reported"] = "Reported";
+    return InteractionStop;
+}({});
+function describe(action) {
+    switch(action.kind){
+        case scene_model.InteractionActionKind.ExecuteCommand:
+            return `execute ${action.command}`;
+        case scene_model.InteractionActionKind.Navigate:
+            return `navigate to ${action.screen}`;
+        case scene_model.InteractionActionKind.NavigateBack:
+            return 'navigate back';
+        case scene_model.InteractionActionKind.OpenDialog:
+            return `open dialog ${action.dialogTemplate}`;
+        case scene_model.InteractionActionKind.CloseDialog:
+            return 'close dialog';
+        case scene_model.InteractionActionKind.RefreshQuery:
+            return `refresh ${action.query}`;
+        case scene_model.InteractionActionKind.SetState:
+            return `set ${action.target}`;
+        case scene_model.InteractionActionKind.Notify:
+            return 'notify';
+        case scene_model.InteractionActionKind.Confirm:
+            return 'confirm';
+        case scene_model.InteractionActionKind.RaiseTrigger:
+            return `raise ${action.trigger}`;
+        default:
+            return String(action.kind);
+    }
+}
+function argumentsOf(action, context) {
+    const args = {};
+    for (const argument of action.arguments ?? []){
+        args[argument.name] = context.resolve(argument.value);
+    }
+    return args;
+}
+function messageOf(message, context, findings) {
+    if (message.text !== undefined) return message.text;
+    if (message.stringsKey !== undefined) return context.localize ? context.localize(message.stringsKey) : message.stringsKey;
+    if (message.binding !== undefined) {
+        const resolved = context.resolve(message.binding);
+        if (resolved === undefined || resolved === null) {
+            findings.push({
+                kind: 'unresolvedMessage',
+                detail: `The message binding '${message.binding.path}' resolved to nothing`
+            });
+            return '';
+        }
+        return String(resolved);
+    }
+    findings.push({
+        kind: 'unresolvedMessage',
+        detail: 'The action carries no message'
+    });
+    return '';
+}
+/**
+ * Runs a sequence of actions, in order, handling continuations.
+ *
+ * The rules, all of which live here rather than in a renderer so they can be asserted without a DOM:
+ *
+ * - Actions run in the order they were declared.
+ * - A declined `confirm` stops the sequence. Gating what follows is the whole point of it.
+ * - A navigation stops the sequence, because the screen the remaining actions were written for is gone. The
+ *   compiler reports that as unreachable, so reaching it at runtime means the document changed underneath.
+ * - An action that can fail branches into `onSuccess` or `onFailure`; a dialog also runs `onResult`.
+ * - An action kind the engine does not know is **reported and the sequence abandoned**, never silently skipped.
+ *   Continuing would half-apply a sequence whose gate may well have been the action this renderer could not
+ *   understand. This is what lets a newer document be opened by an older renderer without pretending it worked.
+ *
+ * @param actions The actions to run.
+ * @param dispatcher The seam that performs the effects.
+ * @param context How to resolve bindings and localization.
+ * @returns What happened.
+ */ async function runActions(actions, dispatcher, context) {
+    const run = {
+        stop: "Completed",
+        findings: [],
+        ran: []
+    };
+    await runSequence(actions, dispatcher, context, run);
+    return run;
+}
+async function runSequence(actions, dispatcher, context, run) {
+    for (const action of actions){
+        if (await runOne(action, dispatcher, context, run)) return;
+    }
+}
+async function runOne(action, dispatcher, context, run) {
+    const args = argumentsOf(action, context);
+    switch(action.kind){
+        case scene_model.InteractionActionKind.ExecuteCommand:
+            {
+                run.ran.push(describe(action));
+                const outcome = await dispatcher.executeCommand(action.command, args);
+                await runSequence(outcome.isSuccess ? action.onSuccess ?? [] : action.onFailure ?? [], dispatcher, context, run);
+                return false;
+            }
+        case scene_model.InteractionActionKind.Navigate:
+            run.ran.push(describe(action));
+            await dispatcher.navigate(action.screen, args);
+            run.stop = "Navigated";
+            return true;
+        case scene_model.InteractionActionKind.NavigateBack:
+            run.ran.push(describe(action));
+            await dispatcher.navigateBack();
+            run.stop = "Navigated";
+            return true;
+        case scene_model.InteractionActionKind.OpenDialog:
+            {
+                run.ran.push(describe(action));
+                const outcome = await dispatcher.openDialog(action.dialogTemplate, args);
+                await runSequence(outcome.isConfirmed ? action.onSuccess ?? [] : action.onFailure ?? [], dispatcher, context, run);
+                await runSequence(action.onResult ?? [], dispatcher, context, run);
+                return false;
+            }
+        case scene_model.InteractionActionKind.CloseDialog:
+            run.ran.push(describe(action));
+            await dispatcher.closeDialog();
+            return false;
+        case scene_model.InteractionActionKind.RefreshQuery:
+            {
+                run.ran.push(describe(action));
+                await dispatcher.refreshQuery(action.query);
+                await runSequence(action.onSuccess ?? [], dispatcher, context, run);
+                return false;
+            }
+        case scene_model.InteractionActionKind.SetState:
+            run.ran.push(describe(action));
+            dispatcher.setState(action.target, context.resolve(action.value));
+            return false;
+        case scene_model.InteractionActionKind.Notify:
+            run.ran.push(describe(action));
+            dispatcher.notify(action.level, messageOf(action.message, context, run.findings));
+            return false;
+        case scene_model.InteractionActionKind.Confirm:
+            {
+                run.ran.push(describe(action));
+                const confirmed = await dispatcher.confirm(messageOf(action.message, context, run.findings));
+                if (!confirmed) {
+                    await runSequence(action.onFailure ?? [], dispatcher, context, run);
+                    run.stop = "Declined";
+                    return true;
+                }
+                await runSequence(action.onSuccess ?? [], dispatcher, context, run);
+                return false;
+            }
+        case scene_model.InteractionActionKind.RaiseTrigger:
+            {
+                run.ran.push(describe(action));
+                await dispatcher.raise(action.trigger, args);
+                await runSequence(action.onSuccess ?? [], dispatcher, context, run);
+                return false;
+            }
+        default:
+            run.findings.push({
+                kind: 'unknownAction',
+                detail: `The renderer does not know the action kind '${String(action.kind)}'`
+            });
+            run.stop = "Reported";
+            return true;
+    }
+}
+/**
+ * Runs the bindings a trigger resolved to, in order, honouring each one's guard.
+ *
+ * The `where` guard belongs here rather than in a renderer for the same reason the sequencing does: whether a
+ * binding applies is a property of the document, not of the event that arrived. A guard that resolves to
+ * nothing is treated as false and reported - an interaction that silently does nothing is indistinguishable
+ * from one that is broken, and the whole point of a finding is to tell those apart.
+ *
+ * @param bindings The bindings to run, already resolved and ordered.
+ * @param dispatcher The seam that performs the effects.
+ * @param context How to resolve bindings and localization.
+ * @returns What happened across all of them.
+ */ async function runBindings(bindings, dispatcher, context) {
+    const run = {
+        stop: "Completed",
+        findings: [],
+        ran: []
+    };
+    for (const candidate of bindings){
+        if (!applies(candidate.binding, context, run)) continue;
+        await runSequence(candidate.binding.actions ?? [], dispatcher, context, run);
+        // A navigation or a declined confirm ends the interaction, not merely the binding that caused it.
+        // The screen the later bindings were attached to is gone, or the gate they sat behind was refused.
+        if (run.stop !== "Completed") break;
+    }
+    return run;
+}
+function applies(binding, context, run) {
+    if (!binding.condition) return true;
+    const value = context.resolve(binding.condition);
+    if (value === undefined || value === null) {
+        run.findings.push({
+            kind: 'unresolvedCondition',
+            detail: `The guard '${binding.condition.path}' resolved to nothing, so the binding did not run`
+        });
+        return false;
+    }
+    return Boolean(value);
+}
+
+exports.InteractionStop = InteractionStop;
+exports.runActions = runActions;
+exports.runBindings = runBindings;
+//# sourceMappingURL=runActions.js.map

package/dist/cjs/runActions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runActions.js","sources":["../../runActions.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 { InteractionBinding } from '@cratis/scene.model';\nimport { ResolvedBinding } from './resolveBehaviors';\nimport {\n    ConfirmAction,\n    ExecuteCommandAction,\n    InteractionAction,\n    InteractionActionKind,\n    InteractionArgument,\n    InteractionMessage,\n    NavigateAction,\n    NotifyAction,\n    OpenDialogAction,\n    RaiseTriggerAction,\n    RefreshQueryAction,\n    SetStateAction,\n} from '@cratis/scene.model';\n\nimport { ActionDispatcher } from './ActionDispatcher';\nimport { BindingResolver } from './BindingResolver';\n\n/**\n * Why an interaction stopped before running everything it was given.\n */\nexport enum InteractionStop {\n    /** Everything ran. */\n    Completed = 'Completed',\n\n    /** A `confirm` was declined, so the actions it gates did not run. */\n    Declined = 'Declined',\n\n    /** A navigation happened, so anything after it belonged to a screen that is gone. */\n    Navigated = 'Navigated',\n\n    /** An action could not be realized and was reported. */\n    Reported = 'Reported',\n}\n\n/**\n * Something an interaction could not do.\n *\n * Findings are collected rather than thrown: one unresolvable action must not take down the rest of the\n * application, and 'this application produced no findings' has to be checkable rather than a matter of opinion.\n */\nexport interface InteractionFinding {\n    kind: 'unknownAction' | 'unresolvedMessage' | 'unresolvedCondition';\n    detail: string;\n}\n\n/**\n * What an interaction did.\n */\nexport interface InteractionRun {\n    stop: InteractionStop;\n    findings: InteractionFinding[];\n    /** The actions that actually ran, in order - the thing a spec asserts on. */\n    ran: string[];\n}\n\n/**\n * How to resolve the values an action needs.\n */\nexport interface InteractionContext {\n    resolve: BindingResolver;\n    /** Looks up a localization key. Returns the key itself when the host has no catalogue for it. */\n    localize?: (key: string) => string;\n}\n\nfunction describe(action: InteractionAction): string {\n    switch (action.kind) {\n        case InteractionActionKind.ExecuteCommand: return `execute ${(action as ExecuteCommandAction).command}`;\n        case InteractionActionKind.Navigate: return `navigate to ${(action as NavigateAction).screen}`;\n        case InteractionActionKind.NavigateBack: return 'navigate back';\n        case InteractionActionKind.OpenDialog: return `open dialog ${(action as OpenDialogAction).dialogTemplate}`;\n        case InteractionActionKind.CloseDialog: return 'close dialog';\n        case InteractionActionKind.RefreshQuery: return `refresh ${(action as RefreshQueryAction).query}`;\n        case InteractionActionKind.SetState: return `set ${(action as SetStateAction).target}`;\n        case InteractionActionKind.Notify: return 'notify';\n        case InteractionActionKind.Confirm: return 'confirm';\n        case InteractionActionKind.RaiseTrigger: return `raise ${(action as RaiseTriggerAction).trigger}`;\n        default: return String(action.kind);\n    }\n}\n\nfunction argumentsOf(action: InteractionAction, context: InteractionContext): Record<string, unknown> {\n    const args: Record<string, unknown> = {};\n    for (const argument of (action.arguments ?? []) as InteractionArgument[]) {\n        args[argument.name] = context.resolve(argument.value);\n    }\n\n    return args;\n}\n\nfunction messageOf(message: InteractionMessage, context: InteractionContext, findings: InteractionFinding[]): string {\n    if (message.text !== undefined) return message.text;\n    if (message.stringsKey !== undefined) return context.localize ? context.localize(message.stringsKey) : message.stringsKey;\n    if (message.binding !== undefined) {\n        const resolved = context.resolve(message.binding);\n        if (resolved === undefined || resolved === null) {\n            findings.push({ kind: 'unresolvedMessage', detail: `The message binding '${message.binding.path}' resolved to nothing` });\n            return '';\n        }\n\n        return String(resolved);\n    }\n\n    findings.push({ kind: 'unresolvedMessage', detail: 'The action carries no message' });\n    return '';\n}\n\n/**\n * Runs a sequence of actions, in order, handling continuations.\n *\n * The rules, all of which live here rather than in a renderer so they can be asserted without a DOM:\n *\n * - Actions run in the order they were declared.\n * - A declined `confirm` stops the sequence. Gating what follows is the whole point of it.\n * - A navigation stops the sequence, because the screen the remaining actions were written for is gone. The\n *   compiler reports that as unreachable, so reaching it at runtime means the document changed underneath.\n * - An action that can fail branches into `onSuccess` or `onFailure`; a dialog also runs `onResult`.\n * - An action kind the engine does not know is **reported and the sequence abandoned**, never silently skipped.\n *   Continuing would half-apply a sequence whose gate may well have been the action this renderer could not\n *   understand. This is what lets a newer document be opened by an older renderer without pretending it worked.\n *\n * @param actions The actions to run.\n * @param dispatcher The seam that performs the effects.\n * @param context How to resolve bindings and localization.\n * @returns What happened.\n */\nexport async function runActions(\n    actions: InteractionAction[],\n    dispatcher: ActionDispatcher,\n    context: InteractionContext\n): Promise<InteractionRun> {\n    const run: InteractionRun = { stop: InteractionStop.Completed, findings: [], ran: [] };\n    await runSequence(actions, dispatcher, context, run);\n    return run;\n}\n\nasync function runSequence(\n    actions: InteractionAction[],\n    dispatcher: ActionDispatcher,\n    context: InteractionContext,\n    run: InteractionRun\n): Promise<void> {\n    for (const action of actions) {\n        if (await runOne(action, dispatcher, context, run)) return;\n    }\n}\n\nasync function runOne(\n    action: InteractionAction,\n    dispatcher: ActionDispatcher,\n    context: InteractionContext,\n    run: InteractionRun\n): Promise<boolean> {\n    const args = argumentsOf(action, context);\n\n    switch (action.kind) {\n        case InteractionActionKind.ExecuteCommand: {\n            run.ran.push(describe(action));\n            const outcome = await dispatcher.executeCommand((action as ExecuteCommandAction).command, args);\n            await runSequence(outcome.isSuccess ? (action.onSuccess ?? []) : (action.onFailure ?? []), dispatcher, context, run);\n            return false;\n        }\n\n        case InteractionActionKind.Navigate:\n            run.ran.push(describe(action));\n            await dispatcher.navigate((action as NavigateAction).screen, args);\n            run.stop = InteractionStop.Navigated;\n            return true;\n\n        case InteractionActionKind.NavigateBack:\n            run.ran.push(describe(action));\n            await dispatcher.navigateBack();\n            run.stop = InteractionStop.Navigated;\n            return true;\n\n        case InteractionActionKind.OpenDialog: {\n            run.ran.push(describe(action));\n            const outcome = await dispatcher.openDialog((action as OpenDialogAction).dialogTemplate, args);\n            await runSequence(outcome.isConfirmed ? (action.onSuccess ?? []) : (action.onFailure ?? []), dispatcher, context, run);\n            await runSequence((action.onResult ?? []), dispatcher, context, run);\n            return false;\n        }\n\n        case InteractionActionKind.CloseDialog:\n            run.ran.push(describe(action));\n            await dispatcher.closeDialog();\n            return false;\n\n        case InteractionActionKind.RefreshQuery: {\n            run.ran.push(describe(action));\n            await dispatcher.refreshQuery((action as RefreshQueryAction).query);\n            await runSequence((action.onSuccess ?? []), dispatcher, context, run);\n            return false;\n        }\n\n        case InteractionActionKind.SetState:\n            run.ran.push(describe(action));\n            dispatcher.setState((action as SetStateAction).target, context.resolve((action as SetStateAction).value));\n            return false;\n\n        case InteractionActionKind.Notify:\n            run.ran.push(describe(action));\n            dispatcher.notify((action as NotifyAction).level, messageOf((action as NotifyAction).message, context, run.findings));\n            return false;\n\n        case InteractionActionKind.Confirm: {\n            run.ran.push(describe(action));\n            const confirmed = await dispatcher.confirm(messageOf((action as ConfirmAction).message, context, run.findings));\n            if (!confirmed) {\n                await runSequence((action.onFailure ?? []), dispatcher, context, run);\n                run.stop = InteractionStop.Declined;\n                return true;\n            }\n\n            await runSequence((action.onSuccess ?? []), dispatcher, context, run);\n            return false;\n        }\n\n        case InteractionActionKind.RaiseTrigger: {\n            run.ran.push(describe(action));\n            await dispatcher.raise((action as RaiseTriggerAction).trigger, args);\n            await runSequence((action.onSuccess ?? []), dispatcher, context, run);\n            return false;\n        }\n\n        default:\n            run.findings.push({ kind: 'unknownAction', detail: `The renderer does not know the action kind '${String(action.kind)}'` });\n            run.stop = InteractionStop.Reported;\n            return true;\n    }\n}\n\n/**\n * Runs the bindings a trigger resolved to, in order, honouring each one's guard.\n *\n * The `where` guard belongs here rather than in a renderer for the same reason the sequencing does: whether a\n * binding applies is a property of the document, not of the event that arrived. A guard that resolves to\n * nothing is treated as false and reported - an interaction that silently does nothing is indistinguishable\n * from one that is broken, and the whole point of a finding is to tell those apart.\n *\n * @param bindings The bindings to run, already resolved and ordered.\n * @param dispatcher The seam that performs the effects.\n * @param context How to resolve bindings and localization.\n * @returns What happened across all of them.\n */\nexport async function runBindings(\n    bindings: ResolvedBinding[],\n    dispatcher: ActionDispatcher,\n    context: InteractionContext\n): Promise<InteractionRun> {\n    const run: InteractionRun = { stop: InteractionStop.Completed, findings: [], ran: [] };\n\n    for (const candidate of bindings) {\n        if (!applies(candidate.binding, context, run)) continue;\n\n        await runSequence(candidate.binding.actions ?? [], dispatcher, context, run);\n\n        // A navigation or a declined confirm ends the interaction, not merely the binding that caused it.\n        // The screen the later bindings were attached to is gone, or the gate they sat behind was refused.\n        if (run.stop !== InteractionStop.Completed) break;\n    }\n\n    return run;\n}\n\nfunction applies(binding: InteractionBinding, context: InteractionContext, run: InteractionRun): boolean {\n    if (!binding.condition) return true;\n\n    const value = context.resolve(binding.condition);\n    if (value === undefined || value === null) {\n        run.findings.push({\n            kind: 'unresolvedCondition',\n            detail: `The guard '${binding.condition.path}' resolved to nothing, so the binding did not run`,\n        });\n        return false;\n    }\n\n    return Boolean(value);\n}\n"],"names":["InteractionStop","describe","action","kind","InteractionActionKind","ExecuteCommand","command","Navigate","screen","NavigateBack","OpenDialog","dialogTemplate","CloseDialog","RefreshQuery","query","SetState","target","Notify","Confirm","RaiseTrigger","trigger","String","argumentsOf","context","args","argument","arguments","name","resolve","value","messageOf","message","findings","text","undefined","stringsKey","localize","binding","resolved","push","detail","path","runActions","actions","dispatcher","run","stop","ran","runSequence","runOne","outcome","executeCommand","isSuccess","onSuccess","onFailure","navigate","navigateBack","openDialog","isConfirmed","onResult","closeDialog","refreshQuery","setState","notify","level","confirmed","confirm","raise","runBindings","bindings","candidate","applies","condition","Boolean"],"mappings":"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"}

package/dist/esm/ActionDispatcher.d.ts

@@ -0,0 +1,27 @@
+import { NotificationLevel } from '@cratis/scene.model';
+export interface CommandOutcome {
+    isSuccess: boolean;
+    validationErrors?: {
+        member: string;
+        message: string;
+    }[];
+    exceptionMessages?: string[];
+    response?: unknown;
+}
+export interface DialogOutcome {
+    isConfirmed: boolean;
+    result?: unknown;
+}
+export interface ActionDispatcher {
+    executeCommand(command: string, args: Record<string, unknown>): Promise<CommandOutcome>;
+    navigate(screen: string, args: Record<string, unknown>): Promise<void> | void;
+    navigateBack(): Promise<void> | void;
+    openDialog(dialogTemplate: string, args: Record<string, unknown>): Promise<DialogOutcome>;
+    closeDialog(result?: unknown): Promise<void> | void;
+    refreshQuery(query: string): Promise<void>;
+    setState(target: string, value: unknown): void;
+    notify(level: NotificationLevel, message: string): void;
+    confirm(message: string): Promise<boolean>;
+    raise(trigger: string, args: Record<string, unknown>): Promise<void>;
+}
+//# sourceMappingURL=ActionDispatcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ActionDispatcher.d.ts","sourceRoot":"","sources":["../../ActionDispatcher.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAQxD,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzD,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAKD,MAAM,WAAW,aAAa;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAYD,MAAM,WAAW,gBAAgB;IAI7B,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAKxF,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAK9E,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAKrC,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAK1F,WAAW,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAKpD,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAK3C,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAK/C,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAKxD,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAK3C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxE"}

package/dist/esm/ActionDispatcher.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ActionDispatcher.js.map

package/dist/esm/ActionDispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionDispatcher.js","sourceRoot":"","sources":["../../ActionDispatcher.ts"],"names":[],"mappings":""}

package/dist/esm/buildStarterProfile.d.ts

@@ -1,3 +1,3 @@
-import { SizeClass, UiProfile, UiStarter } from '@cratis/scene.model';
-export declare function buildStarterProfile(starter: UiStarter, targetPlatform: string, defaultSizeClass?: SizeClass): UiProfile;
+import { TargetSizeClass, UiProfile, UiStarter } from '@cratis/scene.model';
+export declare function buildStarterProfile(starter: UiStarter, targetPlatform: string, defaultSizeClass?: TargetSizeClass): UiProfile;
 //# sourceMappingURL=buildStarterProfile.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"buildStarterProfile.d.ts","sourceRoot":"","sources":["../../buildStarterProfile.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAetE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,SAAS,GAAG,SAAS,CAEvH"}
+{"version":3,"file":"buildStarterProfile.d.ts","sourceRoot":"","sources":["../../buildStarterProfile.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAe5E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,eAAe,GAAG,SAAS,CAE7H"}

package/dist/esm/buildStarterProfile.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildStarterProfile.js","sources":["../../buildStarterProfile.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 { SizeClass, UiProfile, UiStarter } from '@cratis/scene.model';\n\n/**\n * Builds the sandboxed {@link UiProfile} a {@link UiStarter}'s gallery boots through - part of\n * Cratis/Scene#6. Studio runs a starter's gallery screens as a working mini-app rather than a simulated\n * preview, so the gallery needs a real profile scoped to exactly the starter's own package list, not the\n * consuming project's eventual profile. Studio's design-time tooling and Stage's build-time resolution\n * use the C# twin of this function in `Cratis.Scene.Engine`; both sides are asserted against the same\n * shared fixture corpus so they cannot drift apart.\n *\n * @param starter The {@link UiStarter} to build the profile for.\n * @param targetPlatform The platform the gallery runs on (e.g. `web`).\n * @param defaultSizeClass The size class assumed when the renderer cannot otherwise determine one.\n * @returns A {@link UiProfile} named after the starter, scoped to exactly its own `packages`.\n */\nexport function buildStarterProfile(starter: UiStarter, targetPlatform: string, defaultSizeClass?: SizeClass): UiProfile {\n    return { name: starter.name, targetPlatform, packages: starter.packages, defaultSizeClass };\n}\n"],"names":["buildStarterProfile","starter","targetPlatform","defaultSizeClass","name","packages"],"mappings":"AAAA;AACA;AAIA;;;;;;;;;;;;AAYC,IACM,SAASA,mBAAAA,CAAoBC,OAAkB,EAAEC,cAAsB,EAAEC,gBAA4B,EAAA;IACxG,OAAO;AAAEC,QAAAA,IAAAA,EAAMH,QAAQG,IAAI;AAAEF,QAAAA,cAAAA;AAAgBG,QAAAA,QAAAA,EAAUJ,QAAQI,QAAQ;AAAEF,QAAAA;AAAiB,KAAA;AAC9F;;"}
+{"version":3,"file":"buildStarterProfile.js","sources":["../../buildStarterProfile.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 { TargetSizeClass, UiProfile, UiStarter } from '@cratis/scene.model';\n\n/**\n * Builds the sandboxed {@link UiProfile} a {@link UiStarter}'s gallery boots through - part of\n * Cratis/Scene#6. Studio runs a starter's gallery screens as a working mini-app rather than a simulated\n * preview, so the gallery needs a real profile scoped to exactly the starter's own package list, not the\n * consuming project's eventual profile. Studio's design-time tooling and Stage's build-time resolution\n * use the C# twin of this function in `Cratis.Scene.Engine`; both sides are asserted against the same\n * shared fixture corpus so they cannot drift apart.\n *\n * @param starter The {@link UiStarter} to build the profile for.\n * @param targetPlatform The platform the gallery runs on (e.g. `web`).\n * @param defaultSizeClass The size class assumed when the renderer cannot otherwise determine one.\n * @returns A {@link UiProfile} named after the starter, scoped to exactly its own `packages`.\n */\nexport function buildStarterProfile(starter: UiStarter, targetPlatform: string, defaultSizeClass?: TargetSizeClass): UiProfile {\n    return { name: starter.name, targetPlatform, packages: starter.packages, defaultSizeClass };\n}\n"],"names":["buildStarterProfile","starter","targetPlatform","defaultSizeClass","name","packages"],"mappings":"AAAA;AACA;AAIA;;;;;;;;;;;;AAYC,IACM,SAASA,mBAAAA,CAAoBC,OAAkB,EAAEC,cAAsB,EAAEC,gBAAkC,EAAA;IAC9G,OAAO;AAAEC,QAAAA,IAAAA,EAAMH,QAAQG,IAAI;AAAEF,QAAAA,cAAAA;AAAgBG,QAAAA,QAAAA,EAAUJ,QAAQI,QAAQ;AAAEF,QAAAA;AAAiB,KAAA;AAC9F;;"}

package/dist/esm/for_resolveBehaviors/when_resolving_additive_attachments.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=when_resolving_additive_attachments.d.ts.map

package/dist/esm/for_resolveBehaviors/when_resolving_additive_attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"when_resolving_additive_attachments.d.ts","sourceRoot":"","sources":["../../../for_resolveBehaviors/when_resolving_additive_attachments.ts"],"names":[],"mappings":""}