@react-x11/components 0.3.0 → 0.5.0

package/dist/qml/react.js

@@ -0,0 +1,323 @@
+import { jsx as _jsx } from "react-x11/jsx-runtime";
+// The React bridge: one small component per live QML object.
+//
+// Each QmlNode subscribes to exactly one instance (useSyncExternalStore on
+// the instance's version counter), so a scalar property change re-renders
+// one element's worth of tree and React reconciliation is reserved for
+// structural change (Repeater rebuilds). The QML side never reaches around
+// React: every pixel on screen is a `<box>`/`<text>`/`<image>` committed
+// through the ordinary renderer.
+import { forwardRef, useEffect, useImperativeHandle, useRef, useSyncExternalStore, } from 'react';
+import { warn } from './globals.js';
+import { parseQml } from './parse.js';
+import { Context, QmlInstance, instantiateDocument, migrateUserState, registerQmlModule, } from './objects.js';
+import { flushBindings } from './slots.js';
+import { afterLayout, cancelAfterLayout } from '../internal/timers.js';
+export function useQmlVersion(inst) {
+    return useSyncExternalStore((cb) => inst.subscribe(cb), () => inst.version);
+}
+export function QmlNode({ inst }) {
+    useQmlVersion(inst);
+    if (inst.destroyed)
+        return null;
+    const View = inst.typeInfo.view;
+    if (!View)
+        return null;
+    return _jsx(View, { inst: inst });
+}
+export function renderQmlChildren(inst) {
+    return inst.visualChildren().map((c) => _jsx(QmlNode, { inst: c }, c.uid));
+}
+/**
+ * A QML document as a react-x11 element tree.
+ *
+ * The wrapper box takes the root object's declared size when it has one;
+ * otherwise it is sized by the app (the `style` prop) and feeds its
+ * laid-out size back into the root's implicit size, so `width`/`height`
+ * bindings inside the document see the real number — the "root fills the
+ * window" behavior.
+ */
+export const QmlView = forwardRef(function QmlView({ source, file, context, onSignal, hotReload = true, resolver, reloadToken, style, }, ref) {
+    const state = useRef(null);
+    if (!state.current ||
+        state.current.source !== source ||
+        !Object.is(state.current.token, reloadToken)) {
+        const doc = parseQml(source, { fileName: file ?? '<inline>' });
+        const next = instantiateDocument(doc, {
+            extras: { ...context },
+            resolver: resolver ?? null,
+        });
+        if (state.current) {
+            if (hotReload)
+                migrateUserState(state.current.res.context, next.context);
+            state.current.res.root.destroy();
+        }
+        state.current = { source, token: reloadToken, res: next };
+    }
+    const { res } = state.current;
+    const root = res.root;
+    useQmlVersion(root); // the wrapper box tracks the root's size
+    // Context-property updates ride ordinary commits.
+    useEffect(() => {
+        if (!context)
+            return;
+        for (const [k, v] of Object.entries(context)) {
+            const slot = res.context.extras.get(k);
+            if (slot && !Object.is(slot.peek(), v))
+                slot.assign(v);
+        }
+        flushBindings();
+    });
+    useEffect(() => {
+        if (!onSignal)
+            return;
+        const offs = Object.entries(onSignal).map(([name, fn]) => root.onSignal(name, fn));
+        return () => offs.forEach((off) => off());
+    }, [root, onSignal]);
+    useEffect(() => {
+        const mounted = state.current;
+        return () => {
+            mounted?.res.root.destroy();
+            if (state.current === mounted)
+                state.current = null;
+        };
+    }, []);
+    useImperativeHandle(ref, () => ({
+        root: root.facade,
+        id: (name) => res.context.ids.get(name)?.facade ?? null,
+        instance: root,
+    }), [root, res]);
+    // Root-size feedback. `afterLayout` (not a bare effect): react-x11 lays
+    // out on the frame flush, so an effect body reads the geometry of the
+    // previous pass — src/internal/timers.ts documents the shape.
+    const wrapRef = useRef(null);
+    const rootW = root.slots.get('width');
+    const rootH = root.slots.get('height');
+    const sized = !!rootW && !rootW.isDefault;
+    useEffect(() => {
+        if (sized)
+            return;
+        const tick = afterLayout(() => {
+            const abs = wrapRef.current?.abs;
+            if (!abs || root.destroyed)
+                return;
+            if (abs.width)
+                root.slots.get('implicitWidth')?.assign(abs.width);
+            if (abs.height)
+                root.slots.get('implicitHeight')?.assign(abs.height);
+            flushBindings();
+        });
+        return () => cancelAfterLayout(tick);
+    });
+    return (_jsx("box", { ref: wrapRef, style: [
+            { position: 'relative' },
+            sized && rootH
+                ? { width: num(rootW.peek()), height: num(rootH.peek()) }
+                : false,
+            style,
+        ], children: _jsx(QmlNode, { inst: root }) }));
+});
+const num = (v) => typeof v === 'number' && Number.isFinite(v) ? v : 0;
+/**
+ * Register a React component as a QML type — the "extend in code" seam.
+ *
+ *   registerReactComponent('Shop.Widgets', 'PriceTag', PriceTag, {
+ *     properties: { amount: { default: 0 } },
+ *     signals: { activated: [] },
+ *   });
+ *
+ * Declared properties arrive as props (live: a binding update re-renders
+ * the component); declared signals arrive as `on<Signal>` callback props
+ * that emit back into QML.
+ */
+export function registerReactComponent(moduleName, typeName, Component, { properties = {}, signals = {}, toProps, } = {}) {
+    const View = ({ inst }) => {
+        const props = {};
+        for (const name of Object.keys(properties)) {
+            props[name] = inst.slots.get(name)?.peek();
+        }
+        for (const name of Object.keys(signals)) {
+            props[`on${name[0].toUpperCase()}${name.slice(1)}`] = (...args) => inst.emit(name, ...args);
+        }
+        const shaped = toProps ? toProps(props, inst) : props;
+        const kids = renderQmlChildren(inst);
+        return (_jsx("box", { style: geometryStyle(inst), children: _jsx(Component, { ...shaped, children: kids.length ? kids : shaped.children }) }));
+    };
+    registerQmlModule(moduleName, {
+        types: {
+            [typeName]: { extends: 'Item', properties, signals, view: View },
+        },
+    });
+}
+// Shared with qtquick.tsx (kept here so registerReactComponent has no
+// dependency on the QtQuick module being loaded).
+export function geometryStyle(inst, { contentSized = false } = {}) {
+    // Inside a RowLayout/ColumnLayout the item is a flex item: yoga decides
+    // its geometry from the Layout.* attached properties, and the container
+    // reflects the answers back into x/y/width/height afterwards.
+    if (inst.parentInst?.typeInfo.managesChildLayout) {
+        return layoutChildStyle(inst);
+    }
+    const s = inst.slots;
+    const style = {
+        position: 'absolute',
+        left: num(s.get('x')?.peek()),
+        top: num(s.get('y')?.peek()),
+    };
+    const w = s.get('width');
+    const h = s.get('height');
+    if (w && !(contentSized && w.isDefault))
+        style.width = num(w.peek());
+    if (h && !(contentSized && h.isDefault))
+        style.height = num(h.peek());
+    if (s.get('visible')?.peek() === false)
+        style.display = 'none';
+    if (s.get('clip')?.peek() === true)
+        style.overflow = 'hidden';
+    const z = s.get('z')?.peek();
+    if (typeof z === 'number' && z)
+        style.zIndex = z;
+    warnUnrenderable(inst);
+    return style;
+}
+// --- QtQuick.Layouts: the flex-item half -----------------------------------
+// Qt.AlignmentFlag values (the subset Layout.alignment uses).
+const ALIGN = {
+    left: 1,
+    right: 2,
+    hcenter: 4,
+    top: 32,
+    bottom: 64,
+    vcenter: 128,
+};
+const layoutNumOf = (v) => typeof v === 'number' && Number.isFinite(v) && v >= 0 ? v : null;
+/**
+ * An item's size hint on one axis, in Qt's order: `Layout.preferredWidth`,
+ * then an author-set `width` (friendlier than Qt, which ignores it — ours
+ * reads as a preferred size), then `implicitWidth`. `read` decides
+ * tracking: `.get` inside the container's implicit-size bindings, `.peek`
+ * during render.
+ */
+export function preferredSpan(inst, horizontal, read, filling = false) {
+    const pref = inst.slots.get(horizontal ? 'Layout.preferredWidth' : 'Layout.preferredHeight');
+    if (pref) {
+        const v = layoutNumOf(read(pref));
+        if (v !== null)
+            return v;
+    }
+    if (!filling) {
+        const own = inst.slots.get(horizontal ? 'width' : 'height');
+        if (own && !own.isDefault) {
+            const v = layoutNumOf(read(own));
+            if (v !== null && v > 0)
+                return v;
+        }
+    }
+    const implicit = inst.slots.get(horizontal ? 'implicitWidth' : 'implicitHeight');
+    if (implicit) {
+        const v = layoutNumOf(read(implicit));
+        if (v !== null && v > 0)
+            return v;
+    }
+    return null;
+}
+function layoutChildStyle(inst) {
+    const parent = inst.parentInst;
+    const horizontal = parent?.typeInfo.name === 'RowLayout';
+    const style = {};
+    const la = (name) => inst.slots.get(`Layout.${name}`)?.peek();
+    const peek = (slot) => slot.peek();
+    const fillMain = la(horizontal ? 'fillWidth' : 'fillHeight') === true;
+    const fillCross = la(horizontal ? 'fillHeight' : 'fillWidth') === true;
+    const stretchRaw = la(horizontal ? 'horizontalStretchFactor' : 'verticalStretchFactor');
+    const stretch = layoutNumOf(stretchRaw) ?? 0;
+    // Main axis: preferred size is the flex basis; `fillWidth` grows.
+    const basis = preferredSpan(inst, horizontal, peek, fillMain);
+    if (fillMain) {
+        style.flexGrow = stretch > 0 ? stretch : 1;
+        style.flexBasis = basis ?? 0;
+    }
+    else {
+        style.flexGrow = 0;
+        style.flexShrink = 0;
+        if (basis !== null) {
+            if (horizontal)
+                style.width = basis;
+            else
+                style.height = basis;
+        }
+    }
+    // Cross axis: fill stretches; otherwise the preferred size holds and
+    // `Layout.alignment` places the item (Qt's defaults: vertically centered
+    // in a row, left in a column).
+    const crossPref = preferredSpan(inst, !horizontal, peek, fillCross);
+    if (fillCross) {
+        style.alignSelf = 'stretch';
+    }
+    else {
+        if (crossPref !== null) {
+            if (horizontal)
+                style.height = crossPref;
+            else
+                style.width = crossPref;
+        }
+        const alignment = layoutNumOf(la('alignment')) ?? 0;
+        const startFlag = horizontal ? ALIGN.top : ALIGN.left;
+        const endFlag = horizontal ? ALIGN.bottom : ALIGN.right;
+        const centerFlag = horizontal ? ALIGN.vcenter : ALIGN.hcenter;
+        style.alignSelf =
+            alignment & startFlag
+                ? 'flex-start'
+                : alignment & endFlag
+                    ? 'flex-end'
+                    : alignment & centerFlag
+                        ? 'center'
+                        : horizontal
+                            ? 'center'
+                            : 'flex-start';
+    }
+    const minW = layoutNumOf(la('minimumWidth'));
+    if (minW !== null)
+        style.minWidth = minW;
+    const minH = layoutNumOf(la('minimumHeight'));
+    if (minH !== null)
+        style.minHeight = minH;
+    const maxW = layoutNumOf(la('maximumWidth'));
+    if (maxW !== null)
+        style.maxWidth = maxW;
+    const maxH = layoutNumOf(la('maximumHeight'));
+    if (maxH !== null)
+        style.maxHeight = maxH;
+    const margins = layoutNumOf(la('margins')) ?? 0;
+    const side = (name) => layoutNumOf(la(name)) ?? margins;
+    if (margins || la('leftMargin') !== undefined) {
+        style.marginLeft = side('leftMargin');
+    }
+    if (margins || la('rightMargin') !== undefined)
+        style.marginRight = side('rightMargin');
+    if (margins || la('topMargin') !== undefined)
+        style.marginTop = side('topMargin');
+    if (margins || la('bottomMargin') !== undefined)
+        style.marginBottom = side('bottomMargin');
+    if (inst.slots.get('visible')?.peek() === false)
+        style.display = 'none';
+    if (inst.slots.get('clip')?.peek() === true)
+        style.overflow = 'hidden';
+    warnUnrenderable(inst);
+    return style;
+}
+const INERT = { opacity: 1, rotation: 0, scale: 1 };
+const warned = new Set();
+function warnUnrenderable(inst) {
+    for (const name of Object.keys(INERT)) {
+        const v = inst.slots.get(name)?.peek();
+        if (v !== undefined && v !== INERT[name] && !warned.has(name)) {
+            warned.add(name);
+            warn(`QML: '${name}' is declared but react-x11 cannot render it yet ` +
+                `(needs offscreen composition); the value is ignored.`);
+        }
+    }
+}
+// Re-exported here so the family's public surface sits in one place.
+export { Context, QmlInstance };
+//# sourceMappingURL=react.js.map

