@salsita-ai/sdk 0.0.0-stage → 0.49.0-develop.cbee856178

package/dist/editor/state-inspector/components/ComponentTypeRow.d.ts

@@ -0,0 +1,9 @@
+import type { SystemComponentTypeConstraint } from '#package/domain';
+import type { InspectorEntityId } from '../inspector-types.js';
+export declare const ComponentTypeRow: ({ entityId, type, componentType, depth, path, }: {
+    readonly entityId: InspectorEntityId;
+    readonly type: string;
+    readonly componentType: SystemComponentTypeConstraint;
+    readonly depth: number;
+    readonly path?: string;
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/editor/state-inspector/components/ComponentTypeRow.js

@@ -0,0 +1 @@
+import{jsx as e,jsxs as t,Fragment as o}from"react/jsx-runtime";import{useExpansion as n}from"../ExpansionContext.js";import{ChevronCol as a}from"../RowParts.js";import{RowShell as m}from"../RowShell.js";import{Hl as p}from"../highlight.js";import{useRevealExpand as i,useRevealRef as r}from"../useRevealRef.js";import{ComponentInstanceRow as s}from"./ComponentInstanceRow.js";import{ComponentNote as l}from"./ComponentNote.js";import{FilteredOutComponentRow as c}from"./FilteredOutComponentRow.js";import{useComponentInstances as d}from"./useComponentData.js";let h=({entityId:t,type:n,componentType:a,depth:m,basePath:p})=>{let{instances:i,error:r}=d(t,a);return null!==r?e(l,{text:r,depth:m,error:!0}):0===i.length?e(l,{text:"no instances",depth:m}):e(o,{children:i.map(t=>t.filteredOut?e(c,{type:n,componentType:a.name,instance:t,depth:m,path:void 0===p?void 0:`${p}/${t.instanceName}`},t.instanceName):e(s,{type:n,componentType:a.name,instanceName:t.instanceName,data:t.data,depth:m,path:void 0===p?void 0:`${p}/${t.instanceName}`},t.instanceName))})};export const ComponentTypeRow=({entityId:o,type:s,componentType:l,depth:c,path:d})=>{let[f,j]=n(d,!1),x=r(d);i(d,j);let y=()=>{j(e=>!e)};return t("div",{children:[t(m,{depth:c,minHeight:19,rootRef:x,onClick:()=>{y()},children:[e(a,{expandable:!0,open:f,onToggle:y}),e("span",{style:{fontFamily:"var(--pxi-font-mono)",fontSize:11,color:"var(--pxi-val-comp)",fontWeight:500,whiteSpace:"nowrap"},children:e(p,{text:l.name})})]}),f&&e(h,{entityId:o,type:s,componentType:l,depth:c+1,basePath:d})]})};

package/dist/editor/state-inspector/components/ComponentsGroup.d.ts

@@ -0,0 +1,6 @@
+import type { InspectorEntityId } from '../inspector-types.js';
+export declare const ComponentsGroup: ({ entityId, depth, path, }: {
+    readonly entityId: InspectorEntityId;
+    readonly depth: number;
+    readonly path?: string;
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/editor/state-inspector/components/ComponentsGroup.js

@@ -0,0 +1 @@
+import{jsx as o}from"react/jsx-runtime";import{useExpansion as e}from"../ExpansionContext.js";import{InspectorGroup as n}from"../InspectorGroup.js";import{usePins as t}from"../usePins.js";import{useRevealExpand as p}from"../useRevealRef.js";import{ComponentTypeRow as m}from"./ComponentTypeRow.js";import{useAttachedComponentTypes as r}from"./useComponentData.js";export const ComponentsGroup=({entityId:s,depth:i,path:a})=>{let d=t(),[c,l]=e(void 0===a?void 0:`${a}#components`,!1),u=void 0===a?void 0:`${a}#components`;p(u,l);let f=r(s),j=s.replace(/-\d+$/,"");return o(n,{label:"Components",count:f.length,pinCount:d.componentPins(j).length,depth:i,open:c,onToggle:()=>{l(o=>!o)},children:f.map(e=>o(m,{entityId:s,type:j,componentType:e,depth:i+1,path:void 0===u?void 0:`${u}/${e.name}`},e.name))})};

package/dist/editor/state-inspector/components/FilteredOutComponentRow.d.ts

@@ -0,0 +1,9 @@
+import type { FilteredOutComponentInstanceData } from './component-data.js';
+export declare const FilteredOutComponentRow: ({ type, componentType, instance, depth, path, keyLabel, }: {
+    readonly type: string;
+    readonly componentType: string;
+    readonly instance: FilteredOutComponentInstanceData;
+    readonly depth: number;
+    readonly path?: string;
+    readonly keyLabel?: string;
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/editor/state-inspector/components/FilteredOutComponentRow.js

@@ -0,0 +1 @@
+import{jsx as e,jsxs as t,Fragment as n}from"react/jsx-runtime";import{Tooltip as o}from"@mui/material";import{PhxIcon as i}from"#package/ui-sdk";import{useExpansion as r}from"../ExpansionContext.js";import{JsonRow as a}from"../JsonRow.js";import{PinButton as l}from"../PinButton.js";import{ChevronCol as s,KeyLabel as m}from"../RowParts.js";import{RowShell as p}from"../RowShell.js";import{usePins as f}from"../usePins.js";import{useRevealExpand as c,useRevealRef as d}from"../useRevealRef.js";import{describeFilteredOut as x}from"./filtered-out.js";export const FilteredOutComponentRow=({type:h,componentType:u,instance:g,depth:j,path:v,keyLabel:y})=>{let R=f(),[k,w]=r(v,!1),C=d(v);c(v,w);let b=R.isComponentPinned(h,u,g.instanceName),S=x(g),P=()=>{w(e=>!e)},z=()=>{P()},F=t("span",{onClick:z,style:{flex:1,minWidth:0,display:"inline-flex",alignItems:"center",gap:4,overflow:"hidden",textOverflow:"ellipsis",whiteSpace:"nowrap",fontFamily:"var(--pxi-font-mono)",fontSize:11,color:"var(--pxi-ink-faint)",cursor:"pointer"},children:[e(i,{name:"EyeClosedBold",sx:{fontSize:11,flex:"none"}}),S?.offendingKey]});return t(n,{children:[t(p,{depth:j,minHeight:19,rootRef:C,gutter:e(l,{pinned:b,onToggle:()=>{R.toggleComponent(h,u,g.instanceName)},tip:b?"Unpin instance":"Pin instance",size:10}),children:[e(s,{expandable:!0,open:k,onToggle:P}),e(m,{text:y??g.instanceName,muted:!0,clickable:!0,onActivate:z}),S?e(o,{title:S.message,enterDelay:400,disableInteractive:!0,children:F}):F]}),k&&t(n,{children:[e(a,{keyLabel:"filterState",value:g.filterState,depth:j+1}),e(a,{keyLabel:"filterContext",value:g.filterContext,depth:j+1}),e(a,{keyLabel:"mismatchReasons",value:g.mismatchReasons,depth:j+1})]})]})};

package/dist/editor/state-inspector/components/MissingComponentRow.d.ts

@@ -0,0 +1,6 @@
+export declare const MissingComponentRow: ({ type, componentType, instanceName, depth, }: {
+    readonly type: string;
+    readonly componentType: string;
+    readonly instanceName: string;
+    readonly depth: number;
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/editor/state-inspector/components/MissingComponentRow.js

@@ -0,0 +1 @@
+import{jsx as t,jsxs as e}from"react/jsx-runtime";import{PinButton as o}from"../PinButton.js";import{ChevronCol as n,KeyLabel as i}from"../RowParts.js";import{RowShell as r}from"../RowShell.js";import{usePins as s}from"../usePins.js";let l=()=>{};export const MissingComponentRow=({type:p,componentType:m,instanceName:a,depth:c})=>{let f=s();return e(r,{depth:c,minHeight:19,gutter:t(o,{pinned:!0,onToggle:()=>{f.toggleComponent(p,m,a)},tip:"Unpin instance",size:10}),children:[t(n,{expandable:!1,open:!1,onToggle:l}),t(i,{text:`${m}.${a}`,clickable:!1,onActivate:l}),t("span",{style:{flex:1,minWidth:0,overflow:"hidden",textOverflow:"ellipsis",whiteSpace:"nowrap",fontSize:11,color:"var(--pxi-ink-faint)",fontStyle:"italic"},children:"No matching component"})]})};

package/dist/editor/state-inspector/components/component-data.d.ts

@@ -0,0 +1,28 @@
+import { type ComponentSystemFilterState, type FilterMismatchReason, type FilteredOutFilterContext, type SystemComponentTypeConstraint } from '#package/domain';
+import type { InspectorComponentReader, InspectorDomainState, InspectorEntityId } from '../inspector-types.js';
+/** An active instance of a component: its instance name + the raw data object stored in state. */
+export interface ActiveComponentInstanceData {
+    readonly filteredOut: false;
+    readonly instanceName: string;
+    readonly data: Record<string, unknown>;
+}
+/**
+ * An instance excluded by its component filters in the current system state. Carries no component
+ * data (the optic is never read for inactive instances) — instead it holds the filter diagnostics
+ * the row renders: the system state + session context the filters were tested against, and the
+ * evaluated per-OR-branch constraints (the last key of each reason is the condition that failed).
+ */
+export interface FilteredOutComponentInstanceData {
+    readonly filteredOut: true;
+    readonly instanceName: string;
+    readonly filterState: ComponentSystemFilterState;
+    readonly filterContext: FilteredOutFilterContext;
+    readonly mismatchReasons: readonly FilterMismatchReason[];
+}
+export type ComponentInstanceData = ActiveComponentInstanceData | FilteredOutComponentInstanceData;
+/** Resolve a persisted pin's component-type NAME back to its type, for the narrow read. */
+export declare function resolveComponentType(name: string): SystemComponentTypeConstraint | null;
+/** Instances of one component type on an entity (active AND filtered-out); empty when the type is attachable but currently carries no data. */
+export declare function readComponentInstances(componentReader: InspectorComponentReader, state: InspectorDomainState, entityId: InspectorEntityId, componentType: SystemComponentTypeConstraint): readonly ComponentInstanceData[];
+/** The spec components attachable to this entity's type, sorted by name — the group's row list. */
+export declare function attachedComponentTypes(componentReader: InspectorComponentReader, entityId: InspectorEntityId): readonly SystemComponentTypeConstraint[];

package/dist/editor/state-inspector/components/component-data.js

@@ -0,0 +1 @@
+import{availableSystemComponents as e,componentsByName as t}from"#package/domain";export function resolveComponentType(e){return t.get(e)??null}function n(e){let t=Object.entries(e),n=t.at(-1)?.[0];return Object.fromEntries(t.filter(([e,t])=>void 0!==t||e===n))}export function readComponentInstances(e,t,o,a){return e.peekManyComponents({entityIds:[o],componentTypes:[a]},t).map(e=>"filteredOut"in e?{filteredOut:!0,instanceName:e.componentInstance.instanceName,filterState:e.filterState,filterContext:e.filterContext,mismatchReasons:e.mismatchReasons.map(n)}:{filteredOut:!1,instanceName:e.componentInstance.instanceName,data:e.state})}export function attachedComponentTypes(t,n){return e.filter(e=>t.isComponentTypeAttached({entityIds:[n],componentTypes:[e]})).slice().sort((e,t)=>e.name.localeCompare(t.name))}

package/dist/editor/state-inspector/components/filtered-out.d.ts

@@ -0,0 +1,7 @@
+import type { FilteredOutComponentInstanceData } from './component-data.js';
+/** The collapsed-row summary of one filtered-out instance: which condition failed + the value comparison for its tooltip. */
+export interface FilteredOutDescription {
+    readonly offendingKey: string;
+    readonly message: string;
+}
+export declare function describeFilteredOut(instance: FilteredOutComponentInstanceData): FilteredOutDescription | null;

package/dist/editor/state-inspector/components/filtered-out.js

@@ -0,0 +1 @@
+function e(e){return(Array.isArray(e)?e:[e]).map(e=>"object"==typeof e?String(e.id):String(e))}function t(e){return`'${e}'`}function r(e,r){return`None of ${e.map(t).join(", ")} matches the current ${void 0===r?"(none)":t(r)}`}function n(e,r,n){return`${e} ${t(String(r))} doesn't match the current ${void 0===n?"(none)":t(String(n))}`}export function describeFilteredOut(i){let s=i.mismatchReasons.at(-1);if(!s)return null;let d=Object.keys(s).at(-1);if(void 0===d)return null;let{filterState:o,filterContext:a}=i;return{offendingKey:d,message:(()=>{switch(d){case"modes":return r(s.modes??[],a.mode);case"roles":return r(s.roles??[],a.role);case"navigationStates":return r(s.navigationStates??[],o.navigationState);case"viewStates":return r(s.viewStates??[],o.viewState);case"toolStates":return r(s.toolStates??[],o.toolState);case"exportStates":return r(s.exportStates??[],o.exportState);case"selectedEntityIds":return r(void 0===s.selectedEntityIds?[]:e(s.selectedEntityIds),o.selectedEntityId);case"hoveredEntityIds":return r(void 0===s.hoveredEntityIds?[]:e(s.hoveredEntityIds),o.hoveredEntityId);case"draggedEntityIds":return r(void 0===s.draggedEntityIds?[]:e(s.draggedEntityIds),o.draggedEntityId);case"exportedEntityIds":return r(void 0===s.exportedEntityIds?[]:e(s.exportedEntityIds),o.exportedEntityId);case"fullscreen":return n("fullscreen",s.fullscreen??!1,o.fullscreen);case"debug":return n("debug",s.debug??!1,o.debug);case"viewports":return r(s.viewports??[],null==o.viewports?void 0:o.viewports.join(", "));case"active":return`active evaluated to ${t(String(s.active))}`;default:return`${d} did not match`}})()}}

package/dist/editor/state-inspector/components/index.d.ts

@@ -0,0 +1,6 @@
+export { ComponentsGroup } from './ComponentsGroup.js';
+export { ComponentInstanceRow } from './ComponentInstanceRow.js';
+export { ComponentNote } from './ComponentNote.js';
+export { FilteredOutComponentRow } from './FilteredOutComponentRow.js';
+export { MissingComponentRow } from './MissingComponentRow.js';
+export { usePinnedComponents } from './useComponentData.js';

package/dist/editor/state-inspector/components/index.js

@@ -0,0 +1 @@
+export{ComponentsGroup}from"./ComponentsGroup.js";export{ComponentInstanceRow}from"./ComponentInstanceRow.js";export{ComponentNote}from"./ComponentNote.js";export{FilteredOutComponentRow}from"./FilteredOutComponentRow.js";export{MissingComponentRow}from"./MissingComponentRow.js";export{usePinnedComponents}from"./useComponentData.js";

package/dist/editor/state-inspector/components/useComponentData.d.ts

@@ -0,0 +1,21 @@
+import type { SystemComponentTypeConstraint } from '#package/domain';
+import type { InspectorEntityId } from '../inspector-types.js';
+import { type ComponentInstanceData } from './component-data.js';
+/** A pinned component instance (active or filtered out), or the same scope marked absent so the strip can show a placeholder. */
+export interface PinnedComponentInstance {
+    readonly componentType: string;
+    readonly instanceName: string;
+    /** The matched instance, or null when this pin matches nothing on the current entity/slice. */
+    readonly instance: ComponentInstanceData | null;
+}
+/** A component-type's instances, plus the read error (if the reader threw) so the row can surface it inline. */
+export interface ComponentInstancesResult {
+    readonly instances: readonly ComponentInstanceData[];
+    readonly error: string | null;
+}
+/** Component types attachable to this entity's type — the group's row list (no instance read). */
+export declare function useAttachedComponentTypes(entityId: InspectorEntityId): readonly SystemComponentTypeConstraint[];
+/** Instances of one component type on this entity (active with data + filtered-out with diagnostics), refreshed on each slice emission; never throws. */
+export declare function useComponentInstances(entityId: InspectorEntityId, componentType: SystemComponentTypeConstraint): ComponentInstancesResult;
+/** Type-pinned component instances, each narrow-read (peek, so filtered-out ones still match); absent ones kept (instance null) so the strip shows a note. */
+export declare function usePinnedComponents(entityId: InspectorEntityId, type: string): readonly PinnedComponentInstance[];

package/dist/editor/state-inspector/components/useComponentData.js

@@ -0,0 +1 @@
+import{useMemo as e}from"react";import{useEagerObservableSelector as t}from"#package/react-sdk";import{useInspector as n}from"../InspectorContext.js";import{describeError as o}from"../errors.js";import{usePins as r}from"../usePins.js";import{attachedComponentTypes as s,readComponentInstances as a,resolveComponentType as c}from"./component-data.js";export function useAttachedComponentTypes(t){let{componentReader:o}=n();return e(()=>s(o,t),[o,t])}export function useComponentInstances(e,r){let{store:s,componentReader:c,sliceName:m}=n();return t(s.stateSlices[m],t=>{try{return{instances:a(c,t.state,e,r),error:null}}catch(e){return{instances:[],error:o(e)}}},[c,e,r,m])}export function usePinnedComponents(e,o){let{store:s,componentReader:m,sliceName:p}=n(),i=r().componentPins(o),u=i.map(e=>`${e.componentType}/${e.instanceName}`).join("|");return t(s.stateSlices[p],t=>i.map(n=>{let o,r=c(n.componentType);try{o=r?a(m,t.state,e,r).find(e=>e.instanceName===n.instanceName):void 0}catch{o=void 0}return{componentType:n.componentType,instanceName:n.instanceName,instance:o??null}}),[m,e,p,u])}

package/dist/editor/state-inspector/constants.d.ts

@@ -0,0 +1,6 @@
+/** px per tree depth level (indent rail step). */
+export declare const INDENT = 14;
+/** width of the left gutter column that hosts the pin star. */
+export declare const GUTTER = 18;
+/** width of the reserved chevron column, so scalar rows align with expandable ones. */
+export declare const CHEVRON = 12;

package/dist/editor/state-inspector/constants.js

@@ -0,0 +1 @@
+export const INDENT=14;export const GUTTER=18;export const CHEVRON=12;

package/dist/editor/state-inspector/copy.d.ts

@@ -0,0 +1,20 @@
+/** Stable clipboard string for a value: entity-ref → id, Date → local datetime, Map/Set → JSON, objects → JSON, scalars → raw. */
+export declare function copyTextFor(value: unknown): string;
+/** Copy an explicit string to the clipboard, log an explicit value, and flash — the primitive both helpers build on. */
+export declare function copyTextWithFlash(text: string, logValue: unknown, ev?: {
+    readonly clientX: number;
+    readonly clientY: number;
+}): void;
+/** Transient error toast at the cursor — same affordance as the copy flash, fatal-red. */
+export declare function errorFlash(text: string, ev?: {
+    readonly clientX: number;
+    readonly clientY: number;
+}): void;
+/**
+ * Copy `value` (stringified via {@link copyTextFor}) to the clipboard and log it.
+ * @param logValue overrides what gets logged (e.g. copy the id, log the entity).
+ */
+export declare function copyWithFlash(value: unknown, ev?: {
+    readonly clientX: number;
+    readonly clientY: number;
+}, logValue?: unknown): void;

package/dist/editor/state-inspector/copy.js

@@ -0,0 +1 @@
+import{formatLocalDateTime as t,mapToDisplayObject as e,setToArray as i}from"./detect.js";export function copyTextFor(n){if(null==n)return String(n);if("string"==typeof n)return n;if(n instanceof Date)return t(n);if(n instanceof Map)return JSON.stringify(e(n));if(n instanceof Set)return JSON.stringify(i(n));if("object"==typeof n){if(void 0!==n._raw&&"string"==typeof n.id)return n.id;try{return JSON.stringify(n)}catch{}}return String(n)}function n(t,e,i,n){if("u"<typeof document)return;let o=document.createElement("div");o.textContent=i,o.style.cssText=`position:fixed;z-index:9999;pointer-events:none;background:${n};color:#fff;font-family:'Inter',system-ui,sans-serif;font-size:10px;font-weight:600;padding:3px 7px;border-radius:3px;box-shadow:0 2px 8px rgba(20,18,15,0.18);left:${t+10}px;top:${e-8}px;opacity:0;transition:opacity .12s ease, transform .6s ease`,document.body.appendChild(o),requestAnimationFrame(()=>{o.style.opacity="1",o.style.transform="translateY(-22px)"}),window.setTimeout(()=>{o.style.opacity="0"},700),window.setTimeout(()=>{o.remove()},950)}export function copyTextWithFlash(t,e,i){try{navigator.clipboard?.writeText(t)}catch{}console.log(e),n(i?.clientX??window.innerWidth/2,i?.clientY??window.innerHeight/2,"✓ Copied + logged","#e25a2c")}export function errorFlash(t,e){n(e?.clientX??window.innerWidth/2,e?.clientY??window.innerHeight/2,`✗ ${t}`,"#c2410c")}export function copyWithFlash(t,e,i){copyTextWithFlash(copyTextFor(t),void 0!==i?i:t,e)}

package/dist/editor/state-inspector/detect.d.ts

@@ -0,0 +1,35 @@
+import type { MessageDescriptor } from '@lingui/core';
+import type { MultilingualString } from '@salsita-ai/common/utils';
+import type { $InspectorEntity } from './inspector-types.js';
+/** React elements and portals are opaque UI values, not inspector data. */
+export declare function isReactNode(value: unknown): boolean;
+/** A runtime entity reference: an enhanced `$Entity` (uniquely carries `_raw`). */
+export declare function isEntityRef(value: unknown): value is $InspectorEntity;
+/** A Lingui message descriptor: `{ id, message, values? }` (not an entity, not multilingual). */
+export declare function isMessageDescriptor(value: unknown): value is MessageDescriptor;
+/** A Phoenix multilingual string: `{ $lang: { en: '…', de: '…' } }`. */
+export declare function isMultilingualString(value: unknown): value is MultilingualString;
+/** Default (untranslated) preview text for a message descriptor. */
+export declare function messagePreview(md: MessageDescriptor): string;
+export interface MultilingualPreview {
+    readonly primary: string;
+    readonly text: string;
+    readonly otherCount: number;
+}
+/** Primary-locale preview (English first, else first key) for a multilingual string. */
+export declare function multilingualPreview(mls: MultilingualString): MultilingualPreview;
+export type ValueKind = 'string' | 'number' | 'boolean' | 'nullish' | 'function' | 'symbol' | 'bigint' | 'date' | 'map' | 'set' | 'entity-ref' | 'message' | 'multilingual' | 'array' | 'object' | 'react-node';
+/** Bucket a real JS value for rendering + click semantics. */
+export declare function classifyValue(value: unknown): ValueKind;
+/** Local date-time, no timezone info: `2026-05-26 13:45:30`. */
+export declare function formatLocalDateTime(date: Date): string;
+/** A Map rendered/expanded as a plain object (keys stringified for display). */
+export declare function mapToDisplayObject(map: Map<unknown, unknown>): Record<string, unknown>;
+/** A Set rendered/expanded as an array. */
+export declare function setToArray(set: Set<unknown>): unknown[];
+/**
+ * Whether a value usefully expands inline (objects/arrays/maps/sets/special
+ * shapes with content). Entity refs deliberately don't: their pill navigates to
+ * the entity's node in the composition tree instead of unfolding it in place.
+ */
+export declare function isExpandable(value: unknown): boolean;

package/dist/editor/state-inspector/detect.js

@@ -0,0 +1 @@
+function t(t){return"object"==typeof t&&null!==t}export function isReactNode(e){return t(e)&&(e.$$typeof===Symbol.for("react.element")||e.$$typeof===Symbol.for("react.transitional.element")||e.$$typeof===Symbol.for("react.portal"))}export function isEntityRef(e){return t(e)&&"_raw"in e&&"string"==typeof e.id&&"string"==typeof e.type}export function isMessageDescriptor(e){return t(e)&&!isEntityRef(e)&&!("$lang"in e)&&"string"==typeof e.id&&"string"==typeof e.message}export function isMultilingualString(e){return t(e)&&t(e.$lang)}export function messagePreview(t){return t.message??t.id}export function multilingualPreview(t){let e=Object.keys(t.$lang),n=void 0!==t.$lang.en?"en":e[0]??"";return{primary:n,text:t.$lang[n]??"",otherCount:Math.max(0,e.length-1)}}export function classifyValue(t){if(isReactNode(t))return"react-node";if(null==t)return"nullish";if(isEntityRef(t))return"entity-ref";if(isMultilingualString(t))return"multilingual";if(isMessageDescriptor(t))return"message";if(t instanceof Date)return"date";if(t instanceof Map)return"map";if(t instanceof Set)return"set";if(Array.isArray(t))return"array";let e=typeof t;return"string"===e?"string":"number"===e?"number":"boolean"===e?"boolean":"bigint"===e?"bigint":"symbol"===e?"symbol":"function"===e?"function":"object"}export function formatLocalDateTime(t){let e=t=>String(t).padStart(2,"0");return`${t.getFullYear()}-${e(t.getMonth()+1)}-${e(t.getDate())} ${e(t.getHours())}:${e(t.getMinutes())}:${e(t.getSeconds())}`}export function mapToDisplayObject(t){let e={};for(let[n,r]of t)e[String(n)]=r;return e}export function setToArray(t){return[...t]}export function isExpandable(t){let e=classifyValue(t);return"message"===e||"multilingual"===e||("array"===e?t.length>0:"map"===e||"set"===e?t.size>0:"object"===e&&Object.keys(t).length>0)}

package/dist/editor/state-inspector/distance.d.ts

@@ -0,0 +1,5 @@
+import { type DimensionUnit } from '#package/domain';
+/** A millimetre length converted to `unit` and trimmed (no unit suffix). */
+export declare function lengthToUnit(mm: number, unit: DimensionUnit): string;
+/** A millimetre length as a labelled scalar: `420 mm` / `0.42 m`. */
+export declare function formatDistance(mm: number, unit: DimensionUnit): string;

package/dist/editor/state-inspector/distance.js

@@ -0,0 +1 @@
+import{defaultDistanceToUnit as t}from"#package/domain";export function lengthToUnit(n,o){let e;return(.005>Math.abs(e=Number(t(n,o).toFixed(2)))?0:e).toString()}export function formatDistance(t,n){return`${lengthToUnit(t,n)} ${n}`}

package/dist/editor/state-inspector/entity-updates.d.ts

@@ -0,0 +1,8 @@
+import type { InspectorEntityId, InspectorUpdate } from './inspector-types.js';
+/** `updateTag` for an inspector field edit, distinct from natural product updates. */
+export declare const InspectorEditFieldTag = "stateInspector.editField";
+/** `updateTag` for an inspector entity deletion. */
+export declare const InspectorDeleteTag = "stateInspector.deleteEntity";
+export declare function buildFieldModification(entityId: InspectorEntityId, name: string, value: unknown): InspectorUpdate;
+export declare function buildEntityDeletion(entityId: InspectorEntityId): InspectorUpdate;
+export declare function useApplyUpdates(): (updates: readonly InspectorUpdate[]) => void;

package/dist/editor/state-inspector/entity-updates.js

@@ -0,0 +1 @@
+import{useCallback as t}from"react";import{systemUpdateFactory as e}from"#package/domain";import{useInspector as o}from"./InspectorContext.js";export const InspectorEditFieldTag="stateInspector.editField";export const InspectorDeleteTag="stateInspector.deleteEntity";export function buildFieldModification(t,o,n){return e.DomainEntityModification({entityId:t,updateTag:"stateInspector.editField",stateDelta:{[o]:n}})}export function buildEntityDeletion(t){return e.EntityDeletion({entityId:t,updateTag:"stateInspector.deleteEntity"})}export function useApplyUpdates(){let{store:e,sliceName:n}=o();return t(t=>{"rendered"===n?e.stage(t):e.stageAndCommit(t)},[e,n])}

package/dist/editor/state-inspector/errors.d.ts

@@ -0,0 +1 @@
+export declare function describeError(error: unknown): string;

package/dist/editor/state-inspector/errors.js

@@ -0,0 +1 @@
+export function describeError(r){return r instanceof Error?r.message:String(r)}

package/dist/editor/state-inspector/evaluate-watch.d.ts

@@ -0,0 +1,7 @@
+import type { $InspectorEntity } from './inspector-types.js';
+/** The outcome of evaluating one watch: a value, or the thrown error (never both). */
+export interface WatchResult {
+    readonly value: unknown;
+    readonly error: unknown;
+}
+export declare function evaluateWatch(expr: string, self: $InspectorEntity): WatchResult;

package/dist/editor/state-inspector/evaluate-watch.js

@@ -0,0 +1 @@
+export function evaluateWatch(r,e){if(""===r.trim())return{value:void 0,error:null};try{return{value:Function("self",`return (${r})`)(e),error:null}}catch(r){return{value:void 0,error:r}}}

package/dist/editor/state-inspector/filter-index.d.ts

@@ -0,0 +1,13 @@
+import type { FilterCategory, SearchCorpus, SearchResult } from './filter-types.js';
+import type { InspectorComponentReader, InspectorCompositionProjections, InspectorDomain, InspectorStateEmission } from './inspector-types.js';
+interface CorpusParams {
+    readonly searchValues: boolean;
+    readonly domain: InspectorDomain;
+    readonly composition: InspectorCompositionProjections;
+    readonly componentReader: InspectorComponentReader;
+    readonly emission: InspectorStateEmission;
+    readonly categories: Readonly<Record<FilterCategory, boolean>>;
+}
+export declare function buildSearchCorpus(params: CorpusParams, signal: AbortSignal, onProgress: (corpus: SearchCorpus) => void): Promise<SearchCorpus>;
+export declare function searchResults(corpus: SearchCorpus, rawQuery: string, signal: AbortSignal): Promise<readonly SearchResult[]>;
+export {};

package/dist/editor/state-inspector/filter-index.js

@@ -0,0 +1 @@
+import{attachedComponentTypes as e,readComponentInstances as t}from"./components/component-data.js";import{readSceneHierarchy as o}from"./scene/scene-components.js";import{sceneGroupPath as a,sceneObjectPath as n}from"./scene/scene-path.js";import{objectSearchText as r}from"./scene/scene-search.js";import{searchValues as i}from"./search-values.js";import{groupViolations as s}from"./violations/violation-data.js";function c(e){let t=performance.now()+6,o=0;return (a=!1)=>{if((a||++o%32==0)&&(e.throwIfAborted(),!(performance.now()<t)))return new Promise(e=>setTimeout(e,0)).then(()=>{e.throwIfAborted(),t=performance.now()+6})}}async function l(l,f,m){await new Promise(e=>setTimeout(e,0)),f.throwIfAborted();let p=c(f),d=l.composition.getTree(l.emission.state),y=s(l.emission.validity).byEntity,h=[],u=new Map,g=new Set,w=[{id:d.root.id,path:String(d.root.id)}],$=0,v=0,b=0,x=0,j="",I=performance.now()+120,N=e=>({entries:h.slice(),completed:$,visitedValues:v,total:d.map.size,skipped:x,truncated:b,complete:e,activity:j});for(;w.length>0;){f.throwIfAborted();let s=w.pop();if(!s||g.has(s.id))continue;let{id:c,path:A}=s;g.add(c);let k=d.map.get(c)?.nodes.map(e=>e.node.id)??[];for(let e=k.length-1;e>=0;e--){let t=k[e];t&&w.push({id:t,path:`${A}#children/${t}`})}try{for(let s of function*(){for(let s of(yield*function*(s,c,l,f){let{domain:m,componentReader:p,emission:d,categories:y}=s,h=d.state;for(let d of(yield{category:"entity",name:c,path:l,values:()=>[]},[{category:"fields",rows:function*(){let e=m.getEntity(c,h);if(e){for(let t of Object.keys(e))if("id"!==t&&"type"!==t){let o=`${l}#fields/${t}`;yield{category:"fields",name:t,path:o,values:()=>i(Reflect.get(e,t),"")}}}}},{category:"expressions",rows:function*(){let e=m.get$Entity(c,h);for(let t of Object.keys(e))if(t.startsWith("$")){let o=`${l}#expressions/${t}`;yield{category:"expressions",name:t,path:o,values:()=>i(Reflect.get(e,t),"")}}}},{category:"components",rows:function*(){let o=c.replace(/-\d+$/,""),a=f.get(o);for(let n of(a||(a=e(p,c),f.set(o,a)),a)){let e,o=`${l}#components/${n.name}`;if(yield{category:"components",name:n.name,path:o,values:()=>[]},s.searchValues){try{e=t(p,h,c,n)}catch(e){yield{error:e};continue}for(let t of e){let e=`${o}/${t.instanceName}`;yield{category:"components",name:`${n.name} / ${t.instanceName}`,path:e,values:()=>t.filteredOut?[]:i(t.data,"")}}}}}},{category:"scene",rows:function*(){if(!s.searchValues)return;let e=`${l}#scene`,t=o(p,h,c);if(null===t.error)yield*function* e(t,o){for(let i of t)if("object"===i.kind)yield{category:"scene",name:i.instanceName,path:n(o,i.instanceName),values:()=>[{text:r(i.object),path:""}]};else{let t=a(o,i.instanceName);yield{category:"scene",name:i.instanceName,path:t,values:()=>[]},yield*e(i.children,t)}}(t.tree,e);else for(let o of t.entries)yield function(e,t){let o="group"===e.kind?a(t,e.instanceName):n(t,e.instanceName);return{category:"scene",name:e.instanceName,path:o,values:()=>[{text:"object"===e.kind?r(e.object):e.instanceName,path:""}]}}(o,e)}}]))if(y[d.category])try{yield*d.rows()}catch(e){yield{error:e}}}(l,c,A,u),l.categories.violations?y.get(c)??[]:[])){let e=`${A}#violations/${s.type}`;yield{category:"violations",name:s.type,path:e,values:function*(){yield{text:s.severity,path:"/severity"},yield*i(s.message,"/message")}}}}()){if("error"in s){x++;continue}j=`${c} \xb7 ${s.category} \xb7 ${s.name}`;let e=[s.name],t=[s.name.toLowerCase()],o=[""],a=0;try{for(let n of l.searchValues?s.values():[]){if(a++>=1e4){b++;break}v++,n.text&&(e.push(n.text),t.push(n.text.toLowerCase()),o.push(n.path));let r=p();r&&(await r,performance.now()>=I&&(m(N(!1)),I=performance.now()+120))}}catch{f.throwIfAborted(),x++}h.push({entityId:c,category:s.category,name:s.name,path:s.path,texts:e,normalized:t,paths:o}),performance.now()>=I&&(m(N(!1)),I=performance.now()+120);let n=p(!0);n&&await n}}catch{f.throwIfAborted(),x++}$++}return f.throwIfAborted(),N(!0)}export async function buildSearchCorpus(e,t,o){if(!e.searchValues)return l(e,t,o);let a=await l({...e,searchValues:!1},t,e=>o({...e,complete:!1}));o({...a,complete:!1,completed:0,activity:"Names indexed \xb7 preparing values…"});let n=e=>({...e,entries:[...a.entries,...e.entries]}),r=await l(e,t,e=>o(n(e)));return n(r)}export async function searchResults(e,t,o){let a=t.trim().toLowerCase(),n=[];if(!a)return n;let r=c(o),i=new Set;for(let t of e.entries){for(let e=0;e<t.texts.length;e++){let o=t.normalized[e]??"";if(o.includes(a)){let r=t.texts[e]??"";if(!i.has(t.path)){i.add(t.path);let s=Math.max(0,o.indexOf(a)-50);n.push({id:t.path,path:`${t.path}${t.paths[e]??""}`,entityId:t.entityId,category:t.category,name:t.name,preview:`${s>0?"…":""}${r.slice(s,s+180)}${r.length>s+180?"…":""}`})}break}let s=r();s&&await s}let e=r(!0);e&&await e}return o.throwIfAborted(),n}

package/dist/editor/state-inspector/filter-types.d.ts

@@ -0,0 +1,32 @@
+import type { InspectorEntityId } from './inspector-types.js';
+export type FilterCategory = 'violations' | 'fields' | 'expressions' | 'components' | 'scene';
+/** A searchable inspector row; nested values share the owning row's result. */
+export interface SearchEntry {
+    readonly entityId: InspectorEntityId;
+    readonly category: FilterCategory | 'entity';
+    readonly name: string;
+    readonly path: string;
+    readonly texts: readonly string[];
+    readonly normalized: readonly string[];
+    /** Paths relative to the owning row; avoids repeating long entity ancestry per value. */
+    readonly paths: readonly string[];
+}
+/** A complete or partial index for one state snapshot and category selection. */
+export interface SearchCorpus {
+    readonly entries: readonly SearchEntry[];
+    readonly completed: number;
+    readonly visitedValues: number;
+    readonly total: number;
+    readonly truncated: number;
+    readonly skipped: number;
+    readonly complete: boolean;
+    readonly activity: string;
+}
+export interface SearchResult {
+    readonly id: string;
+    readonly path: string;
+    readonly entityId: InspectorEntityId;
+    readonly category: FilterCategory | 'entity';
+    readonly name: string;
+    readonly preview: string;
+}

package/dist/editor/state-inspector/filter-types.js

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

package/dist/editor/state-inspector/highlight.d.ts

@@ -0,0 +1,3 @@
+export declare const Hl: ({ text }: {
+    readonly text: string;
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/editor/state-inspector/highlight.js

@@ -0,0 +1 @@
+import{jsx as e,Fragment as r}from"react/jsx-runtime";import{Fragment as t}from"react";import{useFilter as i}from"./FilterContext.js";export const Hl=({text:l})=>{let{query:s}=i(),n=s.trim();if(!n||!l)return e(r,{children:l});let o=l.toLowerCase(),a=n.toLowerCase(),c=[],h=0,m=0;for(;h<l.length;){let r=o.indexOf(a,h);if(-1===r){c.push(l.slice(h));break}r>h&&c.push(l.slice(h,r)),c.push(e("span",{className:"pxi-hl",children:l.slice(r,r+a.length)},m++)),h=r+a.length}return e(r,{children:c.map((r,i)=>e(t,{children:r},i))})};

package/dist/editor/state-inspector/hooks.d.ts

@@ -0,0 +1,29 @@
+import { type $InspectorEntity, type InspectorEntity, type InspectorEntityId } from './inspector-types.js';
+/**
+ * The domain root entity id, for the chosen slice — or null when there's no real
+ * root to show. A `potentiallyInvalid` slice can keep `rootEntityId` pointing at a
+ * deleted entity: `getTree` may throw, or it builds a *phantom* root node for an
+ * entity that isn't actually in `state.entities`. Either way we return null (and
+ * the caller renders a notice) rather than a hollow shell of a non-existent entity.
+ */
+export declare function useRootId(): InspectorEntityId | null;
+/**
+ * Sorted child entity ids of `entityId`. The array-equality optimisation in
+ * `useEagerObservableSelector` keeps the reference stable across commits that
+ * don't change the child set.
+ */
+export declare function useChildIds(entityId: InspectorEntityId): readonly InspectorEntityId[];
+/** The raw (field-only) entity. Re-renders only when this entity's own data changes. */
+export declare function useRawEntity(entityId: InspectorEntityId): InspectorEntity | null;
+/**
+ * The enhanced `$Entity` (with expression getters). `active` gates the live
+ * subscription so a collapsed Expressions group doesn't re-render on every
+ * commit — pass the group's open state.
+ */
+export declare function useEnhancedEntity(entityId: InspectorEntityId, active: boolean): $InspectorEntity | null;
+/**
+ * The subset of `ids` that still exist in the composition tree (for pinned roots).
+ * Pins persist as plain strings (localStorage), so this is the boundary where they
+ * re-enter as branded ids — survivors exist in the tree, so the brand is sound.
+ */
+export declare function usePresentEntityIds(ids: readonly string[]): readonly InspectorEntityId[];

package/dist/editor/state-inspector/hooks.js

@@ -0,0 +1 @@
+import{useEagerObservableSelector as t}from"#package/react-sdk";import{useInspector as e}from"./InspectorContext.js";import{asEntityId as r}from"./inspector-types.js";let n=[];export function useRootId(){let{store:r,domain:n,composition:s,sliceName:o}=e();return t(r.stateSlices[o],t=>{try{let e=s.getTree(t.state).root.id;return n.getEntity(e,t.state)?e:null}catch{return null}},[n,s,o])}export function useChildIds(r){let{store:s,composition:o,sliceName:a}=e();return t(s.stateSlices[a],t=>{let e=o.getTree(t.state).map.get(r);return e?e.nodes.map(t=>t.node.id).sort((t,e)=>t.localeCompare(e)):n},[o,r,a])}export function useRawEntity(r){let{store:n,domain:s,sliceName:o}=e();return t(n.stateSlices[o],t=>s.getEntity(r,t.state)??null,[s,r,o])}export function useEnhancedEntity(r,n){let{store:s,domain:o,sliceName:a}=e();return t(s.stateSlices[a],t=>{try{return o.get$Entity(r,t.state)}catch{return null}},[o,r,a],n)}export function usePresentEntityIds(s){let{store:o,composition:a,sliceName:l}=e();return t(o.stateSlices[l],t=>{try{let e=a.getTree(t.state);return s.map(r).filter(t=>e.map.has(t))}catch{return n}},[a,l,s])}

package/dist/editor/state-inspector/index.d.ts

@@ -0,0 +1 @@
+export { StateInspector } from './StateInspector.js';

package/dist/editor/state-inspector/index.js

@@ -0,0 +1 @@
+export{StateInspector}from"./StateInspector.js";

package/dist/editor/state-inspector/inspector-types.d.ts

@@ -0,0 +1,54 @@
+import type { AnyCanvasSystem, EntityObjectFilter } from '#package/configurator';
+import type { $DomainEntity, ComponentReader, CompositionProjections, CompositionTreeWithIndex, Domain, DomainEntity, DomainEntityId, DomainState, NavigationSystem, StateEmission, StateUpdate, StateValidationResult, StoreSystem, Violation } from '#package/domain';
+/**
+ * An entity id as carried throughout the inspector. The composition tree, live
+ * state, and `domain.getEntity` all hand back genuine branded `DomainEntityId`s, so
+ * the panel threads this type internally rather than widening to `string` — that's
+ * what lets ids flow straight into the reflection API without per-call casts.
+ */
+export type InspectorEntityId = DomainEntityId<string>;
+/**
+ * Brand a raw string as an inspector entity id, at the few INPUT boundaries where
+ * ids arrive as plain text and the brand can't be carried: persisted pins
+ * (localStorage) and the scene's `userData`. Everywhere else ids are already
+ * `InspectorEntityId`. The runtime value is unchanged; this only restores the
+ * compile-time brand. Do NOT reach for this mid-flow — if you need it on an id the
+ * inspector already produced, that id should have been typed `InspectorEntityId`.
+ */
+export declare const asEntityId: (id: string) => InspectorEntityId;
+/**
+ * The raw (field-only) entity. Domain entities carry arbitrary field keys beyond
+ * `id`/`type` (and, on the enhanced `$` form, one getter per expression), so the
+ * index signature exposes them for the inspector's dynamic reads (`entity[key]`).
+ * `domain.getEntity`/`get$Entity` return the plain `DomainEntity` shape without it,
+ * so those reads need an `as` at the call boundary (see hooks.ts).
+ */
+export interface InspectorEntity extends DomainEntity<string> {
+    readonly [key: string]: unknown;
+}
+/** The enhanced `$Entity` (raw fields + `_raw` + dynamic expression getters). */
+export type $InspectorEntity = $DomainEntity<InspectorEntity>;
+export type InspectorUpdate = StateUpdate<DomainEntity<string>, DomainEntity<string>>;
+export interface InspectorEntityValidation {
+    readonly success: boolean;
+    readonly errors: string | null;
+}
+export type InspectorStorySystem = StoreSystem<DomainEntity<string>, Record<string, $DomainEntity<DomainEntity<string>>>>;
+export type InspectorViolation = Violation<string>;
+export type InspectorStateValidationResult = StateValidationResult<DomainEntity<string>, string>;
+export type InspectorStateEmission = StateEmission<DomainEntity<string>, Record<string, $DomainEntity<DomainEntity<string>>>>;
+export type InspectorDomainState = DomainState<DomainEntity<string>>;
+/** Minimal domain surface used to read entities + evaluate expressions. */
+export type InspectorDomain = Domain<DomainEntity<string>, DomainEntity<string>, Record<string, $DomainEntity<DomainEntity<string>>>>;
+export type InspectorCompositionTree = CompositionTreeWithIndex<DomainEntity<string>>;
+export type InspectorCompositionProjections = CompositionProjections<DomainEntity<string>, DomainEntity<string>>;
+export type InspectorCanvasSystem = AnyCanvasSystem;
+/**
+ * The navigation system, pinned to the inspector's `DomainEntity<string>` and to
+ * `string` for each application-state dimension. Source for the System State root:
+ * values are read via its `getActive…` selectors, edits via its typed update
+ * factories — the inspector never touches the underlying system components.
+ */
+export type InspectorNavigationSystem = NavigationSystem<DomainEntity<string>, string, string, string, string>;
+export type InspectorComponentReader = ComponentReader<DomainEntity<string>>;
+export type InspectorEntityObjectFilter = EntityObjectFilter<DomainEntity<string>>;

package/dist/editor/state-inspector/inspector-types.js

@@ -0,0 +1 @@
+export const asEntityId=t=>t;

package/dist/editor/state-inspector/locate/LocateContext.d.ts

@@ -0,0 +1,23 @@
+import { type ReactNode } from 'react';
+import type { InspectorEntityId } from '../inspector-types.js';
+export type LocateTarget = {
+    readonly kind: 'entity';
+    readonly entityId: InspectorEntityId;
+} | {
+    readonly kind: 'object';
+    readonly entityId: InspectorEntityId;
+    readonly instanceName: string;
+};
+/** Stable identity for a target, so toggling/equality doesn't depend on object reference. */
+export declare function locateTargetKey(target: LocateTarget): string;
+export interface LocateApi {
+    readonly target: LocateTarget | null;
+    /** Toggle the locator for `target` — locating it, or clearing if it's already the active target. */
+    readonly toggle: (target: LocateTarget) => void;
+    readonly clear: () => void;
+    readonly isLocated: (target: LocateTarget) => boolean;
+}
+export declare const LocateProvider: ({ children }: {
+    readonly children: ReactNode;
+}) => import("react/jsx-runtime").JSX.Element;
+export declare function useLocate(): LocateApi;

package/dist/editor/state-inspector/locate/LocateContext.js

@@ -0,0 +1 @@
+import{jsx as e}from"react/jsx-runtime";import{createContext as t,useCallback as r,useContext as o,useMemo as a,useState as l}from"react";export function locateTargetKey(e){return"entity"===e.kind?`entity:${e.entityId}`:`object:${e.entityId}/${e.instanceName}`}let n=t(null);export const LocateProvider=({children:t})=>{let[o,c]=l(null),i=r(e=>{c(t=>null!==t&&locateTargetKey(t)===locateTargetKey(e)?null:e)},[]),u=r(()=>{c(null)},[]),s=a(()=>({target:o,toggle:i,clear:u,isLocated:e=>null!==o&&locateTargetKey(o)===locateTargetKey(e)}),[o,i,u]);return e(n.Provider,{value:s,children:t})};export function useLocate(){let e=o(n);if(!e)throw Error("useLocate called outside <LocateProvider>. Wrap the inspector tree in StateInspector so the 3D locator is available.");return e}

package/dist/editor/state-inspector/locate/LocateMount.d.ts

@@ -0,0 +1 @@
+export declare const LocateMount: () => import("react/jsx-runtime").JSX.Element | null;

package/dist/editor/state-inspector/locate/LocateMount.js

@@ -0,0 +1 @@
+import{jsx as t}from"react/jsx-runtime";import{SceneDebugNode as e}from"../../scene/SceneDebugNode.js";import{useInspector as o}from"../InspectorContext.js";import{useDistanceUnit as r}from"../useDistanceUnit.js";import{useLocate as n}from"./LocateContext.js";import{LocateScene as s}from"./LocateScene.js";let m=({target:n,onStale:m})=>{let{store:c,sliceName:i}=o();return t(e,{children:t(s,{target:n,store:c,sliceName:i,distanceUnit:r(),onStale:m})})};export const LocateMount=()=>{let{target:e,clear:o}=n();return null===e?null:t(m,{target:e,onStale:o})};

package/dist/editor/state-inspector/locate/LocateScene.d.ts

@@ -0,0 +1,12 @@
+import type { DimensionUnit, StateSliceName } from '#package/domain';
+import type { InspectorStorySystem } from '../inspector-types.js';
+import type { LocateTarget } from './LocateContext.js';
+interface LocateSceneProps {
+    readonly target: LocateTarget;
+    readonly store: InspectorStorySystem;
+    readonly sliceName: StateSliceName;
+    readonly distanceUnit: DimensionUnit;
+    readonly onStale: () => void;
+}
+export declare const LocateScene: ({ target, store, sliceName, distanceUnit, onStale }: LocateSceneProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/editor/state-inspector/locate/LocateScene.js

@@ -0,0 +1 @@
+import{jsx as e,jsxs as t,Fragment as r}from"react/jsx-runtime";import{ScreenSizer as i}from"@react-three/drei";import{useEffect as n,useMemo as o}from"react";import{AxesHelper as s}from"three";import{useConfigurator as c}from"#package/configurator";import{OffscreenArrow as a}from"./OffscreenArrow.js";import{buildWireframeClone as d,worldBoundsCenter as m,worldOrigin as l}from"./build-wireframe.js";export const LocateScene=({target:p,store:u,sliceName:b,distanceUnit:f,onStale:g})=>{let{canvasSystem:j}=c(),h=o(()=>{let e=p.entityId,t="entity"===p.kind?j.findEntity3d({entityIds:[e],entityRoots:!0}):j.findEntity3d({entityIds:[e],entityObjects:!0,objectInstanceNames:[p.instanceName]}),r=t.map(e=>d(e,0xe25a2c));return{clones:r,origin:t[0]?l(t[0]):null,boundsCenter:m(t)}},[j,p]),y=o(()=>{let e=new s(80);return e.renderOrder=999,e.material.depthTest=!1,e},[]);return n(()=>()=>{h.clones.forEach(e=>{e.dispose()})},[h]),n(()=>()=>{y.dispose()},[y]),n(()=>{let e=!0,t=u.stateSlices[b].subscribe(()=>{if(e){e=!1;return}g()});return()=>{t.unsubscribe()}},[u,b,g]),t(r,{children:[h.clones.map(t=>e("primitive",{object:t.object},t.object.uuid)),h.origin&&t(r,{children:[e("group",{position:h.origin.toArray(),children:e(i,{scale:1,children:e("primitive",{object:y})})}),e(a,{target:h.origin,color:0xe25a2c,distanceUnit:f}),h.boundsCenter&&e(a,{target:h.boundsCenter,anchor:h.origin,onlyWhenVisible:h.origin,color:3582432,distanceUnit:f})]})]})};

package/dist/editor/state-inspector/locate/OffscreenArrow.d.ts

@@ -0,0 +1,12 @@
+import { Vector3 } from 'three';
+import type { DimensionUnit } from '#package/domain';
+export declare const OffscreenArrow: ({ target, anchor, onlyWhenVisible, color, distanceUnit, }: {
+    readonly target: Vector3;
+    /** Where the arrow sits; defaults to the camera orbit target. */
+    readonly anchor?: Vector3;
+    /** Gate: only render the arrow while this point is on screen (e.g. suppress the bbox arrow whenever the origin arrow shows). */
+    readonly onlyWhenVisible?: Vector3;
+    readonly color: number;
+    /** The app's distance unit, threaded in from the inspector (this tree is portaled out of InspectorContext). */
+    readonly distanceUnit: DimensionUnit;
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/editor/state-inspector/locate/OffscreenArrow.js

@@ -0,0 +1 @@
+import{jsx as e,jsxs as r}from"react/jsx-runtime";import{Billboard as t,ScreenSizer as i,Text as o}from"@react-three/drei";import{useFrame as n}from"@react-three/fiber";import{useMemo as a,useRef as l,useState as c}from"react";import{Quaternion as s,Vector3 as p}from"three";import{useConfigurator as d}from"#package/configurator";import{formatDistance as m}from"../distance.js";let u=new p(0,1,0),h=(e,r,t,i)=>(t.copy(e).applyMatrix4(r.matrixWorldInverse),i.copy(e).project(r),t.z<0&&1>=Math.abs(i.x)&&1>=Math.abs(i.y)&&1>=Math.abs(i.z));export const OffscreenArrow=({target:f,anchor:y,onlyWhenVisible:b,color:M,distanceUnit:g})=>{let{cameraControlSystem:v}=d(),w=l(null),x=l(null),[j,O]=c(null),q=a(()=>({anchor:new p,ndc:new p,camSpace:new p,dir:new p,quat:new s}),[]);return n(()=>{let e=w.current;if(!e)return;let r=v.activeCameraControls$.value;if(!r){e.visible=!1;return}let t=r.camera;if(h(f,t,q.camSpace,q.ndc)||b&&!h(b,t,q.camSpace,q.ndc)){e.visible=!1,O(e=>null===e?e:null);return}let i=y??r.getTarget(q.anchor);q.dir.copy(f).sub(i);let o=q.dir.length();if(o<1e-6){e.visible=!1;return}q.dir.normalize(),e.position.copy(i),e.visible=!0,x.current&&(q.quat.setFromUnitVectors(u,q.dir),x.current.quaternion.copy(q.quat));let n=m(o,g);O(e=>e===n?e:n)}),e("group",{ref:w,visible:!1,children:r(i,{scale:1,children:[r("group",{ref:x,children:[r("mesh",{position:[0,17,0],renderOrder:999,children:[e("cylinderGeometry",{args:[2.5,2.5,34,8]}),e("meshBasicMaterial",{color:M,depthTest:!1,toneMapped:!1})]}),r("mesh",{position:[0,43,0],renderOrder:999,children:[e("coneGeometry",{args:[8,18,16]}),e("meshBasicMaterial",{color:M,depthTest:!1,toneMapped:!1})]})]}),null!==j&&e(t,{position:[0,-18,0],children:r(o,{fontSize:16,anchorX:"center",anchorY:"middle",outlineWidth:3,outlineColor:"#1a1714",outlineOpacity:.9,outlineBlur:1,renderOrder:999,children:[j,e("meshBasicMaterial",{color:"#ffffff",depthTest:!1,toneMapped:!1})]})})]})})};

package/dist/editor/state-inspector/locate/build-wireframe.d.ts

@@ -0,0 +1,17 @@
+import { type Object3D, Vector3 } from 'three';
+export interface WireframeClone {
+    readonly object: Object3D;
+    /** Disposes the wireframe materials we created (geometry is shared with the source — never disposed). */
+    readonly dispose: () => void;
+}
+/** Clone `source`'s subtree, render it as an on-top wireframe, positioned at the source's world transform. */
+export declare function buildWireframeClone(source: Object3D, color: number): WireframeClone;
+/** World-space origin (translation of the entity root's world matrix) — the point the locator arrow targets. */
+export declare function worldOrigin(source: Object3D): Vector3;
+/**
+ * World-space center of the entity's rendered geometry (union AABB over its
+ * roots). Differs from the origin when the actual mesh sits away from the
+ * entity's declared pivot — i.e. a misplaced object inside the entity. Null
+ * when nothing renders (e.g. an empty/hidden entity).
+ */
+export declare function worldBoundsCenter(roots: readonly Object3D[]): Vector3 | null;

package/dist/editor/state-inspector/locate/build-wireframe.js

@@ -0,0 +1 @@
+import{Box3 as e,MeshBasicMaterial as r,Quaternion as t,Vector3 as o}from"three";export function buildWireframeClone(e,t){e.updateWorldMatrix(!0,!1);let o=e.clone();o.matrix.copy(e.matrixWorld),o.matrix.decompose(o.position,o.quaternion,o.scale),o.matrixAutoUpdate=!0;let n=[];return o.traverse(e=>{if(null==e.material)return;let o=new r({color:t,wireframe:!0,depthTest:!1,toneMapped:!1});n.push(o),e.material=o,e.renderOrder=999,e.frustumCulled=!1}),{object:o,dispose:()=>{for(let e of n)e.dispose()}}}export function worldOrigin(e){e.updateWorldMatrix(!0,!1);let r=new o;return e.matrixWorld.decompose(r,new t,new o),r}export function worldBoundsCenter(r){let t=new e,n=!1;for(let o of r){o.updateWorldMatrix(!0,!0);let r=new e().setFromObject(o);r.isEmpty()||(t.union(r),n=!0)}return n?t.getCenter(new o):null}

package/dist/editor/state-inspector/locate/index.d.ts

@@ -0,0 +1,3 @@
+export { type LocateTarget, LocateProvider, useLocate } from './LocateContext.js';
+export { LocateMount } from './LocateMount.js';
+export { type WireframeClone, buildWireframeClone, worldBoundsCenter } from './build-wireframe.js';

package/dist/editor/state-inspector/locate/index.js

@@ -0,0 +1 @@
+export{LocateProvider,useLocate}from"./LocateContext.js";export{LocateMount}from"./LocateMount.js";export{buildWireframeClone,worldBoundsCenter}from"./build-wireframe.js";

package/dist/editor/state-inspector/pick/PickButton.d.ts

@@ -0,0 +1 @@
+export declare const PickButton: () => import("react/jsx-runtime").JSX.Element;

package/dist/editor/state-inspector/pick/PickButton.js

@@ -0,0 +1 @@
+import{jsx as t}from"react/jsx-runtime";import{Tooltip as e}from"@mui/material";import{PhxIcon as i}from"#package/ui-sdk";import{usePick as r}from"./PickContext.js";export const PickButton=()=>{let{active:n,toggle:o}=r();return t(e,{title:n?"Stop picking entities":"Pick an entity in the 3D scene",enterDelay:400,disableInteractive:!0,children:t("button",{type:"button",onClick:o,style:{display:"flex",alignItems:"center",justifyContent:"center",height:22,width:24,padding:0,color:n?"var(--pxi-phoenix-ink)":"var(--pxi-ink-mute)",background:n?"rgba(226,90,44,0.08)":"#fff",border:`1px solid ${n?"var(--pxi-phoenix-soft)":"var(--pxi-rule)"}`,borderRadius:4,cursor:"pointer"},children:t(i,{name:"CursorClick",sx:{fontSize:13}})})})};

package/dist/editor/state-inspector/pick/PickContext.d.ts

@@ -0,0 +1,11 @@
+import { type ReactNode } from 'react';
+interface PickApi {
+    readonly active: boolean;
+    readonly toggle: () => void;
+    readonly deactivate: () => void;
+}
+export declare const PickProvider: ({ children }: {
+    readonly children: ReactNode;
+}) => import("react/jsx-runtime").JSX.Element;
+export declare function usePick(): PickApi;
+export {};

package/dist/editor/state-inspector/pick/PickContext.js

@@ -0,0 +1 @@
+import{jsx as r}from"react/jsx-runtime";import{createContext as e,useCallback as t,useContext as o,useEffect as i,useMemo as l,useState as c}from"react";import{useLocate as n}from"../locate/index.js";let u=e(null);export const PickProvider=({children:e})=>{let{clear:o,target:a}=n(),[s,d]=c(!1),m=t(()=>{d(r=>!r)},[]),P=t(()=>{d(!1)},[]);i(()=>{s&&o()},[s,o]),i(()=>{null!==a&&d(!1)},[a]);let f=l(()=>({active:s,toggle:m,deactivate:P}),[s,m,P]);return r(u.Provider,{value:f,children:e})};export function usePick(){let r=o(u);if(!r)throw Error("usePick called outside <PickProvider>.");return r}

package/dist/editor/state-inspector/pick/PickMount.d.ts

@@ -0,0 +1 @@
+export declare const PickMount: () => import("react/jsx-runtime").JSX.Element | null;