@salsita-ai/sdk 0.50.0-develop.8c8c362f86 → 0.50.0-develop.8e3768cb11

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

@@ -0,0 +1,53 @@
+/**
+ * A single filter criterion — static value, dynamic `$read` reference, or
+ * inline `$eval` expression evaluated against `self` at runtime.
+ *
+ * The `target` field on the `'dynamic'` variant is a bare name (matches the
+ * same pattern as prop-level reads); codegen emits `self.target`, runtime
+ * reads `self[target]`.
+ */
+export type FilterCriterion<T> = {
+    readonly kind: 'static';
+    readonly value: T;
+} | {
+    readonly kind: 'dynamic';
+    readonly target: string;
+} | {
+    readonly kind: 'eval';
+    readonly code: string;
+};
+/**
+ * Parsed component filter controlling when the component is active. Two
+ * mutually-exclusive shapes:
+ *
+ * - `'gradual'` — zero or more per-criterion fields; compiles to one entry per
+ *   set key inside `.withGradualFilter({…})`. The preferred form.
+ * - `'root'` — the entire filter is a single `$read` at the root (legacy
+ *   form `$filter: { $read: '$x' }`); compiles to `.withFilter(self => (self.target))`.
+ *   Distinct codegen because the SDK's `withFilter` and `withGradualFilter`
+ *   methods have different evaluation semantics (whole-closure vs per-key).
+ *
+ * See `components.md §"Simple expression filter"` / `§"Declarative filter"`.
+ */
+export type ComponentFilter = {
+    readonly kind: 'gradual';
+    readonly navigationStates?: FilterCriterion<readonly string[]>;
+    readonly viewStates?: FilterCriterion<readonly string[]>;
+    readonly toolStates?: FilterCriterion<readonly string[]>;
+    readonly exportStates?: FilterCriterion<readonly string[]>;
+    readonly modes?: FilterCriterion<readonly string[]>;
+    readonly roles?: FilterCriterion<readonly string[]>;
+    readonly selectedEntityIds?: FilterCriterion<unknown>;
+    readonly hoveredEntityIds?: FilterCriterion<unknown>;
+    readonly draggedEntityIds?: FilterCriterion<unknown>;
+    readonly exportedEntityIds?: FilterCriterion<unknown>;
+    readonly active?: FilterCriterion<boolean>;
+    readonly fullscreen?: FilterCriterion<boolean>;
+    readonly debug?: FilterCriterion<boolean>;
+    readonly viewports?: FilterCriterion<unknown>;
+} | {
+    readonly kind: 'root';
+    readonly target: string;
+};
+/** Criterion field names on the gradual variant — used for parse and iteration. */
+export declare const FILTER_CRITERION_KEYS: readonly ["navigationStates", "viewStates", "toolStates", "exportStates", "modes", "roles", "selectedEntityIds", "hoveredEntityIds", "draggedEntityIds", "exportedEntityIds", "active", "fullscreen", "debug", "viewports"];

package/dist/application-spec/core/components/component-filter.js

@@ -0,0 +1 @@
+export const FILTER_CRITERION_KEYS=["navigationStates","viewStates","toolStates","exportStates","modes","roles","selectedEntityIds","hoveredEntityIds","draggedEntityIds","exportedEntityIds","active","fullscreen","debug","viewports"];

package/dist/application-spec/core/components/index.d.ts

@@ -0,0 +1,2 @@
+export * from './component-filter.js';
+export * from './sdk-code-ref.js';

package/dist/application-spec/core/components/index.js

@@ -0,0 +1 @@
+export*from"./component-filter.js";export*from"./sdk-code-ref.js";

package/dist/application-spec/core/components/sdk-code-ref.d.ts

@@ -0,0 +1,9 @@
+/**
+ * A parameter that should be emitted as an unquoted code reference in codegen
+ * (e.g. an entity reflection variable like `Top`).
+ * At runtime, the string value is resolved to the actual object (e.g. entity reflection).
+ */
+export interface SdkCodeRef {
+    readonly $codeRef: string;
+}
+export declare const isSdkCodeRef: (value: unknown) => value is SdkCodeRef;

package/dist/application-spec/core/components/sdk-code-ref.js

@@ -0,0 +1 @@
+export const isSdkCodeRef=e=>"object"==typeof e&&null!==e&&"$codeRef"in e&&"string"==typeof e.$codeRef;

package/dist/application-spec/core/enhanced-json-value.d.ts

@@ -1,9 +1,6 @@
 import { z } from 'zod';
-import { type EnhancedJsonSchemaType } from './enhanced-json-schema.js';
-import type { EvalExpressionParser } from './eval-expression-parser.js';
 import { type EvalMarker } from './markers/eval-marker.js';
 import { type MsgMarker } from './markers/msg-marker.js';
-import type { ParseContext } from './spec-diagnostic.js';
 /**
  * A JSON-serialisable value augmented with Phoenix structural markers:
  * `$msg` (i18n) and `$eval` (self-scoped code).
@@ -81,68 +78,3 @@ export declare const isEnhancedJsonObject: (value: EnhancedJsonValue) => value i
  * used for components).
  */
 export declare const canonicalEnhancedJsonValueKey: (value: EnhancedJsonValue) => string;
-/**
- * Lowers an {@link EnhancedJsonValue} to its runtime form.
- *
- * - `$msg` → `{ id?, message }` i18n descriptor
- * - `$eval` → `new Function('self', 'return (…)')` invoked with `self`
- *
- * Validates caps up front via {@link validateEnhancedJsonValueCaps}; any
- * disallowed marker produces a parse diagnostic via `ctx.error(...)` and
- * causes this function to return `undefined`. Non-marker values recurse
- * (arrays, objects) or pass through (primitives).
- *
- * Note: a successful resolution may also return `undefined` legitimately
- * (e.g. `$eval: 'self.missing'` evaluates to `undefined`). Callers that need
- * to distinguish "capability violation" from "value is undefined" should
- * check `ctx.hasErrors` after the call.
- */
-export declare const resolveEnhancedJsonValue: (value: EnhancedJsonValue, self: SelfAccessor | undefined, caps: EnhancedJsonValueCaps, ctx: ParseContext) => unknown | undefined;
-/**
- * Serializes an {@link EnhancedJsonValue} to a TypeScript literal, lowering
- * markers:
- *
- * - `$msg` → `` msg`…` `` (or `msg({ id, message })` with `$msgId`); registers
- *   `msg` from `@lingui/core/macro` via the supplied {@link ImportSink}.
- * - `$eval` → the code verbatim. Callers are responsible for deciding whether
- *   the emitted code belongs in a self-scoped wrapper.
- *
- * Validates caps up front; on any violation, emits a parse diagnostic via
- * `ctx.error(...)` and returns `undefined`.
- */
-export declare const stringifyEnhancedJsonValue: (value: EnhancedJsonValue, imports: ImportSink, caps: EnhancedJsonValueCaps, ctx: ParseContext) => string | undefined;
-/**
- * Derives an `EnhancedJsonSchemaType` that describes the runtime shape of an
- * {@link EnhancedJsonValue}. Used by `UserExpressions()` to synthesise an
- * expression schema from a YAML value without leaking codegen-output paths
- * into the spec layer.
- *
- * Primitives become `{ type }`. Arrays become JSON-Schema tuples. Objects
- * become `{ type: 'object', properties, required, additionalProperties: false }`.
- *
- * Marker-aware branches:
- * - `$msg` (with or without `$msgId`) → `{ $ref: 'phx:MessageDescriptor' }`, a ref to the
- *   phoenix definition that codegen resolves to the `MessageDescriptor` type emitted via `msg\`…\``.
- * - `$eval` → when the code references `self`, returns `{}` (intentional
- *   "no static info" fallback — the value depends on runtime state).
- *   Otherwise the injected SWC parser and static folder infer literals,
- *   constant operators, and deterministic `Math` expressions without executing
- *   authored code. Anything else emits
- *   `ENHANCED_JSON_VALUE_EVAL_NOT_STATICALLY_INFERABLE` and returns `undefined`.
- *
- * `$importRef` is intentionally unsupported at the value level; an object
- * with that shape serializes structurally.
- */
-export declare const schemaFromValue: (value: InferableValue, ctx: ParseContext, parseEvalExpression: EvalExpressionParser) => EnhancedJsonSchemaType | undefined;
-/**
- * Walks raw spec content and reports every legacy `$codeRef: { code: … }` block.
- *
- * That shape was documented as an inline static-math escape hatch but no parser stage ever
- * evaluated it: it validates as an ordinary nested object and serializes verbatim, so a spec using
- * it silently ships `{ "$codeRef": { "code": "4 * 25.4" } }` where the author expected a number.
- * `$eval` now covers the use case, so the shape is rejected outright rather than left inert.
- *
- * Only the object form is reported. `{ $codeRef: <string> }` is a live internal codegen shape for
- * SDK factory params (see `SdkCodeRef`), produced by the parser itself and never authored in YAML.
- */
-export declare const validateNoLegacyCodeRef: (value: unknown, ctx: ParseContext) => void;