package/dist/qml/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../../src/qml/react.tsx"],"names":[],"mappings":"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"}

package/dist/qml/resolver.d.ts

@@ -0,0 +1,38 @@
+export interface QmlResolver {
+    /** Where the root document lives — the starting directory for its
+     * implicit import. Opaque to the engine. */
+    rootDir: string;
+    /** The source of `<name>.qml` in `dir`, or null when there is no such
+     * component. Called often (every type name is probed here first, in
+     * Qt's shadowing order) but cached by the engine per instantiation —
+     * a plain `existsSync` + `readFileSync` implementation is fine. */
+    load(dir: string, name: string): {
+        source: string;
+        fileName: string;
+    } | null;
+    /** A quoted relative import (`"./widgets"`, `"../shared"`) resolved
+     * against a document's directory. */
+    join(dir: string, relative: string): string;
+}
+/** How a document was loaded — carried on `QmlDocument` so the types it
+ * names can resolve relative to it. */
+export interface DocLoad {
+    resolver: QmlResolver;
+    dir: string;
+}
+/**
+ * The standard filesystem resolver — pass the directory your root document
+ * lives in:
+ *
+ *   const resolver = await createFileResolver(dirname(qmlPath));
+ *   <QmlView source={source} file={qmlPath} resolver={resolver} />
+ *
+ * Async because the node builtins load through a dynamic import (the build
+ * has no node types); the resolver it returns is fully synchronous. It
+ * reads through on every engine request — no content cache — so a changed
+ * sibling file is picked up on the next root reload; the engine's own
+ * per-instantiation cache keeps a 1000-delegate ListView from re-reading
+ * its component 1000 times.
+ */
+export declare function createFileResolver(baseDir: string): Promise<QmlResolver>;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/qml/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/qml/resolver.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,WAAW;IAC1B;gDAC4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB;;;uEAGmE;IACnE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7E;yCACqC;IACrC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7C;AAED;uCACuC;AACvC,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,WAAW,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AA8BD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,WAAW,CAAC,CAetB"}

