@salsita-ai/sdk 0.50.0-develop.f101f4c3c9 → 0.50.0-develop.f354d3576d

package/dist/application-spec/generate-application/code/templates/tsconfig.js

@@ -31,6 +31,7 @@ export const generateApplicationSpecTsconfig=()=>`{
 
     "paths": {}
   },
-  "include": ["../src", ".", "../prettier.config.js", "../eslint.config.js", "./globals.d.ts"]
+  "include": ["../src", ".", "../prettier.config.js", "../eslint.config.js", "./globals.d.ts"],
+  "exclude": ["workspace", "node_modules", "bower_components", "jspm_packages"]
 }
 `;

package/dist/application-spec/generate-application/index.d.ts

@@ -1,7 +1,2 @@
-export * from './runtime/sections/index.js';
-export * from './runtime/application-runtime.js';
-export * from './runtime/factory-data/index.js';
-export * from './runtime/migrations/index.js';
-export { isConfiguratorModelSchemaCompatible } from './runtime/configurator-runtime/configurator-model-runtime.js';
+export { ActionsRuntime, type ApplicationModules, ApplicationRuntime, type ApplicationRuntimeResult, type ApplicationSpecSliceModules, AssistantRuntime, type ComponentOptic, ComponentOptics, DataRuntime, type ExpressionImplementations, ExpressionRuntime, FactoryDataRuntime, type InvariantImplementations, type MigrationModules, MigrationRuntime, type MissingExpression, PresetRuntime, type RecipeDefaults, type StaticViolations, ThemeRuntime, TransformersRuntime, applicationSpecSlice, createApplication, evaluateReflectionConstants, evaluateStaticMemoEvalPlan, findReflectionConstants, generateMemoEvalPlanRuntime, generateRuntimeInstance, isConfiguratorModelSchemaCompatible, } from '#package/domain';
 export * from './code/index.js';
-export { generateRuntimeInstance } from './runtime/generate-runtime-instance.js';

package/dist/application-spec/generate-application/index.js

@@ -1 +1 @@
-export*from"./runtime/sections/index.js";export*from"./runtime/application-runtime.js";export*from"./runtime/factory-data/index.js";export*from"./runtime/migrations/index.js";export{isConfiguratorModelSchemaCompatible}from"./runtime/configurator-runtime/configurator-model-runtime.js";export*from"./code/index.js";export{generateRuntimeInstance}from"./runtime/generate-runtime-instance.js";
+export{ActionsRuntime,ApplicationRuntime,AssistantRuntime,ComponentOptics,DataRuntime,ExpressionRuntime,FactoryDataRuntime,MigrationRuntime,PresetRuntime,ThemeRuntime,TransformersRuntime,applicationSpecSlice,createApplication,evaluateReflectionConstants,evaluateStaticMemoEvalPlan,findReflectionConstants,generateMemoEvalPlanRuntime,generateRuntimeInstance,isConfiguratorModelSchemaCompatible}from"#package/domain";export*from"./code/index.js";

package/dist/application-spec/parse-application-files/merge/merged-assistant.d.ts

@@ -1,13 +1,22 @@
 import { Branded } from '@salsita-ai/common/utils';
+import { type AssistantAiSettings } from '@salsita-ai/contracts/assistant';
 import type { ParseContext } from '../../core/index.js';
 import type { RawAssistant } from '../raw-spec/index.js';
 import type { ClassifiedSpecFile } from './classified-spec-file.js';
 /**
- * The singular `assistant` manifest after merge, or `null` when no spec file declares one. `origin`
- * names the declaring spec file so manifest diagnostics point at it.
+ * The assistant manifest merged from every spec file that declares an `assistant` block. Each file
+ * may leave `ai` out, but the merged manifest has it: the deployment cannot run its assistant
+ * without the provider, model tier and reasoning level.
+ */
+export type MergedAssistantManifest = RawAssistant & {
+    readonly ai: AssistantAiSettings;
+};
+/**
+ * The `assistant` manifest merged from every spec file that declares an `assistant` block, or `null`
+ * when none does or when none of them declares `ai`. Manifest diagnostics raised after the merge
+ * carry the YAML path but no file, as in every other merged section.
  */
 export type MergedAssistant = Branded<'MergedAssistant', {
-    readonly manifest: RawAssistant | null;
-    readonly origin: string | null;
+    readonly manifest: MergedAssistantManifest | null;
 }>;
 export declare const MergedAssistant: (files: readonly ClassifiedSpecFile[], ctx: ParseContext) => MergedAssistant;

package/dist/application-spec/parse-application-files/merge/merged-assistant.js

@@ -1 +1 @@
-import{Branded as t}from"@salsita-ai/common/utils";import{DiagnosticCode as n,diagnosticMessages as o}from"../../errors/index.js";export const MergedAssistant=(r,i)=>{let s,e=null;for(let t of r)if(void 0!==t.content.assistant){if(s){i.error(n.CONFLICTING_ASSISTANT,o.CONFLICTING_ASSISTANT(s,t.name));continue}s=t.name,e=t.content.assistant}return t({manifest:e,origin:s??null})};
+import{Branded as e}from"@salsita-ai/common/utils";import{ASSISTANT_HOURLY_LIMIT_LEVELS as t,ASSISTANT_HOURLY_LIMIT_MAXIMA as i,ASSISTANT_MAX_THREAD_SIZE as s}from"@salsita-ai/contracts/assistant";import{DiagnosticCode as a,diagnosticMessages as r}from"../../errors/index.js";let n=(e,t,i,s)=>{let n=t.flatMap(e=>{let t=i(e.manifest);return t?[{file:e.file,entries:t}]:[]});if(0===n.length)return;let l={},o=new Map;for(let{file:t,entries:i}of n)for(let[n,S]of Object.entries(i)){let i=o.get(n);if(i){s.at("assistant",e,n).error(a.ASSISTANT_MERGE_CONFLICT,r.ASSISTANT_MERGE_CONFLICT(e,n,i,t));continue}o.set(n,t),l[n]=S}return l},l=(e,t,i,s)=>{let n,l;for(let o of t){let t=i(o.manifest);if(void 0!==t){if(n){s.at("assistant",e).error(a.DUPLICATE_ASSISTANT_FIELD,r.DUPLICATE_ASSISTANT_FIELD(e,n,o.file));continue}n=o.file,l=t}}return l};export const MergedAssistant=(o,S)=>{let A=o.flatMap(e=>e.content.assistant?[{file:e.name,manifest:e.content.assistant}]:[]);if(0===A.length)return e({manifest:null});let f={entities:n("entities",A,e=>e.entities,S),deletable:n("deletable",A,e=>e.deletable,S),writable:n("writable",A,e=>e.writable,S),childRecipes:n("childRecipes",A,e=>e.childRecipes,S),replaceRecipes:n("replaceRecipes",A,e=>e.replaceRecipes,S),actions:n("actions",A,e=>e.actions,S),screenshots:n("screenshots",A,e=>e.screenshots,S),formElements:n("formElements",A,e=>e.formElements,S),lenses:l("lenses",A,e=>e.lenses,S),instructions:l("instructions",A,e=>e.instructions,S),ai:l("ai",A,e=>e.ai,S)},{ai:c}=f;if(!c)return S.at("assistant","ai").error(a.ASSISTANT_MISSING_AI,r.ASSISTANT_MISSING_AI()),e({manifest:null});for(let e of(void 0!==c.maxThreadSize&&c.maxThreadSize>s&&S.at("assistant","ai","maxThreadSize").error(a.ASSISTANT_AI_ABOVE_MAXIMUM,r.ASSISTANT_AI_ABOVE_MAXIMUM("maxThreadSize",c.maxThreadSize,s)),t)){let t=c.hourlyLimits?.[e];void 0!==t&&t>i[e]&&S.at("assistant","ai","hourlyLimits",e).error(a.ASSISTANT_AI_ABOVE_MAXIMUM,r.ASSISTANT_AI_ABOVE_MAXIMUM(`hourlyLimits.${e}`,t,i[e]))}return e({manifest:{...f,ai:c}})};