package/dist/application-spec/core/enhanced-json-value.js

@@ -1 +1 @@
-import{z as e}from"zod";import{DiagnosticCode as r,diagnosticMessages as t}from"../errors/index.js";import{PHX_SHORT_PREFIX as o}from"./enhanced-json-schema.js";import{evalCodeUsesSelf as n}from"./eval-code-uses-self.js";import{evalToConstant as a}from"./eval-to-constant.js";import{evalMarkerSchema as i,isEvalMarker as l}from"./markers/eval-marker.js";import{createMessageDescriptor as s,isMsgMarker as f,msgMarkerSchema as c,stringifyMsgMacroCode as u}from"./markers/msg-marker.js";let E=e.object({$importRef:e.object({module:e.string(),member:e.string()}).strict()}).strict();export const isImportRefShaped=e=>E.safeParse(e).success;export const enhancedJsonValueSchema=e.lazy(()=>e.union([e.string(),e.number(),e.boolean(),e.null(),c,i,e.array(enhancedJsonValueSchema),e.record(e.string(),enhancedJsonValueSchema)]));export const CONSTANT_CAPS={selfScoped:!1,localizable:!0};export const isEnhancedJsonObject=e=>"object"==typeof e&&null!==e&&!Array.isArray(e)&&!f(e)&&!l(e);export const canonicalEnhancedJsonValueKey=e=>{let r=e=>{if(null===e||"object"!=typeof e)return e;if(Array.isArray(e))return e.map(r);let t={};for(let o of Object.keys(e).sort())t[o]=r(e[o]);return t};return JSON.stringify(r(e))};let _=(e,o,n)=>{if(f(e))return!!o.localizable||(n.error(r.ENHANCED_JSON_VALUE_MSG_NOT_ALLOWED,t[r.ENHANCED_JSON_VALUE_MSG_NOT_ALLOWED]()),!1);if(l(e))return!!o.selfScoped||(n.error(r.ENHANCED_JSON_VALUE_EVAL_NOT_ALLOWED,t[r.ENHANCED_JSON_VALUE_EVAL_NOT_ALLOWED]()),!1);if(null===e||"object"!=typeof e)return!0;if(Array.isArray(e)){let r=!0;for(let[t,a]of e.entries())_(a,o,n.at(String(t)))||(r=!1);return r}let a=!0;for(let[r,t]of Object.entries(e))_(t,o,n.at(r))||(a=!1);return a},p=(e,r)=>{if(null===e||"object"!=typeof e)return e;if(f(e))return s(e);if(l(e))return Function("self",`return (${e.$eval})`)(r??{});if(Array.isArray(e))return e.map(e=>p(e,r));let t={};for(let[o,n]of Object.entries(e))t[o]=p(n,r);return t};export const resolveEnhancedJsonValue=(e,r,t,o)=>{if(_(e,t,o))return p(e,r)};let m="__ENHANCED_JSON_VALUE_PLACEHOLDER__",A=RegExp(`"${m}(\\d+)"`,"g");export const stringifyEnhancedJsonValue=(e,r,t,o)=>{if(!_(e,t,o))return;let n=[],a=e=>(n.push(e),`${m}${n.length-1}`);return JSON.stringify(e,(e,t)=>f(t)?(r.addImport("@lingui/core/macro","msg"),a(u(t))):l(t)?a(t.$eval):t,2).replaceAll(A,(e,r)=>{let t=n[Number(r)];if(void 0===t)throw Error(`stringifyEnhancedJsonValue: missing replacement for placeholder index ${r}. This is a logic bug in the serialiser — replacements array shorter than referenced index.`);return t})};export const schemaFromValue=(e,i,s)=>{if(f(e))return{$ref:`${o}MessageDescriptor`};if(l(e)){if(n(e.$eval))return{};let o=a(e.$eval,s);return o.ok?schemaFromValue(o.value,i,s):void i.error(r.ENHANCED_JSON_VALUE_EVAL_NOT_STATICALLY_INFERABLE,t[r.ENHANCED_JSON_VALUE_EVAL_NOT_STATICALLY_INFERABLE](e.$eval))}if(null===e)return{type:"null"};if("string"==typeof e)return{type:"string"};if("number"==typeof e)return{type:"number"};if("boolean"==typeof e)return{type:"boolean"};if(Array.isArray(e)){let r=[];for(let[t,o]of e.entries()){let e=schemaFromValue(o,i.at(String(t)),s);if(void 0===e)return;r.push(e)}return{type:"array",items:r}}if("object"==typeof e){let r=Object.entries(e),t={};for(let[e,o]of r){let r=schemaFromValue(o,i.at(e),s);if(void 0===r)return;t[e]=r}return{type:"object",properties:t,required:r.map(([e])=>e),additionalProperties:!1}}return{}};export const validateNoLegacyCodeRef=(e,o)=>{if(null!==e&&"object"==typeof e){if(Array.isArray(e))return void e.forEach((e,r)=>validateNoLegacyCodeRef(e,o.at(String(r))));for(let[n,a]of Object.entries(e)){if("$codeRef"===n&&null!==a&&"object"==typeof a&&"code"in a){o.at(n).error(r.ENHANCED_JSON_VALUE_CODE_REF_NOT_SUPPORTED,t[r.ENHANCED_JSON_VALUE_CODE_REF_NOT_SUPPORTED]());continue}validateNoLegacyCodeRef(a,o.at(n))}}};
+import{z as e}from"zod";import{evalMarkerSchema as r,isEvalMarker as o}from"./markers/eval-marker.js";import{isMsgMarker as t,msgMarkerSchema as n}from"./markers/msg-marker.js";let s=e.object({$importRef:e.object({module:e.string(),member:e.string()}).strict()}).strict();export const isImportRefShaped=e=>s.safeParse(e).success;export const enhancedJsonValueSchema=e.lazy(()=>e.union([e.string(),e.number(),e.boolean(),e.null(),n,r,e.array(enhancedJsonValueSchema),e.record(e.string(),enhancedJsonValueSchema)]));export const CONSTANT_CAPS={selfScoped:!1,localizable:!0};export const isEnhancedJsonObject=e=>"object"==typeof e&&null!==e&&!Array.isArray(e)&&!t(e)&&!o(e);export const canonicalEnhancedJsonValueKey=e=>{let r=e=>{if(null===e||"object"!=typeof e)return e;if(Array.isArray(e))return e.map(r);let o={};for(let t of Object.keys(e).sort())o[t]=r(e[t]);return o};return JSON.stringify(r(e))};

package/dist/application-spec/core/expressions/index.d.ts

@@ -0,0 +1,2 @@
+export type * from './relation-expression-params.js';
+export * from './sdk-expression-implementation.js';

package/dist/application-spec/core/expressions/index.js

@@ -0,0 +1 @@
+export*from"./sdk-expression-implementation.js";

package/dist/application-spec/core/expressions/relation-expression-params.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The relation factory's single positional param: the relation's kind, the entity type or alias it
+ * points to and its cardinality, plus the id field for `direct` and `indirect` relations. The
+ * assistant schema reads `target` and `cardinality` to type a relation edge.
+ */
+export interface RelationExpressionParams {
+    readonly kind: 'direct' | 'indirect' | 'allOfType';
+    readonly target: string;
+    readonly cardinality: '0-1' | '1-1' | '0-N' | '1-N';
+    readonly field?: string;
+}