package/dist/qml/resolver.js

@@ -0,0 +1,64 @@
+// The resolver seam: how `.qml` files find each other.
+//
+// The engine never touches a filesystem — it asks a `QmlResolver` for
+// component sources and treats directory strings as opaque tokens only the
+// resolver interprets. That keeps the engine host-neutral (the headless
+// tests hand it plain objects) and makes "where do components come from"
+// an app decision: a directory on disk, a bundle, an HTTP cache, a test
+// fixture.
+//
+// Three ways a type name resolves, in Qt's precedence order:
+//   1. the *implicit import* — `<Name>.qml` beside the document (no import
+//      line at all, and a local `Button.qml` shadows a module's `Button`);
+//   2. quoted-path imports — `import "./widgets"` brings in that
+//      directory's components;
+//   3. registered modules — `import QtQuick 2.15` and anything an app adds
+//      with `registerQmlModule`.
+// The first two exist only when a resolver is provided.
+/**
+ * Load a node builtin without naming it to the compiler — `src/` compiles
+ * with `types: []` on purpose, and a literal `import('node:fs')` would
+ * need `@types/node` in the build program (the `embed/host.ts` pattern).
+ */
+const builtins = new Map();
+function builtin(name) {
+    let mod = builtins.get(name);
+    if (!mod) {
+        const specifier = name;
+        mod = import(/* @vite-ignore */ specifier);
+        builtins.set(name, mod);
+    }
+    return mod;
+}
+/**
+ * The standard filesystem resolver — pass the directory your root document
+ * lives in:
+ *
+ *   const resolver = await createFileResolver(dirname(qmlPath));
+ *   <QmlView source={source} file={qmlPath} resolver={resolver} />
+ *
+ * Async because the node builtins load through a dynamic import (the build
+ * has no node types); the resolver it returns is fully synchronous. It
+ * reads through on every engine request — no content cache — so a changed
+ * sibling file is picked up on the next root reload; the engine's own
+ * per-instantiation cache keeps a 1000-delegate ListView from re-reading
+ * its component 1000 times.
+ */
+export async function createFileResolver(baseDir) {
+    const fs = await builtin('node:fs');
+    const path = await builtin('node:path');
+    const rootDir = path.resolve(baseDir);
+    return {
+        rootDir,
+        load(dir, name) {
+            const file = path.join(dir, `${name}.qml`);
+            if (!fs.existsSync(file))
+                return null;
+            return { source: fs.readFileSync(file, 'utf8'), fileName: file };
+        },
+        join(dir, relative) {
+            return path.resolve(dir, relative);
+        },
+    };
+}
+//# sourceMappingURL=resolver.js.map