package/dist/application-spec/parse-application-files/merge/merged-infra.d.ts

@@ -1,8 +1,7 @@
 import { Branded } from '@salsita-ai/common/utils';
+import type { Acl, ResourceEntry, SpecResourcesConfig } from '#package/domain';
 import type { ParseContext } from '../../core/index.js';
-import type { AclRole } from '../raw-spec/raw-acl.js';
 import type { RawEnvVarEntry } from '../raw-spec/raw-env.js';
-import type { RawResourceEntry } from '../raw-spec/raw-resources.js';
 import type { ClassifiedSpecFile } from './classified-spec-file.js';
 /** Merged infrastructure settings (env, ACL, resources). */
 export type MergedInfra = Branded<'MergedInfra', {
@@ -10,14 +9,8 @@ export type MergedInfra = Branded<'MergedInfra', {
         readonly frontend?: Readonly<Record<string, RawEnvVarEntry>>;
         readonly webhook?: Readonly<Record<string, RawEnvVarEntry>>;
     };
-    readonly acl: {
-        readonly canCreate: readonly AclRole[];
-    };
-    readonly resources?: readonly RawResourceEntry[];
-    readonly resourcesConfig?: {
-        readonly baseResourcesUrl?: string;
-        readonly prefetchTextureUrls?: readonly string[];
-        readonly deploymentQueryDisabled?: boolean;
-    };
+    readonly acl: Acl;
+    readonly resources?: readonly ResourceEntry[];
+    readonly resourcesConfig?: SpecResourcesConfig;
 }>;
 export declare const MergedInfra: (files: readonly ClassifiedSpecFile[], ctx: ParseContext) => MergedInfra;

package/dist/application-spec/parse-application-files/merge/merged-transformers.d.ts

@@ -1,10 +1,8 @@
 import { Branded } from '@salsita-ai/common/utils';
+import type { TransformerEntry } from '#package/domain';
 import type { ParseContext } from '../../core/index.js';
 import type { ClassifiedSpecFile } from './classified-spec-file.js';
-export interface TransformerEntry {
-    readonly name: string;
-    readonly priority?: number;
-}
+export type { TransformerEntry } from '#package/domain';
 /** Merged transformers. The "transformers" section is singular — only one file may declare it. */
 export type MergedTransformers = Branded<'MergedTransformers', readonly TransformerEntry[]>;
 export declare const MergedTransformers: (files: readonly ClassifiedSpecFile[], ctx: ParseContext) => MergedTransformers;

package/dist/application-spec/parse-application-files/parse-application-files.js