package/dist/application-spec/core/expressions/relation-expression-params.js

@@ -0,0 +1 @@
+export{};

package/dist/application-spec/core/expressions/sdk-expression-implementation.d.ts

@@ -0,0 +1,24 @@
+import type { RelationExpressionParams } from './relation-expression-params.js';
+/**
+ * An expression implementation built by an SDK factory at runtime. The kind is the
+ * semantic source of the expression, declared by the section that generated it —
+ * codegen and runtime dispatch on it instead of inspecting factory-function names.
+ * - `relation`: generated from a `relations:` declaration
+ * - `violations`: generated from `invariants:` declarations (the `$violations` expression)
+ */
+export type SdkExpressionImplementation = {
+    readonly kind: 'relation';
+    readonly params: readonly [RelationExpressionParams];
+} | {
+    readonly kind: 'violations';
+    readonly params: readonly unknown[];
+};
+/**
+ * Narrows to implementations that are built by an SDK expression factory at runtime. It checks
+ * `kind` only, so it narrows to the members of the caller's own type that are SDK implementations,
+ * such as those of the parser's `ExpressionImplementation`, and never adds the `params` a value
+ * of another type does not have.
+ */
+export declare const isSdkExpressionImplementation: <IMPLEMENTATION extends {
+    readonly kind: string;
+}>(implementation: IMPLEMENTATION) => implementation is Extract<IMPLEMENTATION, SdkExpressionImplementation>;

package/dist/application-spec/core/expressions/sdk-expression-implementation.js

@@ -0,0 +1 @@
+export const isSdkExpressionImplementation=i=>"relation"===i.kind||"violations"===i.kind;

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

@@ -1,4 +1,6 @@
 export * from './application-file.js';
+export * from './components/index.js';
+export * from './expressions/index.js';
 export * from './specification-files.js';
 export * from './application-instance.js';
 export * from './spec-diagnostic.js';

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

@@ -1 +1 @@
-export*from"./application-file.js";export*from"./specification-files.js";export*from"./application-instance.js";export*from"./spec-diagnostic.js";export*from"./enhanced-json-schema.js";export*from"./enhanced-json-value.js";export*from"./eval-expression-parser.js";export*from"./json-schema.js";export*from"./json-value.js";export*from"./markers/index.js";export*from"./phoenix-definitions.js";export*from"./project-path.js";
+export*from"./application-file.js";export*from"./components/index.js";export*from"./expressions/index.js";export*from"./specification-files.js";export*from"./application-instance.js";export*from"./spec-diagnostic.js";export*from"./enhanced-json-schema.js";export*from"./enhanced-json-value.js";export*from"./eval-expression-parser.js";export*from"./json-schema.js";export*from"./json-value.js";export*from"./markers/index.js";export*from"./phoenix-definitions.js";export*from"./project-path.js";

package/dist/application-spec/core/json-value.d.ts

@@ -2,7 +2,7 @@ import { z } from 'zod';
 /**
  * A plain JSON-serialisable value — no Phoenix markers, no functions, no
  * symbols. Output shape of `$codeRef` evaluation and of
- * {@link ./enhanced-json-value.ts} `resolveEnhancedJsonValue`. Pure subset of
+ * {@link ../enhanced-json/resolve-enhanced-json-value.ts} `resolveEnhancedJsonValue`. Pure subset of
  * `EnhancedJsonValue`.
  */
 export type JsonValue = string | number | boolean | null | JsonArray | JsonObject;

package/dist/application-spec/{core → enhanced-json}/eval-to-constant.d.ts

@@ -1,4 +1,4 @@
-import type { EvalExpressionParser } from './eval-expression-parser.js';
+import type { EvalExpressionParser } from '../core/index.js';
 type FoldedValue = string | number | boolean | null | undefined | readonly FoldedValue[] | {
     readonly [key: string]: FoldedValue;
 };

package/dist/application-spec/enhanced-json/index.d.ts

@@ -0,0 +1,4 @@
+export { resolveEnhancedJsonValue } from './resolve-enhanced-json-value.js';
+export { schemaFromValue } from './schema-from-value.js';
+export { stringifyEnhancedJsonValue } from './stringify-enhanced-json-value.js';
+export { validateNoLegacyCodeRef } from './validate-no-legacy-code-ref.js';

package/dist/application-spec/enhanced-json/index.js

@@ -0,0 +1 @@
+export{resolveEnhancedJsonValue}from"./resolve-enhanced-json-value.js";export{schemaFromValue}from"./schema-from-value.js";export{stringifyEnhancedJsonValue}from"./stringify-enhanced-json-value.js";export{validateNoLegacyCodeRef}from"./validate-no-legacy-code-ref.js";

package/dist/application-spec/enhanced-json/is-enhanced-json-array.d.ts

@@ -0,0 +1,2 @@
+import type { EnhancedJsonArray, EnhancedJsonValue } from '../core/index.js';
+export declare const isEnhancedJsonArray: (value: EnhancedJsonValue) => value is EnhancedJsonArray;

package/dist/application-spec/enhanced-json/is-enhanced-json-array.js

@@ -0,0 +1 @@
+export const isEnhancedJsonArray=r=>Array.isArray(r);

package/dist/application-spec/enhanced-json/resolve-enhanced-json-value.d.ts

@@ -0,0 +1,18 @@
+import { type EnhancedJsonValue, type EnhancedJsonValueCaps, type ParseContext, type SelfAccessor } from '../core/index.js';
+/**
+ * Lowers an {@link EnhancedJsonValue} to its runtime form.
+ *
+ * - `$msg` → `{ id?, message }` i18n descriptor
+ * - `$eval` → `new Function('self', 'return (…)')` invoked with `self`
+ *
+ * Validates caps up front via {@link validateEnhancedJsonValueCaps}; any
+ * disallowed marker produces a parse diagnostic via `ctx.error(...)` and
+ * causes this function to return `undefined`. Non-marker values recurse
+ * (arrays, objects) or pass through (primitives).
+ *
+ * Note: a successful resolution may also return `undefined` legitimately
+ * (e.g. `$eval: 'self.missing'` evaluates to `undefined`). Callers that need
+ * to distinguish "capability violation" from "value is undefined" should
+ * check `ctx.hasErrors` after the call.
+ */
+export declare const resolveEnhancedJsonValue: (value: EnhancedJsonValue, self: SelfAccessor | undefined, caps: EnhancedJsonValueCaps, ctx: ParseContext) => unknown | undefined;

package/dist/application-spec/enhanced-json/resolve-enhanced-json-value.js

@@ -0,0 +1 @@
+import{createMessageDescriptor as e,isEvalMarker as r,isMsgMarker as n}from"../core/index.js";import{isEnhancedJsonArray as t}from"./is-enhanced-json-array.js";import{validateEnhancedJsonValueCaps as o}from"./validate-enhanced-json-value-caps.js";let i=(o,a)=>{if(null===o||"object"!=typeof o)return o;if(n(o))return e(o);if(r(o))return Function("self",`return (${o.$eval})`)(a??{});if(t(o))return o.map(e=>i(e,a));let f={};for(let[e,r]of Object.entries(o))f[e]=i(r,a);return f};export const resolveEnhancedJsonValue=(e,r,n,t)=>{if(o(e,n,t))return i(e,r)};

package/dist/application-spec/enhanced-json/schema-from-value.d.ts

