@energy8platform/game-engine 0.33.2 → 0.33.4

package/dist/scene-devtools.cjs.js

@@ -0,0 +1,377 @@
+'use strict';
+
+// Pure helpers behind the scene inspector — kept renderer/DOM-free so the control
+// inference and layout-field enumeration are unit-testable and reusable (the same
+// mapping later feeds schema-driven autogen and the agent's docs).
+/** Infer an editor control for a props value (schema-less fallback). */
+function propControlKind(value) {
+    switch (typeof value) {
+        case 'number':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'string':
+            return /^#([0-9a-f]{3}|[0-9a-f]{6}|[0-9a-f]{8})$/i.test(value) ? 'color' : 'text';
+        default:
+            return 'json';
+    }
+}
+const FRACTION_KEYS = /frac|anchor|scale|sag|left$|top$|width$|height$/i;
+function numberStep(path, value) {
+    if (/rotation/i.test(path))
+        return 0.01;
+    if (FRACTION_KEYS.test(path) && Math.abs(value) <= 4)
+        return 0.01;
+    return 1;
+}
+/** Flatten a layout rule into editable field specs (mode itself is structural → readonly). */
+function layoutFieldSpecs(rule) {
+    const out = [];
+    const visit = (value, path, label) => {
+        if (typeof value === 'number') {
+            out.push({ path, label, kind: 'number', value, step: numberStep(path, value) });
+        }
+        else if (typeof value === 'string') {
+            out.push(path === 'mode' ? { path, label, kind: 'readonly', value } : { path, label, kind: 'text', value });
+        }
+        else if (typeof value === 'boolean') {
+            out.push({ path, label, kind: 'text', value: String(value) });
+        }
+        else if (Array.isArray(value)) {
+            value.forEach((item, i) => visit(item, `${path}.${i}`, `${label}[${i}]`));
+        }
+        else if (value && typeof value === 'object') {
+            for (const [k, v] of Object.entries(value))
+                visit(v, `${path}.${k}`, `${label}.${k}`);
+        }
+    };
+    for (const [key, value] of Object.entries(rule))
+        visit(value, key, key);
+    return out;
+}
+/** Immutable set of a dot-path inside a (JSON-ish) rule object. */
+function setRulePath(rule, path, value) {
+    const clone = JSON.parse(JSON.stringify(rule));
+    const parts = path.split('.');
+    let cursor = clone;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const key = parts[i];
+        const next = Array.isArray(cursor) ? cursor[Number(key)] : cursor[key];
+        if (typeof next !== 'object' || next === null) {
+            const fresh = {};
+            if (Array.isArray(cursor))
+                cursor[Number(key)] = fresh;
+            else
+                cursor[key] = fresh;
+            cursor = fresh;
+        }
+        else {
+            cursor = next;
+        }
+    }
+    const last = parts[parts.length - 1];
+    if (Array.isArray(cursor))
+        cursor[Number(last)] = value;
+    else
+        cursor[last] = value;
+    return clone;
+}
+
+// Scene outliner + inspector — the human lens over the same SceneHandle surface the
+// agent drives (tree/patch/setState). Framework-free DOM, dev-only: hosts (scene-lab,
+// a game's preview page, later a harness panel) mount it into any container element.
+// Every edit leaves through a ScenePatch, so a mouse edit and an agent edit are the
+// same operation on the same doc.
+const STYLE = `
+.e8si { font: 12px/1.45 system-ui, sans-serif; color: #dfe6f5; display: flex; flex-direction: column; height: 100%; min-height: 0; }
+.e8si h3 { margin: 0; padding: 8px 10px 6px; font-size: 11px; letter-spacing: 1px; text-transform: uppercase; color: #7d8ab0; }
+.e8si-tree { overflow: auto; max-height: 42%; border-bottom: 1px solid #1c2540; padding-bottom: 6px; }
+.e8si-row { display: flex; gap: 6px; align-items: baseline; padding: 2px 10px; cursor: pointer; white-space: nowrap; }
+.e8si-row:hover { background: #141c36; }
+.e8si-row.sel { background: #1d2b55; }
+.e8si-row .t { color: #7d8ab0; }
+.e8si-row .dim { opacity: 0.45; }
+.e8si-insp { overflow: auto; flex: 1; padding: 4px 0 12px; }
+.e8si-head { padding: 6px 10px; }
+.e8si-head .id { font-weight: 700; font-size: 13px; }
+.e8si-head .meta { color: #7d8ab0; }
+.e8si-sec { margin-top: 6px; }
+.e8si-field { display: flex; align-items: center; gap: 6px; padding: 2px 10px; }
+.e8si-field label { flex: 0 0 96px; color: #9fb0d8; overflow: hidden; text-overflow: ellipsis; }
+.e8si-field input[type=number], .e8si-field input[type=text], .e8si-field select, .e8si-field textarea {
+  flex: 1; min-width: 0; background: #0d1428; color: #dfe6f5; border: 1px solid #2b3866; border-radius: 6px; padding: 3px 6px; font: inherit; }
+.e8si-field input[type=color] { width: 34px; height: 24px; padding: 0; border: 1px solid #2b3866; border-radius: 6px; background: none; }
+.e8si-field .ro { color: #8fa0c9; }
+.e8si-json { display: block; width: calc(100% - 20px); margin: 2px 10px; min-height: 52px; font: 11px/1.4 ui-monospace, monospace; }
+.e8si-apply { margin: 4px 10px; padding: 3px 10px; background: #18213d; color: #dfe6f5; border: 1px solid #2b3866; border-radius: 6px; cursor: pointer; }
+.e8si-empty { padding: 10px; color: #7d8ab0; }
+.e8si-badge { display: inline-block; padding: 0 6px; border: 1px solid #2b3866; border-radius: 8px; color: #9fb0d8; font-size: 10px; }
+`;
+function createSceneInspector(opts) {
+    const { handle, container } = opts;
+    const applyPatch = opts.applyPatch ?? handle.patch;
+    const getOrientation = opts.getOrientation ?? (() => 'landscape');
+    const root = document.createElement('div');
+    root.className = 'e8si';
+    const style = document.createElement('style');
+    style.textContent = STYLE;
+    root.appendChild(style);
+    const treeHost = document.createElement('div');
+    treeHost.className = 'e8si-tree';
+    const inspHost = document.createElement('div');
+    inspHost.className = 'e8si-insp';
+    root.append(treeHost, inspHost);
+    container.appendChild(root);
+    let selectedId = null;
+    // Edits from our own inputs schedule a refresh that must not rebuild the form under
+    // the user's cursor — only the outliner refreshes then.
+    let ownEdit = false;
+    const findNode = (id) => {
+        const walk = (n) => n.id === id ? n : n.children.map(walk).find(Boolean);
+        return walk(handle.tree());
+    };
+    const docNode = (id) => {
+        const walk = (n) => {
+            if (n.id === id)
+                return n;
+            for (const child of n.children ?? []) {
+                const hit = walk(child);
+                if (hit)
+                    return hit;
+            }
+            return undefined;
+        };
+        return walk(handle.doc().root);
+    };
+    const patchAndRefresh = (patch) => {
+        ownEdit = true;
+        applyPatch(patch);
+        ownEdit = false;
+        renderTree();
+    };
+    // ── Outliner ────────────────────────────────────────────────────────────────
+    const renderTree = () => {
+        treeHost.textContent = '';
+        const title = document.createElement('h3');
+        title.textContent = 'Scene';
+        treeHost.appendChild(title);
+        const renderRow = (node, depth) => {
+            const row = document.createElement('div');
+            row.className = `e8si-row${node.id === selectedId ? ' sel' : ''}${node.visible ? '' : ' dim'}`;
+            row.style.paddingLeft = `${10 + depth * 12}px`;
+            const id = document.createElement('span');
+            id.textContent = node.id;
+            const type = document.createElement('span');
+            type.className = 't';
+            type.textContent = node.name ? `${node.type} · ${node.name}` : node.type;
+            row.append(id, type);
+            if (node.state) {
+                const badge = document.createElement('span');
+                badge.className = 'e8si-badge';
+                badge.textContent = node.state;
+                row.appendChild(badge);
+            }
+            row.addEventListener('click', () => {
+                select(node.id);
+                opts.onSelect?.(node.id);
+            });
+            treeHost.appendChild(row);
+            node.children.forEach((child) => renderRow(child, depth + 1));
+        };
+        renderRow(handle.tree(), 0);
+    };
+    // ── Inspector form ─────────────────────────────────────────────────────────
+    const field = (labelText) => {
+        const wrap = document.createElement('div');
+        wrap.className = 'e8si-field';
+        const label = document.createElement('label');
+        label.textContent = labelText;
+        label.title = labelText;
+        wrap.appendChild(label);
+        return wrap;
+    };
+    const renderInspector = () => {
+        inspHost.textContent = '';
+        if (!selectedId) {
+            const empty = document.createElement('div');
+            empty.className = 'e8si-empty';
+            empty.textContent = 'Select a node (canvas or tree) to edit its layout & props.';
+            inspHost.appendChild(empty);
+            return;
+        }
+        const id = selectedId;
+        const node = docNode(id);
+        const outline = findNode(id);
+        if (!node || !outline)
+            return;
+        const head = document.createElement('div');
+        head.className = 'e8si-head';
+        head.innerHTML = '';
+        const idEl = document.createElement('div');
+        idEl.className = 'id';
+        idEl.textContent = `#${node.id}`;
+        const meta = document.createElement('div');
+        meta.className = 'meta';
+        meta.textContent = `${node.type}${node.name ? ` · ${node.name}` : ''}${node.anchorName ? ` · @${node.anchorName}` : ''}${node.visibleWhen ? ` · when: ${node.visibleWhen}` : ''}`;
+        head.append(idEl, meta);
+        inspHost.appendChild(head);
+        // State selector (named prop variants).
+        const stateNames = Object.keys(node.states ?? {});
+        if (stateNames.length > 0) {
+            const wrap = field('state');
+            const select = document.createElement('select');
+            for (const name of ['—', ...stateNames]) {
+                const option = document.createElement('option');
+                option.value = name;
+                option.textContent = name;
+                select.appendChild(option);
+            }
+            select.value = outline.state ?? '—';
+            select.addEventListener('change', () => {
+                patchAndRefresh({ op: 'set-state', id, state: select.value === '—' ? null : select.value });
+            });
+            wrap.appendChild(select);
+            inspHost.appendChild(wrap);
+        }
+        // Layout — the EFFECTIVE rule for the current orientation, edited in place.
+        const orientation = getOrientation();
+        const override = node.responsive?.[orientation]?.layout;
+        const rule = override ?? node.layout;
+        const layoutTitle = document.createElement('h3');
+        layoutTitle.textContent = `Layout (${orientation}${override ? ' override' : ''})`;
+        layoutTitle.className = 'e8si-sec';
+        inspHost.appendChild(layoutTitle);
+        if (!rule) {
+            const none = document.createElement('div');
+            none.className = 'e8si-empty';
+            none.textContent = '(no rule — parent-relative identity)';
+            inspHost.appendChild(none);
+        }
+        else {
+            for (const spec of layoutFieldSpecs(rule)) {
+                const wrap = field(spec.label);
+                if (spec.kind === 'readonly') {
+                    const span = document.createElement('span');
+                    span.className = 'ro';
+                    span.textContent = String(spec.value);
+                    wrap.appendChild(span);
+                }
+                else {
+                    const input = document.createElement('input');
+                    input.type = spec.kind === 'number' ? 'number' : 'text';
+                    if (spec.step !== undefined)
+                        input.step = String(spec.step);
+                    input.value = String(spec.value);
+                    input.addEventListener('change', () => {
+                        const raw = spec.kind === 'number' ? Number(input.value) : input.value;
+                        if (spec.kind === 'number' && !Number.isFinite(raw))
+                            return;
+                        patchAndRefresh({
+                            op: 'set-layout',
+                            id,
+                            layout: setRulePath(rule, spec.path, raw),
+                            orientation: override ? orientation : undefined,
+                        });
+                    });
+                    wrap.appendChild(input);
+                }
+                inspHost.appendChild(wrap);
+            }
+        }
+        // Props — base props, schema-less control inference.
+        const props = node.props ?? {};
+        const propKeys = Object.keys(props);
+        if (propKeys.length > 0) {
+            const propsTitle = document.createElement('h3');
+            propsTitle.textContent = 'Props';
+            propsTitle.className = 'e8si-sec';
+            inspHost.appendChild(propsTitle);
+            for (const key of propKeys) {
+                const value = props[key];
+                const kind = propControlKind(value);
+                if (kind === 'json') {
+                    const wrap = field(key);
+                    inspHost.appendChild(wrap);
+                    const area = document.createElement('textarea');
+                    area.className = 'e8si-json';
+                    area.value = JSON.stringify(value, null, 1);
+                    const apply = document.createElement('button');
+                    apply.className = 'e8si-apply';
+                    apply.textContent = `apply ${key}`;
+                    apply.addEventListener('click', () => {
+                        try {
+                            patchAndRefresh({ op: 'set-props', id, props: { [key]: JSON.parse(area.value) } });
+                        }
+                        catch {
+                            apply.textContent = `apply ${key} — invalid JSON`;
+                        }
+                    });
+                    inspHost.append(area, apply);
+                    continue;
+                }
+                const wrap = field(key);
+                if (kind === 'boolean') {
+                    const input = document.createElement('input');
+                    input.type = 'checkbox';
+                    input.checked = value === true;
+                    input.addEventListener('change', () => patchAndRefresh({ op: 'set-props', id, props: { [key]: input.checked } }));
+                    wrap.appendChild(input);
+                }
+                else if (kind === 'color') {
+                    const color = document.createElement('input');
+                    color.type = 'color';
+                    color.value = String(value).slice(0, 7);
+                    const text = document.createElement('input');
+                    text.type = 'text';
+                    text.value = String(value);
+                    const push = (v) => patchAndRefresh({ op: 'set-props', id, props: { [key]: v } });
+                    color.addEventListener('input', () => {
+                        text.value = color.value;
+                        push(color.value);
+                    });
+                    text.addEventListener('change', () => push(text.value));
+                    wrap.append(color, text);
+                }
+                else {
+                    const input = document.createElement('input');
+                    input.type = kind === 'number' ? 'number' : 'text';
+                    input.value = String(value);
+                    input.addEventListener('change', () => {
+                        const raw = kind === 'number' ? Number(input.value) : input.value;
+                        if (kind === 'number' && !Number.isFinite(raw))
+                            return;
+                        patchAndRefresh({ op: 'set-props', id, props: { [key]: raw } });
+                    });
+                    wrap.appendChild(input);
+                }
+                inspHost.appendChild(wrap);
+            }
+        }
+    };
+    const select = (id) => {
+        selectedId = id;
+        renderTree();
+        renderInspector();
+    };
+    renderTree();
+    renderInspector();
+    return {
+        select,
+        selected: () => selectedId,
+        refresh() {
+            renderTree();
+            // Keep the form stable while the user is typing into it after their own edit.
+            if (!ownEdit && !inspHost.contains(document.activeElement))
+                renderInspector();
+        },
+        destroy() {
+            root.remove();
+        },
+    };
+}
+
+exports.createSceneInspector = createSceneInspector;
+exports.layoutFieldSpecs = layoutFieldSpecs;
+exports.propControlKind = propControlKind;
+exports.setRulePath = setRulePath;
+//# sourceMappingURL=scene-devtools.cjs.js.map