@@ -1 +1 @@
-import{Branded as e}from"@salsita-ai/common/utils";import{ParseContext as s}from"../core/index.js";import{CategorizedFiles as t}from"./categorize/index.js";import{MergedSpec as i}from"./merge/index.js";import{RawSpecFiles as r}from"./raw-spec/parse-raw-spec.js";import{RawMockTemplates as p}from"./raw-spec/raw-mock-templates.js";import{ResolvedSpecFiles as a}from"./resolve/index.js";import{ApplicationSpec as o}from"./spec/index.js";export const parseApplicationFiles=(l,n)=>{let{rawProjectFiles:m,phxDefinitions:c}=l,{evalExpressionParser:d,referenceStore:f,parsingContext:F}=n,u=F??new s,S=u.startSpan("parseApplicationFiles","build","parse-application-files.ts"),g=t(m,f,u,n);if(!g)return S(),u.toResult(void 0);let w=u.startSpan("RawSpecFiles","parseApplicationFiles","parse-raw-spec.ts"),A=r(g.spec,u);w();let R=u.startSpan("RawMockTemplates","parseApplicationFiles","raw-mock-templates.ts"),j=p(g.mockTemplates,u);if(R(),!A)return S(),u.toResult(void 0);let v=u.startSpan("ResolvedSpecFiles","parseApplicationFiles","resolved-spec-files.ts"),x=a(A,m,u);v();let k=u.startSpan("MergedSpec","parseApplicationFiles","merged-spec.ts"),M=i(x,u);if(k(),u.hasErrors)return S(),u.toResult(void 0);let T=u.startSpan("ApplicationSpec","parseApplicationFiles","application-spec.ts"),b=o({merged:M,migrationFiles:g.migrations,adminMigrationFiles:g.adminMigrations,transformerFiles:g.transformers.map(e=>e.file.name),phxDefinitions:c,evalExpressionParser:d},u);return(T(),b)?(S(),u.toResult(e({rawProjectFiles:m,categorizedFiles:g,rawMockTemplates:j,applicationSpec:b}))):(S(),u.toResult(void 0))};
+import{Branded as e}from"@salsita-ai/common/utils";import{ParseContext as s}from"../core/index.js";import{DiagnosticCode as t,diagnosticMessages as r}from"../errors/index.js";import{CategorizedFiles as i}from"./categorize/index.js";import{MergedSpec as a}from"./merge/index.js";import{RawSpecFiles as p}from"./raw-spec/parse-raw-spec.js";import{RawMockTemplates as o}from"./raw-spec/raw-mock-templates.js";import{ResolvedSpecFiles as l}from"./resolve/index.js";import{ApplicationSpec as n}from"./spec/index.js";export const parseApplicationFiles=(m,c)=>{let{rawProjectFiles:d,phxDefinitions:f}=m,{evalExpressionParser:u,referenceStore:F,parsingContext:A}=c,g=A??new s,w=g.startSpan("parseApplicationFiles","build","parse-application-files.ts"),R=i(d,F,g,c);if(!R)return w(),g.toResult(void 0);let S=g.startSpan("RawSpecFiles","parseApplicationFiles","parse-raw-spec.ts"),T=p(R.spec,g);S();let j=g.startSpan("RawMockTemplates","parseApplicationFiles","raw-mock-templates.ts"),O=o(R.mockTemplates,g);if(j(),!T)return w(),g.toResult(void 0);let k=g.startSpan("ResolvedSpecFiles","parseApplicationFiles","resolved-spec-files.ts"),v=l(T,d,g);k();let x=g.startSpan("MergedSpec","parseApplicationFiles","merged-spec.ts"),H=a(v,g);if(x(),g.hasErrors)return w(),g.toResult(void 0);let E=g.startSpan("ApplicationSpec","parseApplicationFiles","application-spec.ts"),M=n({merged:H,migrationFiles:R.migrations,adminMigrationFiles:R.adminMigrations,transformerFiles:R.transformers.map(e=>e.file.name),phxDefinitions:f,evalExpressionParser:u},g);return(E(),M)?(!R.hasWebhookEntry&&(M.appMetadata.useAuthHook||M.appMetadata.useClerk)&&g.warning(t.AUTH_WITHOUT_PROJECT_WEBHOOK,r.AUTH_WITHOUT_PROJECT_WEBHOOK()),w(),g.toResult(e({rawProjectFiles:d,categorizedFiles:R,rawMockTemplates:O,applicationSpec:M}))):(w(),g.toResult(void 0))};

package/dist/application-spec/parse-application-files/raw-spec/raw-acl.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-export declare const aclRoles: readonly ['anonymous', 'user', 'admin', 'superadmin'];
-export type AclRole = (typeof aclRoles)[number];
+import { type AclRole } from '#package/domain';
+export { type AclRole, aclRoles } from '#package/domain';
 export type RawAcl = {
     readonly canCreate?: readonly AclRole[];
 };

package/dist/application-spec/parse-application-files/raw-spec/raw-acl.js

@@ -1 +1 @@
-import{z as o}from"zod";export const aclRoles=["anonymous","user","admin","superadmin"];export const rawAclSchema=o.object({canCreate:o.array(o.enum(aclRoles)).optional()});
+import{z as o}from"zod";import{aclRoles as a}from"#package/domain";export{aclRoles}from"#package/domain";export const rawAclSchema=o.object({canCreate:o.array(o.enum(a)).optional()});

package/dist/application-spec/parse-application-files/raw-spec/raw-admin-pages.d.ts

@@ -1,26 +1,5 @@
 import { z } from 'zod';
-export interface RawAdminPages {
-    readonly presets?: boolean | {
-        readonly categoryNavigationState?: string;
-        readonly presetNavigationState?: string;
-    };
-    readonly recipes?: ReadonlyArray<{
-        readonly name: string;
-        readonly navigationState?: string;
-    }>;
-    readonly pages?: ReadonlyArray<{
-        readonly key: string;
-        readonly title: string;
-        readonly icon?: string;
-        readonly navigationState?: string;
-        readonly entity?: string;
-        readonly component?: string;
-        readonly actionsComponent?: string;
-        readonly connectedDataEntry?: string;
-        readonly sidebar?: {
-            readonly title: string;
-            readonly component: string;
-        };
-    }>;
-}
+import type { AdminPagesSection } from '#package/domain';
+/** The `$adminPages` section of an admin spec file as written; see {@link AdminPagesSection} in `domain`. */
+export type RawAdminPages = AdminPagesSection;
 export declare const rawAdminPagesSchema: z.ZodType<RawAdminPages, z.ZodTypeDef, unknown>;