@@ -0,0 +1,24 @@
+import { type EnhancedJsonSchemaType, type EvalExpressionParser, type InferableValue, type ParseContext } from '../core/index.js';
+/**
+ * Derives an `EnhancedJsonSchemaType` that describes the runtime shape of an
+ * {@link EnhancedJsonValue}. Used by `UserExpressions()` to synthesise an
+ * expression schema from a YAML value without leaking codegen-output paths
+ * into the spec layer.
+ *
+ * Primitives become `{ type }`. Arrays become JSON-Schema tuples. Objects
+ * become `{ type: 'object', properties, required, additionalProperties: false }`.
+ *
+ * Marker-aware branches:
+ * - `$msg` (with or without `$msgId`) → `{ $ref: 'phx:MessageDescriptor' }`, a ref to the
+ *   phoenix definition that codegen resolves to the `MessageDescriptor` type emitted via `msg\`…\``.
+ * - `$eval` → when the code references `self`, returns `{}` (intentional
+ *   "no static info" fallback — the value depends on runtime state).
+ *   Otherwise the injected SWC parser and static folder infer literals,
+ *   constant operators, and deterministic `Math` expressions without executing
+ *   authored code. Anything else emits
+ *   `ENHANCED_JSON_VALUE_EVAL_NOT_STATICALLY_INFERABLE` and returns `undefined`.
+ *
+ * `$importRef` is intentionally unsupported at the value level; an object
+ * with that shape serializes structurally.
+ */
+export declare const schemaFromValue: (value: InferableValue, ctx: ParseContext, parseEvalExpression: EvalExpressionParser) => EnhancedJsonSchemaType | undefined;

package/dist/application-spec/enhanced-json/schema-from-value.js

@@ -0,0 +1 @@
+import{PHX_SHORT_PREFIX as e,isEvalMarker as r,isMsgMarker as t}from"../core/index.js";import{DiagnosticCode as o,diagnosticMessages as i}from"../errors/index.js";import{evalCodeUsesSelf as n}from"./eval-code-uses-self.js";import{evalToConstant as a}from"./eval-to-constant.js";export const schemaFromValue=(f,l,s)=>{if(t(f))return{$ref:`${e}MessageDescriptor`};if(r(f)){if(n(f.$eval))return{};let e=a(f.$eval,s);return e.ok?schemaFromValue(e.value,l,s):void l.error(o.ENHANCED_JSON_VALUE_EVAL_NOT_STATICALLY_INFERABLE,i[o.ENHANCED_JSON_VALUE_EVAL_NOT_STATICALLY_INFERABLE](f.$eval))}if(null===f)return{type:"null"};if("string"==typeof f)return{type:"string"};if("number"==typeof f)return{type:"number"};if("boolean"==typeof f)return{type:"boolean"};if(Array.isArray(f)){let e=[];for(let[r,t]of f.entries()){let o=schemaFromValue(t,l.at(String(r)),s);if(void 0===o)return;e.push(o)}return{type:"array",items:e}}if("object"==typeof f){let e=Object.entries(f),r={};for(let[t,o]of e){let e=schemaFromValue(o,l.at(t),s);if(void 0===e)return;r[t]=e}return{type:"object",properties:r,required:e.map(([e])=>e),additionalProperties:!1}}return{}};

package/dist/application-spec/enhanced-json/stringify-enhanced-json-value.d.ts

@@ -0,0 +1,14 @@
+import { type EnhancedJsonValue, type EnhancedJsonValueCaps, type ImportSink, type ParseContext } from '../core/index.js';
+/**
+ * Serializes an {@link EnhancedJsonValue} to a TypeScript literal, lowering
+ * markers:
+ *
+ * - `$msg` → `` msg`…` `` (or `msg({ id, message })` with `$msgId`); registers
+ *   `msg` from `@lingui/core/macro` via the supplied {@link ImportSink}.
+ * - `$eval` → the code verbatim. Callers are responsible for deciding whether
+ *   the emitted code belongs in a self-scoped wrapper.
+ *
+ * Validates caps up front; on any violation, emits a parse diagnostic via
+ * `ctx.error(...)` and returns `undefined`.
+ */
+export declare const stringifyEnhancedJsonValue: (value: EnhancedJsonValue, imports: ImportSink, caps: EnhancedJsonValueCaps, ctx: ParseContext) => string | undefined;

package/dist/application-spec/enhanced-json/stringify-enhanced-json-value.js

@@ -0,0 +1 @@
+import{isEvalMarker as e,isMsgMarker as r,stringifyMsgMacroCode as n}from"../core/index.js";import{validateEnhancedJsonValueCaps as i}from"./validate-enhanced-json-value-caps.js";let t="__ENHANCED_JSON_VALUE_PLACEHOLDER__",a=RegExp(`"${t}(\\d+)"`,"g");export const stringifyEnhancedJsonValue=(o,s,l,c)=>{if(!i(o,l,c))return;let d=[],g=e=>(d.push(e),`${t}${d.length-1}`);return JSON.stringify(o,(i,t)=>r(t)?(s.addImport("@lingui/core/macro","msg"),g(n(t))):e(t)?g(t.$eval):t,2).replaceAll(a,(e,r)=>{let n=d[Number(r)];if(void 0===n)throw Error(`stringifyEnhancedJsonValue: missing replacement for placeholder index ${r}. This is a logic bug in the serialiser — replacements array shorter than referenced index.`);return n})};

package/dist/application-spec/enhanced-json/validate-enhanced-json-value-caps.d.ts

@@ -0,0 +1,12 @@
+import { type EnhancedJsonValue, type EnhancedJsonValueCaps, type ParseContext } from '../core/index.js';
+/**
+ * Walks an {@link EnhancedJsonValue} and emits a parse diagnostic for every
+ * `$msg` / `$eval` marker that violates the supplied caps. Returns `true` if
+ * no violation was found. Each diagnostic is scoped to the offending position
+ * via `ctx.at(...)` so users see the full path (e.g. `Table.color`).
+ *
+ * Called as the first step of {@link resolveEnhancedJsonValue} and
+ * {@link stringifyEnhancedJsonValue} — once this passes, the downstream
+ * recursion is free of capability checks and never throws for user input.
+ */
+export declare const validateEnhancedJsonValueCaps: (value: EnhancedJsonValue, caps: EnhancedJsonValueCaps, ctx: ParseContext) => boolean;

package/dist/application-spec/enhanced-json/validate-enhanced-json-value-caps.js

@@ -0,0 +1 @@
+import{isEvalMarker as e,isMsgMarker as r}from"../core/index.js";import{DiagnosticCode as t,diagnosticMessages as n}from"../errors/index.js";import{isEnhancedJsonArray as o}from"./is-enhanced-json-array.js";export const validateEnhancedJsonValueCaps=(a,E,_)=>{if(r(a))return!!E.localizable||(_.error(t.ENHANCED_JSON_VALUE_MSG_NOT_ALLOWED,n[t.ENHANCED_JSON_VALUE_MSG_NOT_ALLOWED]()),!1);if(e(a))return!!E.selfScoped||(_.error(t.ENHANCED_JSON_VALUE_EVAL_NOT_ALLOWED,n[t.ENHANCED_JSON_VALUE_EVAL_NOT_ALLOWED]()),!1);if(null===a||"object"!=typeof a)return!0;if(o(a)){let e=!0;for(let[r,t]of a.entries())validateEnhancedJsonValueCaps(t,E,_.at(String(r)))||(e=!1);return e}let i=!0;for(let[e,r]of Object.entries(a))validateEnhancedJsonValueCaps(r,E,_.at(e))||(i=!1);return i};

package/dist/application-spec/enhanced-json/validate-no-legacy-code-ref.d.ts

@@ -0,0 +1,13 @@
+import type { ParseContext } from '../core/index.js';
+/**
+ * Walks raw spec content and reports every legacy `$codeRef: { code: … }` block.
+ *
+ * That shape was documented as an inline static-math escape hatch but no parser stage ever
+ * evaluated it: it validates as an ordinary nested object and serializes verbatim, so a spec using
+ * it silently ships `{ "$codeRef": { "code": "4 * 25.4" } }` where the author expected a number.
+ * `$eval` now covers the use case, so the shape is rejected outright rather than left inert.
+ *
+ * Only the object form is reported. `{ $codeRef: <string> }` is a live internal codegen shape for
+ * SDK factory params (see `SdkCodeRef`), produced by the parser itself and never authored in YAML.
+ */
+export declare const validateNoLegacyCodeRef: (value: unknown, ctx: ParseContext) => void;

