@react-x11/components 0.2.1 → 0.4.0

package/dist/qml/slots.js

@@ -0,0 +1,230 @@
+// The reactive core: slots, dependency tracking, batched invalidation.
+//
+// One Slot per QML property. A slot holds a *base* layer — a plain value or
+// a binding (a compiled function re-run when anything it read changes) —
+// and, above it, a stack of *override* layers. Overrides are how `states`
+// (`PropertyChanges`) and the `Binding` element sit on top of a document's
+// own bindings without destroying them: push on entry, pop on exit, and the
+// base — still tracked while covered — is current the moment it shows again.
+//
+// Assignment replaces the active layer's binding with the value — QML's
+// binding-breaking semantics, load-bearing for fidelity and pinned in
+// test/qml.test.ts.
+//
+// Granularity is the point of this file: a property change re-renders only
+// the React component wrapping that one QML object (each subscribes to its
+// object via useSyncExternalStore). React reconciliation is reserved for
+// structural change; scalar traffic — animation, dragging — stays in the
+// graph.
+import { microtask } from './globals.js';
+let activeDeps = null; // collected during a binding eval
+let flushQueue = null;
+let flushScheduled = false;
+const pendingNotify = new Set();
+export function trackedEval(fn) {
+    const prev = activeDeps;
+    activeDeps = new Set();
+    try {
+        const value = fn();
+        return { value, deps: activeDeps };
+    }
+    finally {
+        activeDeps = prev;
+    }
+}
+function scheduleFlush() {
+    if (flushScheduled)
+        return;
+    flushScheduled = true;
+    microtask(flushBindings);
+}
+export function flushBindings() {
+    flushScheduled = false;
+    // Re-evaluate dirty bindings, then run watchers — and keep going while
+    // either creates more work, so a watcher that assigns (a `when` clause
+    // switching states, a positioner re-pinning) settles in this flush
+    // rather than a later microtask.
+    for (let guard = 0;; guard++) {
+        if (guard > 200)
+            throw new Error('QML binding loop did not settle');
+        if (flushQueue && flushQueue.size) {
+            const batch = flushQueue;
+            flushQueue = null;
+            for (const slot of batch)
+                slot._reevaluate();
+            continue;
+        }
+        if (pendingNotify.size) {
+            const toNotify = [...pendingNotify];
+            pendingNotify.clear();
+            for (const fn of toNotify)
+                fn();
+            continue;
+        }
+        return;
+    }
+}
+export class Slot {
+    owner;
+    name;
+    /** The current effective value — the top layer's answer, cached. */
+    value;
+    base;
+    overrides = [];
+    subscribers = null; // slots whose bindings read this one
+    watchers = null; // onXChanged, React, positioners
+    /** True while the implicit `width ← implicitWidth` default binding holds
+     * (Qt's `widthValid`): the renderer may size the element by content. */
+    isDefault = false;
+    /** True once assigned at runtime — interactive state, carried across
+     * hot reloads. */
+    userSet = false;
+    lastError = null;
+    constructor(owner, name, value) {
+        this.owner = owner;
+        this.name = name;
+        this.value = value;
+        this.base = { binding: null, value, deps: null, owner: null };
+    }
+    get() {
+        if (activeDeps)
+            activeDeps.add(this);
+        return this.value;
+    }
+    peek() {
+        return this.value;
+    }
+    hasBinding() {
+        return this.base.binding !== null;
+    }
+    active() {
+        return this.overrides.length
+            ? this.overrides[this.overrides.length - 1]
+            : this.base;
+    }
+    /** Imperative assignment: breaks the active layer's binding. */
+    set(value) {
+        this.userSet = true;
+        this.assign(value);
+    }
+    /** Activation-time write (literals, model context): breaks the binding
+     * but is not user state — hot-reload migration must not preserve it. */
+    assign(value) {
+        const layer = this.active();
+        this._dropLayerBinding(layer);
+        if (layer === this.base)
+            this.isDefault = false;
+        layer.value = value;
+        this._settle();
+    }
+    setBinding(fn, { isDefault = false } = {}) {
+        this._dropLayerBinding(this.base);
+        this.isDefault = isDefault;
+        this.base.binding = fn;
+        this._evaluateLayer(this.base);
+        this._settle();
+    }
+    /**
+     * 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, init) {
+        const layer = {
+            binding: init.binding ?? null,
+            value: init.value,
+            deps: null,
+            owner,
+        };
+        this.overrides.push(layer);
+        if (layer.binding)
+            this._evaluateLayer(layer);
+        this._settle();
+    }
+    popOverride(owner) {
+        for (let i = this.overrides.length - 1; i >= 0; i--) {
+            if (this.overrides[i].owner === owner) {
+                this._dropLayerBinding(this.overrides[i]);
+                this.overrides.splice(i, 1);
+            }
+        }
+        this._settle();
+    }
+    _dropLayerBinding(layer) {
+        if (layer.deps) {
+            for (const dep of layer.deps)
+                dep.subscribers?.delete(this);
+            layer.deps = null;
+        }
+        layer.binding = null;
+    }
+    _evaluateLayer(layer) {
+        if (!layer.binding)
+            return;
+        const { value, deps } = trackedEval(layer.binding);
+        if (layer.deps)
+            for (const dep of layer.deps)
+                dep.subscribers?.delete(this);
+        layer.deps = deps;
+        for (const dep of deps)
+            (dep.subscribers ??= new Set()).add(this);
+        layer.value = value;
+    }
+    /** A dependency changed: re-evaluate every bound layer, then settle. */
+    _reevaluate() {
+        if (this.base.binding)
+            this._evaluateLayer(this.base);
+        for (const layer of this.overrides) {
+            if (layer.binding)
+                this._evaluateLayer(layer);
+        }
+        this._settle();
+    }
+    _settle() {
+        const effective = this.active().value;
+        if (Object.is(effective, this.value))
+            return;
+        this.value = effective;
+        if (this.subscribers) {
+            flushQueue ??= new Set();
+            for (const sub of this.subscribers)
+                flushQueue.add(sub);
+            scheduleFlush();
+        }
+        if (this.watchers) {
+            for (const w of this.watchers)
+                pendingNotify.add(w);
+            scheduleFlush();
+        }
+        this.owner?._changed?.(this);
+    }
+    /**
+     * 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) {
+        const layer = this.overrides.length
+            ? this.overrides[this.overrides.length - 1]
+            : this.base;
+        if (Object.is(layer.value, value) && Object.is(this.value, value))
+            return;
+        layer.value = value;
+        this._settle();
+    }
+    watch(fn) {
+        (this.watchers ??= new Set()).add(fn);
+        return () => this.watchers?.delete(fn);
+    }
+    destroy() {
+        this._dropLayerBinding(this.base);
+        for (const layer of this.overrides)
+            this._dropLayerBinding(layer);
+        this.overrides.length = 0;
+        this.watchers = null;
+        this.subscribers = null;
+    }
+}
+//# sourceMappingURL=slots.js.map

package/dist/qml/slots.js.map

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

package/dist/qml/states.d.ts

@@ -0,0 +1,5 @@
+import { QmlInstance, type QmlTypeDef } from './objects.js';
+/** Wire `states:`/`transitions:` on an Item, when the document has them. */
+export declare function setupStates(inst: QmlInstance): void;
+export declare const stateTypes: Record<string, QmlTypeDef>;
+//# sourceMappingURL=states.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"states.d.ts","sourceRoot":"","sources":["../../src/qml/states.ts"],"names":[],"mappings":"AAgBA,OAAO,EACL,WAAW,EAIX,KAAK,UAAU,EAEhB,MAAM,cAAc,CAAC;AAkBtB,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CA0FnD;AAqDD,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAoIjD,CAAC"}

package/dist/qml/states.js

@@ -0,0 +1,276 @@
+// States, PropertyChanges, Transition — and the two elements that share
+// their machinery, `Binding` and `Connections`.
+//
+// A state is an *override layer* on the target slots (slots.ts): entering
+// pushes, leaving pops, and the document's own bindings keep evaluating
+// underneath, so exit is exact with no bookkeeping. A `PropertyChanges`
+// binding stays live while its state is active: the pushed override is a
+// forwarding binding onto the PropertyChanges instance's own slot, whose
+// document-scoped binding keeps re-evaluating — dependency tracking chains
+// through.
+//
+// A `Transition`'s animations lower onto the style `transition` engine the
+// way `Behavior` does: the switch commits new values with per-property
+// durations, and the renderer eases. The divergence (properties jump,
+// pixels ease) is the documented one.
+import { QmlInstance, instanceOf, instantiateTemplate, makeHandlerFor, } from './objects.js';
+import { Slot, flushBindings } from './slots.js';
+import { warn } from './globals.js';
+const num = (v) => typeof v === 'number' && Number.isFinite(v) ? v : 0;
+const RESERVED_PC = new Set(['target', 'explicit', 'restoreEntryValues']);
+/** Wire `states:`/`transitions:` on an Item, when the document has them. */
+export function setupStates(inst) {
+    const stateTpls = inst.state['templates:states'];
+    if (!stateTpls?.length)
+        return;
+    const transTpls = inst.state['templates:transitions'] ?? [];
+    const engine = {
+        token: {},
+        stateInsts: stateTpls.map((tpl) => instantiateTemplate(tpl, inst).inst),
+        transInsts: transTpls.map((tpl) => instantiateTemplate(tpl, inst).inst),
+        targets: new Set([inst]),
+        applied: [],
+        current: '',
+    };
+    inst.state.stateEngine = engine;
+    inst.onDestruction.push(() => {
+        for (const s of engine.stateInsts)
+            s.destroy();
+        for (const t of engine.transInsts)
+            t.destroy();
+    });
+    for (const st of engine.stateInsts) {
+        for (const pc of propertyChangesOf(st)) {
+            const target = instanceOf(pc.slot('target').peek());
+            if (target)
+                engine.targets.add(target);
+        }
+    }
+    const stateSlot = inst.slot('state');
+    const switchTo = () => {
+        const to = String(stateSlot.peek() ?? '');
+        if (to === engine.current)
+            return;
+        installTransitionDurations(engine, engine.current, to);
+        for (const s of engine.applied)
+            s.popOverride(engine.token);
+        engine.applied = [];
+        const st = engine.stateInsts.find((s) => String(s.slot('name').peek() ?? '') === to);
+        if (to && !st) {
+            warnOnce(`qml-state-${to}`, `QML: state '${to}' matches no State in the states list`);
+        }
+        engine.current = to;
+        if (st) {
+            for (const pc of propertyChangesOf(st)) {
+                const target = instanceOf(pc.slot('target').peek());
+                if (!target) {
+                    warnOnce('qml-pc-target', 'QML: PropertyChanges without a resolvable `target` is ignored');
+                    continue;
+                }
+                for (const [propName, pcSlot] of pc.slots) {
+                    if (RESERVED_PC.has(propName))
+                        continue;
+                    const targetSlot = target.slots.get(propName);
+                    if (!targetSlot) {
+                        warnOnce(`qml-pc-${propName}`, `QML: PropertyChanges names '${propName}', which ${target.typeInfo.name} does not have`);
+                        continue;
+                    }
+                    targetSlot.pushOverride(engine.token, {
+                        binding: () => pcSlot.get(),
+                    });
+                    engine.applied.push(targetSlot);
+                }
+            }
+        }
+        flushBindings();
+    };
+    stateSlot.watch(switchTo);
+    // `when` clauses: a state that turns itself on and off.
+    for (const st of engine.stateInsts) {
+        const whenSlot = st.slots.get('when');
+        if (!whenSlot || (!whenSlot.hasBinding() && whenSlot.peek() === undefined))
+            continue;
+        const name = String(st.slot('name').peek() ?? '');
+        const check = () => {
+            const active = whenSlot.peek() === true;
+            const current = String(stateSlot.peek() ?? '');
+            if (active && current !== name)
+                stateSlot.assign(name);
+            else if (!active && current === name)
+                stateSlot.assign('');
+        };
+        whenSlot.watch(check);
+        check();
+    }
+}
+function propertyChangesOf(state) {
+    return state.children.filter((c) => c.typeInfo.name === 'PropertyChanges');
+}
+/** Pick the matching Transition and hand its per-property durations to
+ * every state target; their views merge them into `style.transition`. */
+function installTransitionDurations(engine, from, to) {
+    const matches = (v, name) => {
+        const s = String(v ?? '');
+        return s === '' || s === '*' || s.split(',').some((p) => p.trim() === name);
+    };
+    const t = engine.transInsts.find((tr) => matches(tr.slot('from').peek(), from) &&
+        matches(tr.slot('to').peek(), to));
+    const durations = {};
+    if (t) {
+        for (const anim of t.children) {
+            if (!anim.slots.has('duration'))
+                continue;
+            const props = String(anim.slots.get('properties')?.peek() ||
+                anim.slots.get('property')?.peek() ||
+                '')
+                .split(',')
+                .map((p) => p.trim())
+                .filter(Boolean);
+            const d = num(anim.slot('duration').peek()) || 250;
+            for (const p of props)
+                durations[p] = d;
+        }
+    }
+    for (const target of engine.targets) {
+        target.state.stateTransitions = durations;
+        target._changed();
+    }
+}
+const warnedOnce = new Set();
+function warnOnce(key, message) {
+    if (warnedOnce.has(key))
+        return;
+    warnedOnce.add(key);
+    warn(message);
+}
+// --- the type definitions --------------------------------------------------
+export const stateTypes = {
+    State: {
+        nonVisual: true,
+        properties: { name: { default: '' }, when: { default: undefined } },
+    },
+    PropertyChanges: {
+        nonVisual: true,
+        dynamicProperties: true,
+        properties: {
+            target: { default: undefined },
+            explicit: { default: false },
+            restoreEntryValues: { default: true },
+        },
+    },
+    Transition: {
+        nonVisual: true,
+        properties: {
+            from: { default: '' },
+            to: { default: '' },
+            reversible: { default: false },
+        },
+    },
+    /**
+     * `Binding { target: obj; property: "width"; value: expr; when: cond }` —
+     * an override pushed while `when` holds, popped when it stops; the
+     * target's own binding survives underneath.
+     */
+    Binding: {
+        nonVisual: true,
+        properties: {
+            target: { default: undefined },
+            property: { default: '' },
+            value: { default: undefined },
+            when: { default: true },
+        },
+        init(bi) {
+            let current = null;
+            const sync = () => {
+                if (current) {
+                    current.popOverride(bi);
+                    current = null;
+                }
+                if (bi.destroyed)
+                    return;
+                if (bi.slot('when').peek() === false) {
+                    flushBindings();
+                    return;
+                }
+                const target = instanceOf(bi.slot('target').peek());
+                const prop = String(bi.slot('property').peek() ?? '');
+                const targetSlot = target?.slots.get(prop);
+                if (!target || !prop)
+                    return;
+                if (!targetSlot) {
+                    warnOnce(`qml-binding-${prop}`, `QML: Binding names '${prop}', which ${target.typeInfo.name} does not have`);
+                    return;
+                }
+                targetSlot.pushOverride(bi, { binding: () => bi.slot('value').get() });
+                current = targetSlot;
+                flushBindings();
+            };
+            bi.slot('when').watch(sync);
+            bi.slot('target').watch(sync);
+            bi.slot('property').watch(sync);
+            bi.state.syncBinding = sync;
+            sync();
+        },
+        dispose(bi) {
+            bi.state.syncBinding?.();
+        },
+    },
+    /**
+     * `Connections { target: id; function onClicked(mouse) { … } }` — both
+     * the function form and the old `onClicked:` handler form; handlers are
+     * compiled in the Connections scope and subscribed to the target.
+     */
+    Connections: {
+        nonVisual: true,
+        deferHandlers: true,
+        properties: {
+            target: { default: undefined },
+            enabled: { default: true },
+            ignoreUnknownSignals: { default: false },
+        },
+        init(ci) {
+            let offs = [];
+            const wire = () => {
+                for (const off of offs)
+                    off();
+                offs = [];
+                if (ci.destroyed || ci.slot('enabled').peek() === false)
+                    return;
+                const target = instanceOf(ci.slot('target').peek());
+                if (!target)
+                    return;
+                const quiet = ci.slot('ignoreUnknownSignals').peek() === true;
+                const wireOne = (name, fn) => {
+                    const base = name[2].toLowerCase() + name.slice(3);
+                    if (!target.signalParams.has(base)) {
+                        if (!quiet)
+                            warnOnce(`qml-connections-${base}`, `QML: Connections: ${target.typeInfo.name} has no signal '${base}'`);
+                        return;
+                    }
+                    offs.push(target.onSignal(base, fn));
+                };
+                for (const { name, value } of ci.deferredHandlers) {
+                    const base = name[2].toLowerCase() + name.slice(3);
+                    const params = target.signalParams.get(base) ?? [];
+                    wireOne(name, makeHandlerFor(ci, value, params));
+                }
+                for (const [name, method] of ci.methods) {
+                    if (/^on[A-Z]/.test(name))
+                        wireOne(name, method);
+                }
+            };
+            ci.slot('target').watch(wire);
+            ci.slot('enabled').watch(wire);
+            ci.state.unwire = () => {
+                for (const off of offs)
+                    off();
+                offs = [];
+            };
+            wire();
+        },
+        dispose(ci) {
+            ci.state.unwire?.();
+        },
+    },
+};
+//# sourceMappingURL=states.js.map

package/dist/qml/states.js.map

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

package/dist/qml/view-utils.d.ts

@@ -0,0 +1,42 @@
+import type { Style } from 'react-x11/style';
+import type { DrawnNode } from 'react-x11';
+import { QmlInstance } from './objects.js';
+import { geometryStyle } from './react.js';
+export declare const num: (v: unknown) => number;
+export declare const str: (v: unknown) => string;
+/** QML hex colours put alpha FIRST (#AARRGGBB); CSS puts it last. */
+export declare function qmlColor(v: unknown): string | undefined;
+/** QML property name → the style key the renderer animates. */
+export declare const STYLE_KEY: Record<string, string>;
+export interface MotionState {
+    /** `Behavior on x` instances, by property name. */
+    behaviors?: Record<string, QmlInstance>;
+    /** Durations installed by the active state `Transition`. */
+    stateTransitions?: Record<string, number>;
+    /** `NumberAnimation on x { loops: Animation.Infinite }` lowerings. */
+    loopAnims?: Record<string, {
+        from: unknown;
+        to: unknown;
+        duration: number;
+    }>;
+}
+/**
+ * Merge the instance's motion sources into the style. The renderer
+ * animates; the property jumps — the declared divergence from
+ * docs/components/qml.md ("Behavior").
+ */
+export declare function applyMotion(inst: QmlInstance, style: Style): void;
+/** Ref callback capturing the host node for coordinate re-basing, text
+ * measurement and `forceActiveFocus()`. */
+export declare function captureNode(inst: QmlInstance): (node: DrawnNode | null) => void;
+export declare const hostNode: (inst: QmlInstance) => DrawnNode | null;
+/** The `anchors.*` slot set every Item carries. */
+export declare const anchorProperties: Record<string, {
+    default?: unknown;
+}>;
+/** Item's own init: focus plumbing and the state engine. A type that
+ * declares its own `init` replaces this (registry semantics), so it calls
+ * `initItem(inst)` first — Row, Flickable and Loader all do. */
+export declare function initItem(inst: QmlInstance): void;
+export { geometryStyle };
+//# sourceMappingURL=view-utils.d.ts.map

package/dist/qml/view-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-utils.d.ts","sourceRoot":"","sources":["../../src/qml/view-utils.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3C,eAAO,MAAM,GAAG,MAAO,OAAO,KAAG,MACoB,CAAC;AAEtD,eAAO,MAAM,GAAG,MAAO,OAAO,KAAG,MAAsC,CAAC;AAExE,qEAAqE;AACrE,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAKvD;AAED,+DAA+D;AAC/D,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAO5C,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACxC,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9E;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAsCjE;AAED;2CAC2C;AAC3C,wBAAgB,WAAW,CACzB,IAAI,EAAE,WAAW,GAChB,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,KAAK,IAAI,CAUlC;AAED,eAAO,MAAM,QAAQ,SAAU,WAAW,KAAG,SAAS,GAAG,IACV,CAAC;AAEhD,mDAAmD;AACnD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAM,CAAC;AAmB1E;;gEAEgE;AAChE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAOhD;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}