package/dist/application-spec/parse-application-files/raw-spec/raw-assistant.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { type AssistantAiSettings } from '@salsita-ai/contracts/assistant';
-import { ASSISTANT_HINTS } from '#package/domain';
+import { ASSISTANT_HINTS, type AssistantFormAttribute, type AssistantFormRole } from '#package/domain';
 /**
  * One whitelisted field in the assistant manifest. `description` overrides the JSON Schema
  * description of the shape property; `as` exposes the field under a different GraphQL name; `lenses`
@@ -12,6 +12,21 @@ export interface RawAssistantField {
     readonly as?: string;
     readonly lenses?: readonly string[];
 }
+/**
+ * One of the project's own elements of an assistant form, keyed under `assistant.formElements` by
+ * its tag, and implemented by the component a file in `src/elements/` registers under the same name
+ * with `phx.frontend.createAssistantFormElement`. `role` decides the props the component gets, how
+ * the form collects it into the answer and where the prompt lists it, with `description` after its
+ * signature. `attributes` are flat scalars beside the built-in `label`, each a JSON Schema of the
+ * keywords `AssistantFormAttribute` allows, and `required` names those the model must write. An
+ * option or an input that takes a `value` declares it like any other attribute.
+ */
+export interface RawAssistantFormElement {
+    readonly description: string;
+    readonly role: AssistantFormRole;
+    readonly attributes?: Readonly<Record<string, AssistantFormAttribute>>;
+    readonly required?: readonly string[];
+}
 /**
  * One lens of the assistant `lenses` map, keyed by the name the agent spreads it by: a named
  * selection made of the `entities` entries tagged with that name. `description` tells the agent when
@@ -42,12 +57,15 @@ export type AssistantHint = (typeof ASSISTANT_HINTS)[number];
  * system component `componentType` on the entity type. It generates the `<field>Options` edge under
  * `meta`, named by `as` when given, and makes `modify<Type>` reject a value outside the choices
  * unless `validate` is `false`. `allowDryRuns: false` turns the dry-run of the choices off, for
- * fields with too many of them to try out. The component is named explicitly and never inferred from
- * a `$bind`.
+ * fields with too many of them to try out. `componentType` and `instanceName` are given together or
+ * not at all: without them the component is the one `materialSwatch`, `attributeSelection` or
+ * `distanceDimensionSelect` instance on the entity type, or on an alias containing it, that writes
+ * the field through `$bind` or `$write`. Naming it chooses between several such instances, or gives
+ * the agent another list than the user's control shows.
  */
 export interface RawAssistantFieldOptions {
-    readonly componentType: AssistantOptionComponentType;
-    readonly instanceName: string;
+    readonly componentType?: AssistantOptionComponentType;
+    readonly instanceName?: string;
     readonly as?: string;
     readonly validate?: boolean;
     readonly allowDryRuns?: boolean;
@@ -55,30 +73,26 @@ export interface RawAssistantFieldOptions {
 }
 /**
  * One writable field of the assistant `writable` map. An empty entry (`width:` in YAML) declares the
- * stored field writable; `options` links it to the component that holds its choices.
+ * stored field writable, linked to the component that holds its choices when one instance writes it;
+ * `options` sets up that link, and `options: null` declares the field without one.
  */
 export interface RawAssistantWritableField {
-    readonly options?: RawAssistantFieldOptions;
+    readonly options?: RawAssistantFieldOptions | null;
 }
 /**
  * One recipe group of the assistant `childRecipes` or `replaceRecipes` map, keyed by the instance
- * name of a `childEntityRecipes` or a `replaceEntityRecipes` component. `as` is the id the agent addresses the group by, the instance name
- * by default; `description` replaces the component's group description; `allowDryRuns: false` turns
- * the dry-run of the group's recipes off, for groups too large to try out. An empty entry
- * (`cabinets:` in YAML) exposes the group with its defaults.
+ * name of a `childEntityRecipes` or a `replaceEntityRecipes` component. It becomes a field of the
+ * entity type's `<Type>ChildRecipes` or `<Type>ReplaceRecipes` type, named by `as`, the instance
+ * name by default, which is also the id the agent passes to `addChild` or `replaceEntity`.
+ * `description` describes that field; `allowDryRuns: false` turns the dry-run of the group's recipes
+ * off, for groups too large to try out; `hints` say when the agent can reuse what it read. An empty
+ * entry (`cabinets:` in YAML) exposes the group with its defaults.
  */
 export interface RawAssistantRecipeGroup {
     readonly as?: string;
     readonly description?: string;
     readonly allowDryRuns?: boolean;
-}
-/**
- * The recipes of one entity type or alias in the assistant `childRecipes` or `replaceRecipes` map:
- * its recipe groups under `groups`, and the `hints` that hold for the whole edge of the type.
- */
-export interface RawAssistantRecipes {
     readonly hints?: readonly AssistantHint[];
-    readonly groups: Readonly<Record<string, RawAssistantRecipeGroup | null>>;
 }
 /**
  * One entry of the assistant `actions` map, keyed by the name of an action declared under the
@@ -90,6 +104,16 @@ export interface RawAssistantAction {
     readonly description?: string;
     readonly as?: string;
 }
+/**
+ * One view of the assistant `screenshots` map, keyed by the instance name of an `agentScreenshot`
+ * component: it lets the agent take a screenshot of the entity from that view under `meta`.
+ * `description` tells the agent what the view shows; `as` is the name the agent asks for the view
+ * by, the instance name by default.
+ */
+export interface RawAssistantScreenshot {
+    readonly description: string;
+    readonly as?: string;
+}
 /**
  * Experimental assistant manifest authored under the `assistant` root key. `entities` whitelists the
  * stored fields the generated GraphQL schema exposes, keyed by entity type or alias name and then by
@@ -100,8 +124,15 @@ export interface RawAssistantAction {
  * entity type or alias, the `childEntityRecipes` groups whose recipes the agent may list and add
  * with `addChild`. `replaceRecipes` names, per entity type or alias, the `replaceEntityRecipes`
  * groups whose recipes the agent may list and replace the entity by with `replaceEntity`. `actions`
- * names the declared actions the agent may run as custom mutations. Nothing is exposed without an
- * entry. `lenses` declares the named selections that `entities` entries are tagged with.
+ * names the declared actions the agent may run as custom mutations. `screenshots` names, per entity
+ * type or alias, the `agentScreenshot` views the agent may take a screenshot of the entity from.
+ * Nothing is exposed without an entry. `lenses` declares the named selections that `entities`
+ * entries are tagged with, and `formElements` the project's own elements of the forms the agent
+ * asks the user with.
+ *
+ * The manifest can be split across spec files: each section keyed by entity type, action or form
+ * element name merges per key, while `ai`, `instructions` and `lenses` are declared in one file
+ * each, and `ai` in exactly one.
  *
  * `ai` and `instructions` are for the server only: the provider, model tier and reasoning level the
  * deployment's assistant runs with, and the integrator's own guidance for it, appended to the system
@@ -111,11 +142,15 @@ export interface RawAssistant {
     readonly entities?: Readonly<Record<string, Readonly<Record<string, RawAssistantField | null>>>>;
     readonly deletable?: Readonly<Record<string, RawAssistantDeletable | null>>;
     readonly writable?: Readonly<Record<string, Readonly<Record<string, RawAssistantWritableField | null>>>>;
-    readonly childRecipes?: Readonly<Record<string, RawAssistantRecipes>>;
-    readonly replaceRecipes?: Readonly<Record<string, RawAssistantRecipes>>;
+    readonly childRecipes?: Readonly<Record<string, Readonly<Record<string, RawAssistantRecipeGroup | null>>>>;
+    readonly replaceRecipes?: Readonly<Record<string, Readonly<Record<string, RawAssistantRecipeGroup | null>>>>;
     readonly actions?: Readonly<Record<string, RawAssistantAction | null>>;
+    readonly screenshots?: Readonly<Record<string, Readonly<Record<string, RawAssistantScreenshot>>>>;
     readonly lenses?: Readonly<Record<string, RawAssistantLens>>;
+    readonly formElements?: Readonly<Record<string, RawAssistantFormElement>>;
     readonly instructions?: string;
-    readonly ai: AssistantAiSettings;
+    readonly ai?: AssistantAiSettings;
 }
+/** A GraphQL name the schema may use for a field or type: letters, digits and `_`, not starting with a digit or `__`. */
+export declare const GRAPHQL_NAME_PATTERN: RegExp;
 export declare const rawAssistantSchema: z.ZodType<RawAssistant>;

package/dist/application-spec/parse-application-files/raw-spec/raw-assistant.js

@@ -1 +1 @@
-import{z as e}from"zod";import{ASSISTANT_AI_PROVIDERS as t,ASSISTANT_MODEL_TIERS as o,ASSISTANT_REASONING_LEVELS as i}from"@salsita-ai/contracts/assistant";import{ASSISTANT_HINTS as n}from"#package/domain";export const ASSISTANT_OPTION_COMPONENT_TYPES=["materialSwatch","attributeSelection","distanceDimensionSelect"];let r=e.string().regex(/^(?!__)[_A-Za-z][_0-9A-Za-z]*$/,'must be a GraphQL name: letters, digits and "_", not starting with a digit or "__"'),s=t=>e.enum(t,{errorMap:()=>({message:`must be one of: ${t.join(", ")}`})}),a=e.object({description:e.string().optional(),as:r.optional(),lenses:e.array(e.string()).optional()}).strict(),l="must be a whole number of at least 1; remove the key to nest tagged relations one level",c=e.object({description:e.string().trim().min(1,"must not be empty; say when the agent should use the lens"),maxDepth:e.number({invalid_type_error:l}).int(l).min(1,l).optional()}).strict(),p=r.refine(e=>!e.includes("__"),'must not contain "__", which names the generated copies of a lens'),m=e.array(s(n)),d=e.object({options:e.object({componentType:s(ASSISTANT_OPTION_COMPONENT_TYPES),instanceName:e.string().min(1,"must not be empty; name the component instance that holds the choices"),as:r.optional(),validate:e.boolean().optional(),allowDryRuns:e.boolean().optional(),hints:m.optional()}).strict().optional()}).strict(),u=e.object({as:e.string().trim().min(1,"must not be empty; remove the key to use the instance name").optional(),description:e.string().optional(),allowDryRuns:e.boolean().optional()}).strict(),h=t=>e.object({hints:m.optional(),groups:e.record(e.string(),u.nullable(),{required_error:`is required: the recipe groups of the type go under "groups", keyed by the instance name of a "${t}" component`})}).strict(),b=e.object({description:e.string().optional(),as:r.optional()}).strict(),g=`is required: declare provider (${t.join(", ")}), model (${o.join(", ")}) and reasoning (${i.join(", ")})`,_="must be a positive whole number of input tokens; remove the key to use the default of the server",y=e.object({provider:s(t),model:s(o),reasoning:s(i),maxThreadSize:e.number({invalid_type_error:_}).int(_).positive(_).optional()},{required_error:g,invalid_type_error:g}).strict();export const rawAssistantSchema=e.object({entities:e.record(e.string(),e.record(e.string(),a.nullable())).optional(),deletable:e.record(e.string(),e.object({}).strict().nullable()).optional(),writable:e.record(e.string(),e.record(e.string(),d.nullable())).optional(),childRecipes:e.record(e.string(),h("childEntityRecipes")).optional(),replaceRecipes:e.record(e.string(),h("replaceEntityRecipes")).optional(),actions:e.record(e.string(),b.nullable()).optional(),lenses:e.record(p,c).optional(),instructions:e.string().trim().min(1,"must not be empty; remove the key when there are no instructions").optional(),ai:y}).strict();
+import{z as e}from"zod";import{ASSISTANT_AI_PROVIDERS as t,ASSISTANT_MODEL_TIERS as o,ASSISTANT_REASONING_LEVELS as n}from"@salsita-ai/contracts/assistant";import{ASSISTANT_FORM_NAME_PATTERN as i,ASSISTANT_HINTS as r}from"#package/domain";export const ASSISTANT_OPTION_COMPONENT_TYPES=["materialSwatch","attributeSelection","distanceDimensionSelect"];export const GRAPHQL_NAME_PATTERN=/^(?!__)[_A-Za-z][_0-9A-Za-z]*$/;let a=e.string().regex(GRAPHQL_NAME_PATTERN,'must be a GraphQL name: letters, digits and "_", not starting with a digit or "__"'),s=t=>e.enum(t,{errorMap:()=>({message:`must be one of: ${t.join(", ")}`})}),l=e.object({description:e.string().optional(),as:a.optional(),lenses:e.array(e.string()).optional()}).strict(),m="must be a whole number of at least 1; remove the key to nest tagged relations one level",p=e.object({description:e.string().trim().min(1,"must not be empty; say when the agent should use the lens"),maxDepth:e.number({invalid_type_error:m}).int(m).min(1,m).optional()}).strict(),c=a.refine(e=>!e.includes("__"),'must not contain "__", which names the generated copies of a lens'),u=e.array(s(r)),d=e.object({options:e.object({componentType:s(ASSISTANT_OPTION_COMPONENT_TYPES).optional(),instanceName:e.string().min(1,"must not be empty; name the component instance that holds the choices").optional(),as:a.optional(),validate:e.boolean().optional(),allowDryRuns:e.boolean().optional(),hints:u.optional()}).strict().refine(({componentType:e,instanceName:t})=>void 0===e==(void 0===t),'must give "componentType" and "instanceName" together, or neither to use the one option component instance that writes the field').nullable().optional()}).strict(),h=e.object({as:a.optional(),description:e.string().optional(),allowDryRuns:e.boolean().optional(),hints:u.optional()},{errorMap:(t,o)=>({message:t.code===e.ZodIssueCode.unrecognized_keys?`${o.defaultError}. A recipe group takes "as", "description", "allowDryRuns" and "hints"; the groups of a type go directly under it, keyed by instance name, with no "groups" level`:o.defaultError})}).strict(),g=e.object({description:e.string().optional(),as:a.optional()}).strict(),b=["enum","pattern","minimum","maximum","minLength","maxLength"],y=["enum","pattern","minLength","maxLength"],f=["enum","minimum","maximum"],v=e.object({type:s(["string","number","integer","boolean"]),enum:e.array(e.union([e.string(),e.number()])).min(1,"must list at least one value").optional(),pattern:e.string().refine(e=>{try{return RegExp(e,"u"),!0}catch{return!1}},"must be a regular expression, as in JSON Schema").optional(),minimum:e.number().optional(),maximum:e.number().optional(),minLength:e.number().int().nonnegative().optional(),maxLength:e.number().int().nonnegative().optional()}).strict().superRefine((t,o)=>{let n="string"===t.type?y:"boolean"===t.type?[]:f;for(let i of b)void 0===t[i]||n.includes(i)||o.addIssue({code:e.ZodIssueCode.custom,path:[i],message:`does not apply to an attribute of type "${t.type}"; remove it or change the type`});let i="string"===t.type?"string":"number";for(let[n,r]of("boolean"!==t.type&&t.enum?.some(e=>typeof e!==i||"integer"===t.type&&!Number.isInteger(e))&&o.addIssue({code:e.ZodIssueCode.custom,path:["enum"],message:`must list only ${"integer"===t.type?"whole number":i}s, since the attribute is of type "${t.type}"`}),[["minimum","maximum"],["minLength","maxLength"]])){let[i,a]=[t[n],t[r]];void 0!==i&&void 0!==a&&i>a&&o.addIssue({code:e.ZodIssueCode.custom,path:[n],message:`must not be greater than "${r}", or no value could satisfy the attribute`})}}),_=e.string().regex(i,'must start with a lowercase letter and hold only lowercase letters, digits and "-", since the panel reads form markup in lowercase'),w=e.object({description:e.string().trim().min(1,"must not be empty; say what the element is for and where the agent may use it"),role:s(["group","choice","choices","option","input"]),attributes:e.record(_,v).optional(),required:e.array(e.string()).optional()}).strict(),j=e.object({description:e.string().trim().min(1,"must not be empty; say what the view shows"),as:a.optional()}).strict(),x=`must be an object: declare provider (${t.join(", ")}), model (${o.join(", ")}) and reasoning (${n.join(", ")})`,T="must be a positive whole number of input tokens; remove the key to use the default of the server",N="must be a positive whole number of weighted tokens per hour; remove the key to use the default of the server",S=e.number({invalid_type_error:N}).int(N).positive(N).optional(),A=e.object({sub:S,ip:S,project:S},{invalid_type_error:"must be an object with any of sub, ip and project"}).strict(),E=e.object({provider:s(t),model:s(o),reasoning:s(n),maxThreadSize:e.number({invalid_type_error:T}).int(T).positive(T).optional(),hourlyLimits:A.optional()},{invalid_type_error:x}).strict();export const rawAssistantSchema=e.object({entities:e.record(e.string(),e.record(e.string(),l.nullable())).optional(),deletable:e.record(e.string(),e.object({}).strict().nullable()).optional(),writable:e.record(e.string(),e.record(e.string(),d.nullable())).optional(),childRecipes:e.record(e.string(),e.record(e.string(),h.nullable())).optional(),replaceRecipes:e.record(e.string(),e.record(e.string(),h.nullable())).optional(),actions:e.record(e.string(),g.nullable()).optional(),screenshots:e.record(e.string(),e.record(e.string(),j)).optional(),lenses:e.record(c,p).optional(),formElements:e.record(_,w).optional(),instructions:e.string().trim().min(1,"must not be empty; remove the key when there are no instructions").optional(),ai:E.optional()}).strict();

package/dist/application-spec/parse-application-files/raw-spec/raw-expressions.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
+import { type EnhancedJsonValue } from '#package/domain';
 import { type EnhancedJsonSchemaType } from '../../core/enhanced-json-schema.js';
-import { type EnhancedJsonValue } from '../../core/enhanced-json-value.js';
 /**
  * Discriminator tag for a single parsed expression entry.
  *

package/dist/application-spec/parse-application-files/raw-spec/raw-expressions.js

@@ -1 +1 @@
-import{z as r}from"zod";import{enhancedJsonSchema as e,extendEnhancedJsonSchema as s}from"../../core/enhanced-json-schema.js";import{EVAL_MARKER_KEY as n,evalMarkerSchema as o}from"../../core/markers/eval-marker.js";import{MSG_ID_MARKER_KEY as a,MSG_MARKER_KEY as t,msgMarkerSchema as i}from"../../core/markers/msg-marker.js";export const RawExpressionKind={User:"user",Value:"value"};let m=s(o),c=s(i),d=[n,t,a],l=r=>{let e={};for(let[s,n]of Object.entries(r))d.includes(s)||(e[s]=n);return e};export const rawExpressionEntrySchema=r.union([m,c,e]).transform(r=>{if(n in r)return{kind:RawExpressionKind.Value,constant:!1,value:{[n]:r.$eval},schema:l(r)};if(t in r){let e=void 0!==r.$msgId?{[t]:r.$msg,[a]:r.$msgId}:{[t]:r.$msg};return{kind:RawExpressionKind.Value,constant:!1,value:e,schema:l(r)}}return{kind:RawExpressionKind.User,schema:r}});export const rawExpressionsSchema=r.record(r.string(),r.record(r.string(),rawExpressionEntrySchema).readonly()).readonly();
+import{z as e}from"zod";import{EVAL_MARKER_KEY as r,MSG_ID_MARKER_KEY as n,MSG_MARKER_KEY as s,evalMarkerSchema as o,msgMarkerSchema as a}from"#package/domain";import{enhancedJsonSchema as i,extendEnhancedJsonSchema as t}from"../../core/enhanced-json-schema.js";export const RawExpressionKind={User:"user",Value:"value"};let c=t(o),m=t(a),d=[r,s,n],p=e=>{let r={};for(let[n,s]of Object.entries(e))d.includes(n)||(r[n]=s);return r};export const rawExpressionEntrySchema=e.union([c,m,i]).transform(e=>{if(r in e)return{kind:RawExpressionKind.Value,constant:!1,value:{[r]:e.$eval},schema:p(e)};if(s in e){let r=void 0!==e.$msgId?{[s]:e.$msg,[n]:e.$msgId}:{[s]:e.$msg};return{kind:RawExpressionKind.Value,constant:!1,value:r,schema:p(e)}}return{kind:RawExpressionKind.User,schema:e}});export const rawExpressionsSchema=e.record(e.string(),e.record(e.string(),rawExpressionEntrySchema).readonly()).readonly();

package/dist/application-spec/parse-application-files/raw-spec/raw-resources.d.ts

@@ -1,67 +1,22 @@
 import { z } from 'zod';
-declare const rawConfigurationLinkSchema: z.ZodObject<{
-    type: z.ZodLiteral<"ConfigurationLink">;
-    name: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    type: "ConfigurationLink";
-    name: string;
-}, {
-    type: "ConfigurationLink";
-    name: string;
-}>;
-declare const rawCsvSchema: z.ZodObject<{
-    type: z.ZodLiteral<"Csv">;
-    name: z.ZodString;
-    s3Key: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    type: "Csv";
-    name: string;
-    s3Key?: string | undefined;
-}, {
-    type: "Csv";
-    name: string;
-    s3Key?: string | undefined;
-}>;
-declare const rawPdfSchema: z.ZodObject<{
-    type: z.ZodLiteral<"Pdf">;
-    name: z.ZodString;
-    s3Key: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    type: "Pdf";
-    name: string;
-    s3Key?: string | undefined;
-}, {
-    type: "Pdf";
-    name: string;
-    s3Key?: string | undefined;
-}>;
-export type RawConfigurationLinkResource = Readonly<z.infer<typeof rawConfigurationLinkSchema>>;
-export type RawCsvResource = Readonly<z.infer<typeof rawCsvSchema>>;
-export type RawPdfResource = Readonly<z.infer<typeof rawPdfSchema>>;
-export interface RawClientGeneratedImageResource {
-    readonly type: 'Image';
-    readonly name: string;
-    readonly clientGenerated: true;
-    readonly s3Key: string;
-}
-export interface RawExistingImageResource {
-    readonly type: 'Image';
-    readonly name: string;
-    readonly exists: true;
-    readonly url: string;
-}
-export interface RawGeneratedImageResource {
-    readonly type: 'Image';
-    readonly name: string;
-    readonly s3Key: string;
-}
-export type RawImageResource = RawClientGeneratedImageResource | RawExistingImageResource | RawGeneratedImageResource;
-export type RawResourceEntry = RawConfigurationLinkResource | RawCsvResource | RawPdfResource | RawImageResource;
+import type { ClientGeneratedImageResource, ConfigurationLinkResource, CsvResource, ExistingImageResource, GeneratedImageResource, ImageResource, PdfResource, ResourceEntry, SpecResourcesConfig } from '#package/domain';
+/** A configuration link resource; see {@link ConfigurationLinkResource} in `domain`. */
+export type RawConfigurationLinkResource = ConfigurationLinkResource;
+/** A CSV document resource; see {@link CsvResource} in `domain`. */
+export type RawCsvResource = CsvResource;
+/** A PDF document resource; see {@link PdfResource} in `domain`. */
+export type RawPdfResource = PdfResource;
+/** An image resource the client renders; see {@link ClientGeneratedImageResource} in `domain`. */
+export type RawClientGeneratedImageResource = ClientGeneratedImageResource;
+/** An image resource that already exists at a URL; see {@link ExistingImageResource} in `domain`. */
+export type RawExistingImageResource = ExistingImageResource;
+/** An image resource the server renders; see {@link GeneratedImageResource} in `domain`. */
+export type RawGeneratedImageResource = GeneratedImageResource;
+/** One of the three kinds of image resource; see {@link ImageResource} in `domain`. */
+export type RawImageResource = ImageResource;
+/** One entry of the `resources` section; see {@link ResourceEntry} in `domain`. */
+export type RawResourceEntry = ResourceEntry;
 export declare const rawResourcesSchema: z.ZodType<readonly RawResourceEntry[]>;
-export type RawResourcesConfig = {
-    readonly baseResourcesUrl?: string;
-    readonly prefetchTextureUrls?: readonly string[];
-    readonly deploymentQueryDisabled?: boolean;
-};
+/** The `resourcesConfig` section; see {@link SpecResourcesConfig} in `domain`. */
+export type RawResourcesConfig = SpecResourcesConfig;
 export declare const rawResourcesConfigSchema: z.ZodType<RawResourcesConfig>;
-export {};

package/dist/application-spec/parse-application-files/spec/application/admin-spec/admin-pages.d.ts

@@ -1,27 +1,10 @@
-import { Branded } from '@salsita-ai/common/utils';
+import type { AdminPages as AdminPagesData } from '#package/domain';
 import type { ParseContext } from '../../../../core/index.js';
 import type { MergedAdminPages } from '../../../merge/index.js';
-import type { RawAdminPages } from '../../../raw-spec/index.js';
-import { type ComponentEntry } from '../../components/index.js';
 import type { ModelVersion } from '../../model/index.js';
 import type { DataSpec } from '../../sections/index.js';
-export type AdminPages = Branded<'AdminPages', {
-    readonly spec: RawAdminPages;
-    readonly components: readonly ComponentEntry[];
-    readonly navigationItems: readonly AdminNavigationItem[];
-    readonly navigationStates: readonly string[];
-}>;
-interface AdminNavigationListItem {
-    readonly label: string;
-    readonly icon?: string;
-    readonly navigationStates: readonly string[];
-}
-interface AdminNestedNavigationListItem {
-    readonly label: string;
-    readonly icon?: string;
-    readonly items: ReadonlyArray<Omit<AdminNavigationListItem, 'icon'>>;
-}
-type AdminNavigationItem = AdminNavigationListItem | AdminNestedNavigationListItem;
+/** The parsed admin pages of an admin spec; see {@link AdminPagesData | AdminPages} in `domain`. */
+export type AdminPages = AdminPagesData;
 interface AdminPageContext {
     readonly latestModel: ModelVersion;
     readonly parsingContext: ParseContext;

package/dist/application-spec/parse-application-files/spec/application/admin-spec/states.d.ts

@@ -1,8 +1,6 @@
-import { Branded } from '@salsita-ai/common/utils';
+import type { AdminStates as AdminStatesData } from '#package/domain';
 import type { ParseContext } from '../../../../core/index.js';
 import type { MergedAdminStates } from '../../../merge/index.js';
-import { type StateValue } from '../../sections/state-value.js';
-export type AdminStates = Branded<'AdminStates', {
-    readonly navigationStates: readonly StateValue[];
-}>;
+/** The validated navigation states of the admin; see {@link AdminStatesData | AdminStates} in `domain`. */
+export type AdminStates = AdminStatesData;
 export declare const AdminStates: (merged: MergedAdminStates, ctx: ParseContext) => AdminStates;

package/dist/application-spec/parse-application-files/spec/application/configurator-spec/states.d.ts

@@ -1,11 +1,6 @@
-import { Branded } from '@salsita-ai/common/utils';
+import type { ConfiguratorStates as ConfiguratorStatesData } from '#package/domain';
 import type { ParseContext } from '../../../../core/index.js';
 import type { MergedConfiguratorStates } from '../../../merge/index.js';
-import { StateValue } from '../../sections/state-value.js';
-export type ConfiguratorStates = Branded<'ConfiguratorStates', {
-    readonly navigationStates: readonly StateValue[];
-    readonly viewStates: readonly StateValue[];
-    readonly toolStates: readonly StateValue[];
-    readonly exportStates: readonly StateValue[];
-}>;
+/** The validated UI states of the configurator; see {@link ConfiguratorStatesData | ConfiguratorStates} in `domain`. */
+export type ConfiguratorStates = ConfiguratorStatesData;
 export declare const ConfiguratorStates: (merged: MergedConfiguratorStates, ctx: ParseContext) => ConfiguratorStates;

package/dist/application-spec/parse-application-files/spec/components/bindings/read-binding.d.ts

@@ -1,18 +1,8 @@
-import { Branded } from '@salsita-ai/common/utils';
+import type { ComponentReadBinding as ComponentReadBindingData } from '#package/domain';
 import type { ParseContext } from '../../../../core/index.js';
 import type { EntityOrAliasName, InstanceName, ResolvedShape } from '../../model/index.js';
-/**
- * A validated `$read` dependency found anywhere in the component props tree.
- * Used for memoEval dependency tracking — the target becomes `self.target` in generated code.
- * Field targets are validated against the entity shape; expression targets ($-prefixed)
- * are accepted without validation (they may be inferred during Phase C).
- */
-export type ComponentReadBinding = Branded<'ComponentReadBinding', {
-    /** The raw target string from `$read` (e.g. "height" or "$price"). */
-    readonly target: string;
-    /** Whether the target is an expression (starts with `$`) or a shape field. */
-    readonly isExpression: boolean;
-}>;
+/** A validated `$read` dependency of a component; see {@link ComponentReadBindingData | ComponentReadBinding} in `domain`. */
+export type ComponentReadBinding = ComponentReadBindingData;
 export interface ComponentReadBindingContext {
     readonly entityKey: EntityOrAliasName;
     readonly componentName: string;

package/dist/application-spec/parse-application-files/spec/components/bindings/write-binding.d.ts

@@ -1,42 +1,14 @@
-import { Branded } from '@salsita-ai/common/utils';
+import type { AssertionKind, ComponentWriteBinding as ComponentWriteBindingData } from '#package/domain';
 import { type EnhancedJsonSchemaType, type ParseContext } from '../../../../core/index.js';
 import { type EntityOrAliasName, type InstanceName, type ResolvedShape } from '../../model/index.js';
-/**
- * Runtime type assertion to emit in the write callback.
- * Resolved from the target entity field's schema during parsing.
- */
-export type AssertionKind = {
-    readonly kind: 'declaredType';
-    readonly typeName: string;
-} | {
-    readonly kind: 'declaredTypeId';
-    readonly referencedType: string;
-} | {
-    readonly kind: 'primitive';
-    readonly assertFn: 'assertString' | 'assertNumber' | 'assertBoolean';
-} | {
-    readonly kind: 'literal';
-    readonly value: null;
-} | {
-    readonly kind: 'anyOf';
-    readonly assertions: readonly AssertionKind[];
-} | {
-    readonly kind: 'none';
-};
+export type { AssertionKind } from '#package/domain';
 /**
  * Resolves the assertion kind from a field's schema.
  * Ported from domain-spec/spec/resolve-assertions.ts.
  */
 export declare const resolveAssertionKind: (fieldSchema: EnhancedJsonSchemaType) => AssertionKind;
-/**
- * A validated `$write` or `$bind` mapping from a component state key to an entity field.
- * Includes the resolved assertion kind for runtime type checking in the write callback.
- */
-export type ComponentWriteBinding = Branded<'ComponentWriteBinding', {
-    readonly propKey: string;
-    readonly entityField: string;
-    readonly assertion: AssertionKind;
-}>;
+/** A validated `$write` or `$bind` mapping of a component; see {@link ComponentWriteBindingData | ComponentWriteBinding} in `domain`. */
+export type ComponentWriteBinding = ComponentWriteBindingData;
 export interface ComponentWriteBindingContext {
     readonly entityKey: EntityOrAliasName;
     readonly componentName: string;

package/dist/application-spec/parse-application-files/spec/components/component-filter.d.ts

@@ -1,5 +1,5 @@
-import { Branded } from '@salsita-ai/common/utils';
-import { type ComponentFilter, type EnhancedJsonSchemaType, type EnhancedJsonValue } from '../../../core/index.js';
+import type { ComponentFilters as ComponentFiltersData } from '#package/domain';
+import { type EnhancedJsonSchemaType, type EnhancedJsonValue } from '../../../core/index.js';
 /**
  * Schema types for each filter criterion, used for expression inference.
  * When `$read: '$expr'` appears in a filter criterion, the expression is
@@ -7,14 +7,8 @@ import { type ComponentFilter, type EnhancedJsonSchemaType, type EnhancedJsonVal
  * infers `$x` as `boolean`).
  */
 export declare const FILTER_CRITERION_SCHEMAS: Readonly<Record<string, EnhancedJsonSchemaType>>;
-/**
- * Validated set of `$filter` entries on a user-bound component instance. Each
- * `ComponentFilter` represents one alternative filter condition; multiple
- * entries arise from `$or`. Empty `items` means no filter is applied.
- */
-export type ComponentFilters = Branded<'ComponentFilters', {
-    readonly items: readonly ComponentFilter[];
-}>;
+/** The validated `$filter` entries of a component instance; see {@link ComponentFiltersData | ComponentFilters} in `domain`. */
+export type ComponentFilters = ComponentFiltersData;
 /**
  * Parses a raw `$filter` value into a {@link ComponentFilters}. The shape is
  * guaranteed by upstream AJV validation against `ComponentSystemFilter` — this