package/dist/qml/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/qml/resolver.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,EAAE;AACF,sEAAsE;AACtE,2EAA2E;AAC3E,wEAAwE;AACxE,yEAAyE;AACzE,wEAAwE;AACxE,WAAW;AACX,EAAE;AACF,6DAA6D;AAC7D,2EAA2E;AAC3E,2EAA2E;AAC3E,iEAAiE;AACjE,+BAA+B;AAC/B,2EAA2E;AAC3E,iCAAiC;AACjC,wDAAwD;AAmCxD;;;;GAIG;AACH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA4B,CAAC;AACrD,SAAS,OAAO,CAAI,IAAY;IAC9B,IAAI,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,SAAS,GAAG,IAAI,CAAC;QACvB,GAAG,GAAG,MAAM,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;QAC3C,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,GAAiB,CAAC;AAC3B,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAe;IAEf,MAAM,EAAE,GAAG,MAAM,OAAO,CAAW,SAAS,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,MAAM,OAAO,CAAa,WAAW,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO;QACL,OAAO;QACP,IAAI,CAAC,GAAG,EAAE,IAAI;YACZ,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,MAAM,CAAC,CAAC;YAC3C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC;YACtC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACnE,CAAC;QACD,IAAI,CAAC,GAAG,EAAE,QAAQ;YAChB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACrC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/qml/slots.d.ts