package/dist/scene-devtools.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-devtools.cjs.js","sources":["../src/scene/devtools/helpers.ts","../src/scene/devtools/inspector.ts"],"sourcesContent":[null,null],"names":[],"mappings":"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"}

package/dist/scene-devtools.d.ts

@@ -0,0 +1,239 @@
+import { Container } from 'pixi.js';
+
+type Orientation = 'landscape' | 'portrait';
+interface SceneDoc {
+    version: 1;
+    /** Stable document id (usually the game id). */
+    id: string;
+    /** Design space the layout rules are authored in (viewport arrives in these units). */
+    design: {
+        width: number;
+        height: number;
+    };
+    root: SceneNode;
+}
+interface SceneNode {
+    /** Stable id — flow, code and patches address the node by it. Unique per doc. */
+    id: string;
+    /** Node kind resolved through the registry (built-in or plugin-contributed). */
+    type: string;
+    /** Human label for the outliner; never used for addressing. */
+    name?: string;
+    /** Kind-specific properties (validated by the contribution's schema). */
+    props?: Record<string, unknown>;
+    layout?: LayoutRule;
+    /** Per-orientation override merged over the base node before layout. */
+    responsive?: Partial<Record<Orientation, NodeOverride>>;
+    /**
+     * Named variants toggled at runtime (flow `setState`, editor, code) — e.g. a reel
+     * frame's `anticipation` / `bonus` looks. A state is an override, not a new node.
+     */
+    states?: Record<string, NodeOverride>;
+    /** Id of another node in this doc used as this node's mask. */
+    mask?: string;
+    /**
+     * Tiny condition over runtime vars, e.g. `"mode === 'free_spins'"`. Supported form:
+     * `<var> <op> <literal>` with `=== !== >= <= > <`. Anything richer belongs in flow/code.
+     */
+    visibleWhen?: string;
+    /** Entry in the shared anchor vocabulary flow/animation use to address the node. */
+    anchorName?: string;
+    /** Order = z-order. */
+    children?: SceneNode[];
+}
+/** Partial node applied on top of the base for an orientation or a named state. */
+interface NodeOverride {
+    layout?: LayoutRule;
+    props?: Record<string, unknown>;
+    visible?: boolean;
+}
+interface LayoutCommon {
+    /** Content anchor [ax, ay] in 0..1 (applied via pivot on the node's natural size). */
+    anchor?: [number, number];
+    /** Final hand-tuned nudge in design px, applied after the rule resolves. */
+    pxNudge?: {
+        x?: number;
+        y?: number;
+    };
+    /** Static rotation in radians (choreographed rotation belongs to flow/animation). */
+    rotation?: number;
+}
+/** Fixed design-space coordinates. */
+interface AbsoluteLayout extends LayoutCommon {
+    mode: 'absolute';
+    x: number;
+    y: number;
+    scale?: number;
+    rotation?: number;
+}
+/**
+ * Position as a fraction of the live viewport. Sizing, strongest first:
+ * `widthFrac`/`heightFrac` size the node to that fraction of the viewport (contain when
+ * both are given) — the "frame is 92% of the screen in portrait" idiom; otherwise
+ * `scaleWith` multiplies `scale` by the viewport/design ratio; otherwise plain `scale`.
+ */
+interface ViewportFractionLayout extends LayoutCommon {
+    mode: 'viewport-fraction';
+    xFrac: number;
+    yFrac: number;
+    scale?: number;
+    /** Multiply `scale` by viewport/design ratio: width | height | min | max. */
+    scaleWith?: 'width' | 'height' | 'min' | 'max';
+    /** Size the node to this fraction of the viewport width (scale derived from natural size). */
+    widthFrac?: number;
+    /** Size the node to this fraction of the viewport height. */
+    heightFrac?: number;
+    /** With both fracs: contain (default) keeps aspect, stretch distorts to fill exactly. */
+    fit?: 'contain' | 'stretch';
+}
+/**
+ * Center-crop fill of the current space (backgrounds, diorama layers). `scale` multiplies
+ * the computed cover scale (the paper-duel `e` idiom); `pxNudge` offsets from center.
+ */
+interface CoverLayout extends LayoutCommon {
+    mode: 'cover';
+    scale?: number;
+}
+/**
+ * Place inside another node's laid-out rect using fractions of that rect.
+ * `use: 'inner'` reads the target's declared `props.inner` fractions (reel frames
+ * declare where their hollow is) instead of spelling the fractions twice.
+ * When a box (`wFrac`/`hFrac` or `use`) is given the node is contain-fitted into it
+ * (`fit: 'stretch'` distorts instead).
+ */
+interface FrameFractionLayout extends LayoutCommon {
+    mode: 'frame-fraction';
+    frame: string;
+    xFrac?: number;
+    yFrac?: number;
+    wFrac?: number;
+    hFrac?: number;
+    use?: 'inner';
+    fit?: 'contain' | 'stretch';
+}
+/**
+ * Center of a reel-grid cell (badges, per-cell VFX slots). `grid` defaults to the sole
+ * reelGrid. By default the node scales with the grid (sizes authored in grid-design px);
+ * `scaleWithGrid: false` keeps it in absolute design units.
+ */
+interface GridCellLayout extends LayoutCommon {
+    mode: 'grid-cell';
+    grid?: string;
+    col: number;
+    row: number;
+    scale?: number;
+    scaleWithGrid?: boolean;
+}
+/** Pin to an edge/center of another node's laid-out rect. */
+interface PinLayout extends LayoutCommon {
+    mode: 'pin';
+    to: string;
+    edge: PinEdge;
+    offset?: [number, number];
+    scale?: number;
+}
+type PinEdge = 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right';
+type LayoutRule = AbsoluteLayout | ViewportFractionLayout | CoverLayout | FrameFractionLayout | GridCellLayout | PinLayout;
+type ScenePatch = {
+    op: 'set-props';
+    id: string;
+    props: Record<string, unknown>;
+}
+/** Without `orientation` replaces the base rule; with it, that orientation's override. */
+ | {
+    op: 'set-layout';
+    id: string;
+    layout: LayoutRule;
+    orientation?: Orientation;
+} | {
+    op: 'set-state';
+    id: string;
+    state: string | null;
+} | {
+    op: 'set-var';
+    name: string;
+    value: unknown;
+};
+/** Outliner row — the tree the inspector and the agent both read. */
+interface OutlineNode {
+    id: string;
+    type: string;
+    name?: string;
+    anchorName?: string;
+    visible: boolean;
+    state: string | null;
+    children: OutlineNode[];
+}
+
+interface Size {
+    width: number;
+    height: number;
+}
+
+/** Live counterpart of one scene node, produced by its contribution. */
+interface NodeInstance {
+    view: Container;
+    /** Natural (unscaled) content size — drives anchor, cover and box fitting. */
+    measure(): Size;
+    /** Apply a props patch in place; absent → the engine rebuilds the node instead. */
+    applyProps?(props: Record<string, unknown>): void;
+    /** Scene-local center of a grid cell (reel-grid kinds only; enables `grid-cell` layout). */
+    gridCell?(col: number, row: number): {
+        x: number;
+        y: number;
+    };
+    destroy?(): void;
+}
+
+interface SceneHandle {
+    view: Container;
+    node(id: string): Container | undefined;
+    instance(id: string): NodeInstance | undefined;
+    anchor(name: string): Container | undefined;
+    tree(): OutlineNode;
+    layout(width: number, height: number): void;
+    setVar(name: string, value: unknown): void;
+    setState(id: string, state: string | null): void;
+    patch(patch: ScenePatch): void;
+    /** The live doc (mutated by patches) — serialize this to persist the scene. */
+    doc(): SceneDoc;
+    destroy(): void;
+}
+
+interface SceneInspectorOptions {
+    handle: SceneHandle;
+    container: HTMLElement;
+    /** Route for edits (host may add logging/saving); defaults to handle.patch. */
+    applyPatch?: (patch: ScenePatch) => void;
+    /** Current orientation — decides which effective layout rule is shown/edited. */
+    getOrientation?: () => Orientation;
+    /** Selection made in the panel (host mirrors it on the canvas). */
+    onSelect?: (id: string | null) => void;
+}
+interface SceneInspector {
+    select(id: string | null): void;
+    selected(): string | null;
+    refresh(): void;
+    destroy(): void;
+}
+declare function createSceneInspector(opts: SceneInspectorOptions): SceneInspector;
+
+type PropControlKind = 'number' | 'text' | 'boolean' | 'color' | 'json';
+/** Infer an editor control for a props value (schema-less fallback). */
+declare function propControlKind(value: unknown): PropControlKind;
+interface LayoutFieldSpec {
+    /** Dot-path inside the rule ('x', 'pxNudge.x', 'anchor.0', 'offset.1'). */
+    path: string;
+    label: string;
+    kind: 'number' | 'text' | 'readonly';
+    value: number | string;
+    /** Input step — fractions and anchors get fine steps, px fields get 1. */
+    step?: number;
+}
+/** Flatten a layout rule into editable field specs (mode itself is structural → readonly). */
+declare function layoutFieldSpecs(rule: LayoutRule): LayoutFieldSpec[];
+/** Immutable set of a dot-path inside a (JSON-ish) rule object. */
+declare function setRulePath(rule: LayoutRule, path: string, value: unknown): LayoutRule;
+
+export { createSceneInspector, layoutFieldSpecs, propControlKind, setRulePath };
+export type { LayoutFieldSpec, PropControlKind, SceneInspector, SceneInspectorOptions };