package/dist/application-spec/enhanced-json/validate-no-legacy-code-ref.js

@@ -0,0 +1 @@
+import{DiagnosticCode as e,diagnosticMessages as o}from"../errors/index.js";export const validateNoLegacyCodeRef=(r,t)=>{if(null!==r&&"object"==typeof r){if(Array.isArray(r))return void r.forEach((e,o)=>validateNoLegacyCodeRef(e,t.at(String(o))));for(let[a,i]of Object.entries(r)){if("$codeRef"===a&&null!==i&&"object"==typeof i&&"code"in i){t.at(a).error(e.ENHANCED_JSON_VALUE_CODE_REF_NOT_SUPPORTED,o[e.ENHANCED_JSON_VALUE_CODE_REF_NOT_SUPPORTED]());continue}validateNoLegacyCodeRef(i,t.at(a))}}};

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

@@ -10,8 +10,9 @@
  *
  * Each group module documents the criterion that decides its membership, so a new template
  * self-classifies into exactly one of them. This module owns only the aggregate and adds no files of
- * its own: it concatenates the two application-file groups, in that order, into the `.phoenix`
- * output, and spreads the scaffolding group's project-root buckets alongside them.
+ * its own: it concatenates the two application-file groups and the scaffolding group's `.phoenix`
+ * files, in that order, into the `.phoenix` output, and spreads the scaffolding group's project-root
+ * buckets alongside them.
  *
  * Generated projects always bind phx globally, so the aggregate selects `globalPhxBindingStrategy`.
  * A module-scoped binding is only meaningful to a consumer calling the domain-runtime group on its

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

@@ -1 +1 @@
-import{GeneratedApplication as o}from"../../core/index.js";import{generateDomainRuntimeFiles as e,globalPhxBindingStrategy as i}from"./domain-runtime-files.js";import{generateProjectScaffolding as r}from"./project-scaffolding.js";import{generateStandaloneAppFiles as t}from"./standalone-app-files.js";export const generateApplicationCode=m=>o({files:[...e(m,i),...t(m)],...r(m)});
+import{GeneratedApplication as o}from"../../core/index.js";import{generateDomainRuntimeFiles as e,globalPhxBindingStrategy as r}from"./domain-runtime-files.js";import{generateProjectScaffolding as i}from"./project-scaffolding.js";import{generateStandaloneAppFiles as t}from"./standalone-app-files.js";export const generateApplicationCode=m=>{let{phoenixFiles:n,...p}=i(m);return o({files:[...e(m,r),...t(m),...n],...p})};

package/dist/application-spec/generate-application/code/project-scaffolding.d.ts