@@ -0,0 +1,65 @@
+export type BindingFn = () => unknown;
+export interface SlotOwner {
+    _changed?(slot: Slot): void;
+}
+export declare function trackedEval<T>(fn: () => T): {
+    value: T;
+    deps: Set<Slot>;
+};
+export declare function flushBindings(): void;
+export declare class Slot {
+    owner: SlotOwner | null;
+    name: string;
+    /** The current effective value — the top layer's answer, cached. */
+    value: unknown;
+    private base;
+    private overrides;
+    subscribers: Set<Slot> | null;
+    watchers: Set<() => void> | null;
+    /** True while the implicit `width ← implicitWidth` default binding holds
+     * (Qt's `widthValid`): the renderer may size the element by content. */
+    isDefault: boolean;
+    /** True once assigned at runtime — interactive state, carried across
+     * hot reloads. */
+    userSet: boolean;
+    lastError: unknown;
+    constructor(owner: SlotOwner | null, name: string, value: unknown);
+    get(): unknown;
+    peek(): unknown;
+    hasBinding(): boolean;
+    private active;
+    /** Imperative assignment: breaks the active layer's binding. */
+    set(value: unknown): void;
+    /** Activation-time write (literals, model context): breaks the binding
+     * but is not user state — hot-reload migration must not preserve it. */
+    assign(value: unknown): void;
+    setBinding(fn: BindingFn, { isDefault }?: {
+        isDefault?: boolean | undefined;
+    }): void;
+    /**
+     * States and the `Binding` element: sit a value or binding above the
+     * base. The base keeps evaluating underneath, so popping is instant and
+     * exact. `owner` is the pop token.
+     */
+    pushOverride(owner: unknown, init: {
+        binding?: BindingFn;
+        value?: unknown;
+    }): void;
+    popOverride(owner: unknown): void;
+    private _dropLayerBinding;
+    private _evaluateLayer;
+    /** A dependency changed: re-evaluate every bound layer, then settle. */
+    _reevaluate(): void;
+    private _settle;
+    /**
+     * Layout read-back: reflect an externally computed value — yoga's answer
+     * for a Layout-managed item — into the slot without disturbing its
+     * binding, default or user flags. A later binding evaluation may
+     * overwrite it; the next layout pass reflects again. Expressions reading
+     * the slot see the laid-out number either way.
+     */
+    reflect(value: unknown): void;
+    watch(fn: () => void): () => void;
+    destroy(): void;
+}
+//# sourceMappingURL=slots.d.ts.map

package/dist/qml/slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.d.ts","sourceRoot":"","sources":["../../src/qml/slots.ts"],"names":[],"mappings":"AAqBA,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC;AAEtC,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;CAC7B;AAeD,wBAAgB,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG;IAAE,KAAK,EAAE,CAAC,CAAC;IAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAA;CAAE,CASzE;AAQD,wBAAgB,aAAa,IAAI,IAAI,CAsBpC;AAED,qBAAa,IAAI;IACf,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,IAAI,CAAQ;IACpB,OAAO,CAAC,SAAS,CAAe;IAChC,WAAW,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAQ;IACrC,QAAQ,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAQ;IACxC;4EACwE;IACxE,SAAS,UAAS;IAClB;sBACkB;IAClB,OAAO,UAAS;IAChB,SAAS,EAAE,OAAO,CAAQ;IAE1B,YAAY,KAAK,EAAE,SAAS,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAKhE;IAED,GAAG,IAAI,OAAO,CAGb;IAED,IAAI,IAAI,OAAO,CAEd;IAED,UAAU,IAAI,OAAO,CAEpB;IAED,OAAO,CAAC,MAAM;IAMd,gEAAgE;IAChE,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAGxB;IAED;4EACwE;IACxE,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAM3B;IAED,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,EAAE,SAAiB,EAAE;;KAAK,GAAG,IAAI,CAM1D;IAED;;;;OAIG;IACH,YAAY,CACV,KAAK,EAAE,OAAO,EACd,IAAI,EAAE;QAAE,OAAO,CAAC,EAAE,SAAS,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7C,IAAI,CAUN;IAED,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAQhC;IAED,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,cAAc;IAStB,wEAAwE;IACxE,WAAW,IAAI,IAAI,CAMlB;IAED,OAAO,CAAC,OAAO;IAgBf;;;;;;OAMG;IACH,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAO5B;IAED,KAAK,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAGhC;IAED,OAAO,IAAI,IAAI,CAMd;CACF"}