@@ -27,8 +27,9 @@ export declare const agentSkillRoots: readonly ['.claude/skills', '.agents/skill
  * The SDK version pins the generated `package.json` dependency, `cliUseWorkspace` lets an explicit
  * CLI flag override the spec's workspace mode, and the optional name and description populate the
  * project metadata. The categorized files carry the project's existing `package.json` and `.gitignore`
- * so those templates can merge rather than clobber, and the legacy cursor rules and `CLAUDE.md` so the
- * SDK block can be stripped from them.
+ * so those templates can merge rather than clobber, the legacy cursor rules and `CLAUDE.md` so the
+ * SDK block can be stripped from them, and whether the root `tsconfig.json` is the one earlier SDK
+ * versions generated, so it can be replaced.
  *
  * `projectInGitRepository` says whether the project folder is inside a git work tree. `.gitignore` is
  * generated only then: a project that is not under git has no use for the file, and one it already
@@ -46,10 +47,13 @@ export interface GenerateProjectScaffoldingOptions {
     readonly description?: string;
 }
 /**
- * Project-root file buckets produced independently from the application runtime files.
+ * Project-root file buckets produced independently from the application runtime files, and the
+ * project configuration that lives in `.phoenix/`.
  *
  * The buckets are kept apart because they carry different write intent, which the caching layer
- * acts on: `generatedProjectFiles` are content-diffed and rewritten whenever they differ,
+ * acts on: `phoenixFiles` are paths relative to `.phoenix/` and join the application files there,
+ * rewritten whenever they differ and removed with the rest of the folder's stale output;
+ * `generatedProjectFiles` are content-diffed and rewritten whenever they differ,
  * `initialProjectFiles` are written only when absent and are the project's to edit afterwards, and
  * `prettierFiles` are separated so a writer can emit the formatting configuration ahead of the
  * output it formats. `removedProjectFiles` lists project-relative paths of files earlier SDK versions
@@ -57,6 +61,7 @@ export interface GenerateProjectScaffoldingOptions {
  * into, they express that intent without implementing the write behavior themselves.
  */
 export interface GeneratedProjectScaffolding {
+    readonly phoenixFiles: readonly GeneratedApplicationFile[];
     readonly generatedProjectFiles: readonly GeneratedApplicationFile[];
     readonly initialProjectFiles: readonly GeneratedApplicationFile[];
     readonly prettierFiles: readonly GeneratedApplicationFile[];

package/dist/application-spec/generate-application/code/project-scaffolding.js

@@ -1,6 +1,6 @@
-import{GeneratedApplicationFile as e}from"../../core/index.js";import{followsCanaryBuilds as t,generateApplicationSpecEslintConfig as n,generateApplicationSpecFavicon as r,generateApplicationSpecGitignore as o,generateApplicationSpecNvmrc as i,generateApplicationSpecPackageJson as a,generateApplicationSpecPrettierConfig as c,generateApplicationSpecRobotsTxt as s,generateApplicationSpecTsconfig as l,generateApplicationSpecWebhookImplementation as p,generateLinguiRcFile as f,generatePhoenixCliSkill as m,generatePhoenixCreateConfiguratorSkill as d,generatePhoenixCreateConfiguratorSkillReferences as g,generatePhoenixFeedbackSkill as u,generatePhoenixReviewSkill as x,generatePhoenixSkill as h,generatePhoenixVariantsSkill as j,stripSdkMarkerContent as k}from"./templates/index.js";export const agentSkillRoots=[".claude/skills",".agents/skills"];let v=[{path:"CLAUDE.md",generatedPrefix:""},{path:".cursor/rules/phoenix.mdc",generatedPrefix:`---
+import{GeneratedApplicationFile as e}from"../../core/index.js";import{followsCanaryBuilds as t,generateApplicationSpecEslintConfig as n,generateApplicationSpecFavicon as i,generateApplicationSpecGitignore as r,generateApplicationSpecNvmrc as o,generateApplicationSpecPackageJson as a,generateApplicationSpecPrettierConfig as s,generateApplicationSpecRobotsTxt as c,generateApplicationSpecRootTsconfig as l,generateApplicationSpecTsconfig as p,generateLinguiRcFile as f,generatePhoenixCliSkill as m,generatePhoenixCreateConfiguratorSkill as d,generatePhoenixCreateConfiguratorSkillReferences as g,generatePhoenixFeedbackSkill as j,generatePhoenixReviewSkill as u,generatePhoenixSkill as x,generatePhoenixVariantsSkill as h,stripSdkMarkerContent as F}from"./templates/index.js";export const agentSkillRoots=[".claude/skills",".agents/skills"];let P=[{path:"CLAUDE.md",generatedPrefix:""},{path:".cursor/rules/phoenix.mdc",generatedPrefix:`---
 description: Phoenix SDK project rules
 globs:
 alwaysApply: true
 ---
-`}],b=[".claude/commands/review.md",".cursor/commands/review.md"],F=(e,t)=>e.projectFiles.find(e=>e.file.name===t)?.file.content;export const generateProjectScaffolding=P=>{let w,{applicationSpec:C,categorizedFiles:L,sdkVersion:S,projectInGitRepository:$=!0,cliUseWorkspace:y,name:M,description:A}=P,D=F(L,"package.json"),K=F(L,".gitignore"),R=void 0!==y?y:C.appMetadata.workspace,E=(t=>{let n=[],r=[...b];for(let{path:o,generatedPrefix:i}of v){let a=F(t,o);if(void 0===a)continue;let c=k(a,i);void 0===c?r.push(o):c!==a&&n.push(e(o,c,{format:!1}))}return{strippedFiles:n,removedFiles:r}})(L);return{generatedProjectFiles:[e("package.json",a({sdkVersion:S,useWorkspace:R,useClerk:C.appMetadata.useClerk??!1,name:M,description:A,existingContent:D})),e(".nvmrc",i(),{format:!1}),e(".linguirc",f(C.configurator.ui.availableLocales),{format:!1}),e("tsconfig.json",l()),e("eslint.config.js",n()),...$?[e(".gitignore",o(K))]:[],...(w=[{name:"phoenix",content:h({checkLatestCanary:t({useWorkspace:R,sdkVersion:S})}),references:[]},{name:"phoenix-cli",content:m(),references:[]},{name:"phoenix-create-configurator",content:d(),references:g()},{name:"phoenix-feedback",content:u(),references:[]},{name:"phoenix-review",content:x(),references:[]},{name:"phoenix-variants",content:j(),references:[]}],agentSkillRoots.flatMap(t=>w.flatMap(n=>[e(`${t}/${n.name}/SKILL.md`,n.content),...n.references.map(r=>e(`${t}/${n.name}/${r.path}`,r.content))]))),...E.strippedFiles],initialProjectFiles:[e("public/favicon.ico",r(),{binary:!0}),e("public/robots.txt",s(),{format:!1}),e("src/webhooks/index.ts",p())],prettierFiles:[e("prettier.config.js",c())],removedProjectFiles:E.removedFiles}};
+`}],v=[".claude/commands/review.md",".cursor/commands/review.md"],k=(e,t)=>e.projectFiles.find(e=>e.file.name===t)?.file.content;export const generateProjectScaffolding=b=>{let w,C,{applicationSpec:L,categorizedFiles:S,sdkVersion:$,projectInGitRepository:y=!0,cliUseWorkspace:M,name:A,description:D}=b,E=k(S,"package.json"),K=k(S,".gitignore"),R=void 0!==M?M:L.appMetadata.workspace,G=(t=>{let n=[],i=[...v];for(let{path:r,generatedPrefix:o}of P){let a=k(t,r);if(void 0===a)continue;let s=F(a,o);void 0===s?i.push(r):s!==a&&n.push(e(r,s,{format:!1}))}return{strippedFiles:n,removedFiles:i}})(S),I=(w=e("tsconfig.json",l()),S.hasEarlierGeneratedTsconfig?{generatedProjectFiles:[w],initialProjectFiles:[]}:{generatedProjectFiles:[],initialProjectFiles:[w]});return{phoenixFiles:[e("tsconfig.json",p())],generatedProjectFiles:[e("package.json",a({sdkVersion:$,useWorkspace:R,useClerk:L.appMetadata.useClerk??!1,name:A,description:D,existingContent:E})),e(".nvmrc",o(),{format:!1}),e(".linguirc",f(L.configurator.ui.availableLocales),{format:!1}),...I.generatedProjectFiles,e("eslint.config.js",n()),...y?[e(".gitignore",r(K))]:[],...(C=[{name:"phoenix",content:x({checkLatestCanary:t({useWorkspace:R,sdkVersion:$})}),references:[]},{name:"phoenix-cli",content:m(),references:[]},{name:"phoenix-create-configurator",content:d(),references:g()},{name:"phoenix-feedback",content:j(),references:[]},{name:"phoenix-review",content:u(),references:[]},{name:"phoenix-variants",content:h(),references:[]}],agentSkillRoots.flatMap(t=>C.flatMap(n=>[e(`${t}/${n.name}/SKILL.md`,n.content),...n.references.map(i=>e(`${t}/${n.name}/${i.path}`,i.content))]))),...G.strippedFiles],initialProjectFiles:[...I.initialProjectFiles,e("public/favicon.ico",i(),{binary:!0}),e("public/robots.txt",c(),{format:!1})],prettierFiles:[e("prettier.config.js",s())],removedProjectFiles:G.removedFiles}};

package/dist/application-spec/generate-application/code/standalone-app-files.d.ts

@@ -18,8 +18,8 @@ import type { ApplicationSpec, CategorizedFiles, RawMockTemplates } from '../../
  * The project and environment slugs address the deployed environment the embedding bootstraps talk
  * to, and `enableEditor` together with `inlineTemplates` and the raw mock templates decide whether
  * and how the optional editor entry point is emitted. The categorized files are needed only to find
- * the authored handlers that are implicitly registered or explicitly pinned into the webhook, not
- * to bind the runtime.
+ * the authored handlers that are implicitly registered or explicitly pinned into the webhook, and
+ * to read whether the project has its own webhook entry, not to bind the runtime.
  */
 export interface GenerateStandaloneAppFilesOptions {
     readonly applicationSpec: ApplicationSpec;

package/dist/application-spec/generate-application/code/standalone-app-files.js

@@ -1 +1 @@
-import{GeneratedApplicationFile as e}from"../../core/index.js";import{generateApplicationSpecAdminConfig as t,generateApplicationSpecAdminFile as a,generateApplicationSpecConfiguratorFile as o,generateApplicationSpecEditorFile as n,generateApplicationSpecEmbeddedAdmin as d,generateApplicationSpecEmbeddedConfigurator as p,generateApplicationSpecFrontendConfig as s,generateApplicationSpecHtmlAdminIndex as i,generateApplicationSpecHtmlIndex as m,generateApplicationSpecWebhookBuilders as r,generateApplicationSpecWebhookIndex as l,generateApplicationSpecWebhooksConfig as f}from"./templates/index.js";import{getWebhookHandlerFileNames as g}from"./webhook-safe-files.js";export const generateStandaloneAppFiles=b=>{let{applicationSpec:c,categorizedFiles:h,projectSlug:w,environmentSlug:x,enableEditor:M,inlineTemplates:T,rawMockTemplates:k}=b,u=k.templates,j=g(h.handlers);return[e("index.html",m(c.appMetadata.webComponentTag,M,c.appMetadata.pageTitle)),e("configurator.ts",o(c.appMetadata.webComponentTag)),e("admin.html",i(c.appMetadata.pageTitle)),e("admin.ts",a()),e("admin-config.ts",t()),e("frontend.config.ts",s(c)),e("webhooks.config.ts",f(c)),e("webhook.ts",l()),e("webhook-builders.ts",r(c,j)),e("embedded-admin.ts",d(w,x)),e("embedded-configurator.ts",p(w,x)),...M?[e("editor.tsx",n(c.appMetadata.webComponentTag,T,u,x))]:[]]};
+import{GeneratedApplicationFile as e}from"../../core/index.js";import{generateApplicationSpecAdminConfig as t,generateApplicationSpecAdminFile as a,generateApplicationSpecConfiguratorFile as o,generateApplicationSpecEditorFile as n,generateApplicationSpecEmbeddedAdmin as s,generateApplicationSpecEmbeddedConfigurator as d,generateApplicationSpecFrontendConfig as p,generateApplicationSpecHtmlAdminIndex as i,generateApplicationSpecHtmlIndex as r,generateApplicationSpecWebhookBuilders as m,generateApplicationSpecWebhookIndex as b,generateApplicationSpecWebhooksConfig as l}from"./templates/index.js";import{getWebhookHandlerFileNames as f}from"./webhook-safe-files.js";export const generateStandaloneAppFiles=g=>{let{applicationSpec:h,categorizedFiles:c,projectSlug:w,environmentSlug:k,enableEditor:x,inlineTemplates:M,rawMockTemplates:T}=g,u=T.templates,j=f(c.handlers);return[e("index.html",r(h.appMetadata.webComponentTag,x,h.appMetadata.pageTitle)),e("configurator.ts",o(h.appMetadata.webComponentTag)),e("admin.html",i(h.appMetadata.pageTitle)),e("admin.ts",a()),e("admin-config.ts",t()),e("frontend.config.ts",p(h)),e("webhooks.config.ts",l(h)),e("webhook.ts",b({hasWebhookEntry:c.hasWebhookEntry})),e("webhook-builders.ts",m(h,j)),e("embedded-admin.ts",s(w,k)),e("embedded-configurator.ts",d(w,k)),...x?[e("editor.tsx",n(h.appMetadata.webComponentTag,M,u,k))]:[]]};

package/dist/application-spec/generate-application/code/templates/configurator-config.js

@@ -1,4 +1,4 @@
-import{autoHeader as e}from"../common/file-headers.js";export const generateApplicationSpecConfiguratorConfig=(o,n)=>{let t=o.configurator.transformers,r=n?.includeDefaultEnvs===!1?"":`
+import{autoHeader as e}from"../common/file-headers.js";export const generateApplicationSpecConfiguratorConfig=(t,o)=>{let n=t.configurator.transformers,r=o?.includeDefaultEnvs===!1?"":`
   .withDefaultEnvs({
     isDev: phx.frontendEnv.IS_DEV,
     deploymentId: phx.frontendEnv.DEPLOYMENT_ID,
@@ -13,6 +13,7 @@ import{autoHeader as e}from"../common/file-headers.js";export const generateAppl
     gtmDebug: phx.frontendEnv.GTM_DEBUG,
   })`;return`${e("configurator-config.ts","Configurator config — builds the interface and wires handlers, elements, transformers, components and theme.")}
 import { getPhoenixThemes } from '@salsita-ai/sdk/ui'
+import { defaultConfiguratorElements } from '@salsita-ai/sdk/configurator'
 
 // Import order matters — each step sets globals needed by the next:
 // 1. domain.js → domain-spec.ts runs → sets phx.domain
@@ -28,9 +29,10 @@ export const configuratorConfig = configuratorBuilder
   .withComponentOptics(customComponentOptics)
   .withComponentOptics(customFrontendComponentOptics)
   .withHandlers(customHandlers)
+  .withDefaultElements(defaultConfiguratorElements)
   .withElements(customElements)
-  .withTransformers(customTransformers, ${JSON.stringify(t)})${r}
-  ${(e=>{let{theme:o}=e.configurator;return Object.keys(o.options).length>0?`.withTheme({ ...getPhoenixThemes().${o.preset}, ...${JSON.stringify(o.options)} })`:`.withTheme(getPhoenixThemes().${o.preset})`})(o)}${(e=>{let{ui:o}=e.configurator,n=[];return(void 0!==o.preview&&n.push(`preview: '${o.preview}'`),void 0!==o.alwaysExpand&&n.push(`alwaysExpand: ${o.alwaysExpand}`),void 0!==o.appLoader&&n.push(`appLoader: '${o.appLoader}'`),0===n.length)?"":`
-  .withUi({ ${n.join(", ")} })`})(o)}${!o.appMetadata.enableAdminRelease?"":`
+  .withTransformers(customTransformers, ${JSON.stringify(n)})${r}
+  ${(e=>{let{theme:t}=e.configurator;return Object.keys(t.options).length>0?`.withTheme({ ...getPhoenixThemes().${t.preset}, ...${JSON.stringify(t.options)} })`:`.withTheme(getPhoenixThemes().${t.preset})`})(t)}${(e=>{let{ui:t}=e.configurator,o=[];return(void 0!==t.preview&&o.push(`preview: '${t.preview}'`),void 0!==t.alwaysExpand&&o.push(`alwaysExpand: ${t.alwaysExpand}`),void 0!==t.appLoader&&o.push(`appLoader: '${t.appLoader}'`),0===o.length)?"":`
+  .withUi({ ${o.join(", ")} })`})(t)}${!t.appMetadata.enableAdminRelease?"":`
   .withAdminRelease(true)`}
 `};

package/dist/application-spec/generate-application/code/templates/domain-spec/generate-component-optics.js

@@ -1,8 +1,8 @@
-import{match as e}from"ts-pattern";import{isSdkCodeRef as t}from"../../../../parse-application-files/spec/index.js";import{generateMemoEvalPlanCode as i}from"./generate-memo-eval-plan-code.js";let a="@salsita-ai/sdk/domain",r={createAdminCustomPageRead:a,createAdminCustomSidebarRead:a,createAdminDataPageRead:a,createAdminDataTableSidebarRead:a,createAdminNavigationPanelRead:a,createAdminPresetCategoryPageRead:a,createAdminPresetCategorySelectionRead:a,createAdminPresetCategorySelectionWrite:a,createAdminPresetCategorySidebarRead:a,createAdminPresetListPageRead:a,createAdminPresetSidebarRead:a,createAdminRecipeCollectionPageRead:a,createAdminRecipeSidebarRead:a},n=(e,i)=>{i.addImport(r[e.sdkFunction]??a,e.sdkFunction);let n=e.params.map(e=>t(e)?e.$codeRef:"string"==typeof e?`'${e}'`:JSON.stringify(e));return`${e.sdkFunction}(${n.join(", ")})`},d=e=>0===e.length?"":e.map(e=>{if("root"===e.kind)return`.withFilter(self => (self.${e.target}))`;let t=Object.entries(e).filter(([e,t])=>"kind"!==e&&void 0!==t).map(([e,t])=>`${e}: ${"dynamic"===t.kind?`self => (self.${t.target})`:"eval"===t.kind?`self => (${t.code})`:JSON.stringify(t.value)}`);return`.withGradualFilter({ ${t.join(", ")} })`}).join(""),o=(t,i)=>e(t).with({kind:"primitive"},({assertFn:e})=>`typeof ${i} === '${"assertNumber"===e?"number":"assertBoolean"===e?"boolean":"string"}'`).with({kind:"declaredType"},({typeName:e})=>`${e}.is(${i})`).with({kind:"declaredTypeId"},({referencedType:e})=>`${e}.isId(${i})`).with({kind:"literal"},({value:e})=>`${i} === ${JSON.stringify(e)}`).with({kind:"anyOf"},({assertions:e})=>e.map(e=>`(${o(e,i)})`).join(" || ")).with({kind:"none"},()=>"true").exhaustive(),s=(t,i)=>{if(0===t.length)return"() => ({})";let r=t.map(t=>e(t.assertion).with({kind:"primitive"},({assertFn:e})=>(i.addImport(a,e),`${e}(state.${t.propKey})`)).with({kind:"declaredType"},({typeName:e})=>`${e}.assert(state.${t.propKey})`).with({kind:"declaredTypeId"},({referencedType:e})=>`${e}.assertId(state.${t.propKey})`).with({kind:"literal"},e=>{let i=o(e,`state.${t.propKey}`);return`if (!(${i})) throw new Error('Expected ${t.propKey} to match its declared schema')`}).with({kind:"anyOf"},e=>{let i=o(e,`state.${t.propKey}`);return`if (!(${i})) throw new Error('Expected ${t.propKey} to match one of its declared schemas')`}).with({kind:"none"},()=>void 0).exhaustive()).filter(e=>void 0!==e),n=t.map(e=>`${JSON.stringify(e.entityField)}: state.${e.propKey}`).join(", ");return 0===r.length?`(state) => ({ ${n} })`:`(state) => { ${r.join("; ")}; return { ${n} } }`},l="      ";export const generateComponentOpticsCode=(t,r)=>{let o=[];for(let p of t){let t=p.isAlias?"withAlias":"withEntity",m=`${p.componentName}Component`;r.addImport(a,m);let $=`    attachComponent.withComponent(${m}, '${p.instanceName}', true).${t}('${p.typeOrAlias}')`;e(p.implementation).with({kind:"userBound"},({implementation:e,filters:t,plan:a})=>{let n=d(t.items),p=`${$}${n}`,m=s("composite"===e.kind?e.writeBindings:[],r),c=i(a,r).replaceAll("\n",`
-${l}`);o.push(`${p}.attach(
+import{match as e}from"ts-pattern";import{isSdkCodeRef as t}from"../../../../core/index.js";import{generateMemoEvalPlanCode as i}from"./generate-memo-eval-plan-code.js";let a="@salsita-ai/sdk/domain",r={createAdminCustomPageRead:a,createAdminCustomSidebarRead:a,createAdminDataPageRead:a,createAdminDataTableSidebarRead:a,createAdminNavigationPanelRead:a,createAdminPresetCategoryPageRead:a,createAdminPresetCategorySelectionRead:a,createAdminPresetCategorySelectionWrite:a,createAdminPresetCategorySidebarRead:a,createAdminPresetListPageRead:a,createAdminPresetSidebarRead:a,createAdminRecipeCollectionPageRead:a,createAdminRecipeSidebarRead:a},n=(e,i)=>{i.addImport(r[e.sdkFunction]??a,e.sdkFunction);let n=e.params.map(e=>t(e)?e.$codeRef:"string"==typeof e?`'${e}'`:JSON.stringify(e));return`${e.sdkFunction}(${n.join(", ")})`},d=e=>0===e.length?"":e.map(e=>{if("root"===e.kind)return`.withFilter(self => (self.${e.target}))`;let t=Object.entries(e).filter(([e,t])=>"kind"!==e&&void 0!==t).map(([e,t])=>`${e}: ${"dynamic"===t.kind?`self => (self.${t.target})`:"eval"===t.kind?`self => (${t.code})`:JSON.stringify(t.value)}`);return`.withGradualFilter({ ${t.join(", ")} })`}).join(""),o=(t,i)=>e(t).with({kind:"primitive"},({assertFn:e})=>`typeof ${i} === '${"assertNumber"===e?"number":"assertBoolean"===e?"boolean":"string"}'`).with({kind:"declaredType"},({typeName:e})=>`${e}.is(${i})`).with({kind:"declaredTypeId"},({referencedType:e})=>`${e}.isId(${i})`).with({kind:"literal"},({value:e})=>`${i} === ${JSON.stringify(e)}`).with({kind:"anyOf"},({assertions:e})=>e.map(e=>`(${o(e,i)})`).join(" || ")).with({kind:"none"},()=>"true").exhaustive(),s=(t,i)=>{if(0===t.length)return"() => ({})";let r=t.map(t=>e(t.assertion).with({kind:"primitive"},({assertFn:e})=>(i.addImport(a,e),`${e}(state.${t.propKey})`)).with({kind:"declaredType"},({typeName:e})=>`${e}.assert(state.${t.propKey})`).with({kind:"declaredTypeId"},({referencedType:e})=>`${e}.assertId(state.${t.propKey})`).with({kind:"literal"},e=>{let i=o(e,`state.${t.propKey}`);return`if (!(${i})) throw new Error('Expected ${t.propKey} to match its declared schema')`}).with({kind:"anyOf"},e=>{let i=o(e,`state.${t.propKey}`);return`if (!(${i})) throw new Error('Expected ${t.propKey} to match one of its declared schemas')`}).with({kind:"none"},()=>void 0).exhaustive()).filter(e=>void 0!==e),n=t.map(e=>`${JSON.stringify(e.entityField)}: state.${e.propKey}`).join(", ");return 0===r.length?`(state) => ({ ${n} })`:`(state) => { ${r.join("; ")}; return { ${n} } }`},l="      ";export const generateComponentOpticsCode=(t,r)=>{let o=[];for(let m of t){let t=m.isAlias?"withAlias":"withEntity",p=`${m.componentName}Component`;r.addImport(a,p);let $=`    attachComponent.withComponent(${p}, '${m.instanceName}', true).${t}('${m.typeOrAlias}')`;e(m.implementation).with({kind:"userBound"},({implementation:e,filters:t,plan:a})=>{let n=d(t.items),m=`${$}${n}`,p=s("composite"===e.kind?e.writeBindings:[],r),c=i(a,r).replaceAll("\n",`
+${l}`);o.push(`${m}.attach(
 ${l}${c},
-${l}${m}
-    )`)}).with({kind:"sdk"},({readFactory:e,writeFactory:t})=>{let i=d(p.implementation.filters.items),a=`${$}${i}`,s=n(e,r),l=n(t,r);o.push(`${a}.attach(
+${l}${p}
+    )`)}).with({kind:"sdk"},({readFactory:e,writeFactory:t})=>{let i=d(m.implementation.filters.items),a=`${$}${i}`,s=n(e,r),l=n(t,r);o.push(`${a}.attach(
       ${s},
       ${l}
     )`)}).exhaustive()}return 0===o.length?"[] as const":`[

package/dist/application-spec/generate-application/code/templates/domain-spec/generate-defaults.js

@@ -1 +1 @@
-import{CONSTANT_CAPS as e,ParseContext as t,stringifyEnhancedJsonValue as r}from"../../../../core/index.js";export const generateDefaultsBlock=(a,n)=>{let o=new t,s=r({...a.entries},n,e,o);if(void 0===s){let e=o.errors.map(e=>`${e.code}: ${e.message}`).join("; ");throw Error(`generateDefaultsBlock: stringifyEnhancedJsonValue returned undefined. Parse-time capability validation should have caught this — caps: CONSTANT_CAPS. ${e}`)}return`const defaults = ${s} as const`};
+import{CONSTANT_CAPS as e,ParseContext as t}from"../../../../core/index.js";import{stringifyEnhancedJsonValue as n}from"../../../../enhanced-json/index.js";export const generateDefaultsBlock=(r,o)=>{let s=new t,a=n({...r.entries},o,e,s);if(void 0===a){let e=s.errors.map(e=>`${e.code}: ${e.message}`).join("; ");throw Error(`generateDefaultsBlock: stringifyEnhancedJsonValue returned undefined. Parse-time capability validation should have caught this — caps: CONSTANT_CAPS. ${e}`)}return`const defaults = ${a} as const`};

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

@@ -53,9 +53,8 @@ phoenix-api.yaml
 phoenix.config.ts
 prettier.config.js
 eslint.config.js
-tsconfig.json
 .prettierignore
 .linguirc
 public/robots.txt
 ${gitignoreEndMarker}
-`;export const generateApplicationSpecGitignore=t=>{if(!t)return e;let n=t.includes("\r\n")?"\r\n":"\n",i=t.replace(/\r?\n/g,n),r=e.replace(/\r?\n/g,n),o=i.indexOf(gitignoreStartMarker),s=i.indexOf(gitignoreEndMarker);if(-1!==o&&-1!==s&&s>o){let e=i.substring(0,o),t=i.substring(s+gitignoreEndMarker.length);return(t=t.replace(/^(?:\r?\n)+/,"")).trim().length>0?e+r+n+t:e+r}return i.trim()?r+`${n}# Custom entries${n}`+i:r};
+`;export const generateApplicationSpecGitignore=t=>{if(!t)return e;let i=t.includes("\r\n")?"\r\n":"\n",n=t.replace(/\r?\n/g,i),r=e.replace(/\r?\n/g,i),o=n.indexOf(gitignoreStartMarker),s=n.indexOf(gitignoreEndMarker);if(-1!==o&&-1!==s&&s>o){let e=n.substring(0,o),t=n.substring(s+gitignoreEndMarker.length);return(t=t.replace(/^(?:\r?\n)+/,"")).trim().length>0?e+r+i+t:e+r}return n.trim()?r+`${i}# Custom entries${i}`+n:r};

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

@@ -47,9 +47,9 @@ export { type PhoenixSkillOptions, followsCanaryBuilds, generatePhoenixSkill } f
 export { generatePhoenixVariantsSkill } from './skills/phoenix-variants-skill.js';
 export { generateApplicationSpecPrettierConfig } from './prettier-config.js';
 export { generateApplicationSpecRobotsTxt } from './robots-txt.js';
+export { generateApplicationSpecRootTsconfig } from './root-tsconfig.js';
 export { generateApplicationSpecStoryDevDeclaration, generateApplicationSpecStoryPhxModule, generateApplicationSpecStoryRawProjectFiles, generateApplicationSpecStoryWrapper, } from './story/index.js';
 export { generateApplicationSpecTsconfig } from './tsconfig.js';
 export { generateApplicationSpecWebhookBuilders } from './webhook-builders.js';
-export { generateApplicationSpecWebhookImplementation } from './webhook-implementation.js';
 export { generateApplicationSpecWebhookIndex } from './webhook-index.js';
 export { generateApplicationSpecWebhooksConfig } from './webhooks-config.js';