react-native-gtkx 0.1.0-alpha.1

package/dist/animated/spring.js

@@ -0,0 +1,67 @@
+// Animated.spring: analytic damped harmonic oscillator — the same closed-form
+// solution RN uses — evaluated from the elapsed time the frame scheduler
+// reports, so the trajectory is deterministic for any frame cadence. The run
+// completes when both velocity and displacement fall under the rest
+// thresholds (or as soon as overshootClamping trips), then snaps exactly to
+// toValue.
+import { warnNativeDriverIgnored } from "./native-driver";
+import { createValueAnimation } from "./value-animation";
+export const createSpring = (scheduler, value, config) => {
+    const { toValue, delay = 0 } = config;
+    const stiffness = config.stiffness ?? 100;
+    const damping = config.damping ?? 10;
+    const mass = config.mass ?? 1;
+    const initialVelocity = config.initialVelocity ?? 0;
+    const overshootClamping = config.overshootClamping ?? false;
+    const restDisplacementThreshold = config.restDisplacementThreshold ?? 0.001;
+    const restSpeedThreshold = config.restSpeedThreshold ?? 0.001;
+    if (stiffness <= 0 || damping <= 0 || mass <= 0) {
+        throw new Error("Animated.spring: stiffness, damping and mass must be positive");
+    }
+    if (config.useNativeDriver) {
+        warnNativeDriverIgnored();
+    }
+    const zeta = damping / (2 * Math.sqrt(stiffness * mass));
+    const omega0 = Math.sqrt(stiffness / mass); // undamped frequency, rad/s
+    const omega1 = omega0 * Math.sqrt(Math.abs(1 - zeta * zeta));
+    return createValueAnimation(scheduler, value, (startValue) => {
+        const x0 = toValue - startValue;
+        const v0 = -initialVelocity;
+        return (elapsedMs) => {
+            const t = (elapsedMs - delay) / 1000;
+            if (t < 0) {
+                return { position: null, done: false };
+            }
+            let position;
+            let velocity;
+            if (zeta < 1) {
+                // Underdamped oscillation.
+                const envelope = Math.exp(-zeta * omega0 * t);
+                const sin = Math.sin(omega1 * t);
+                const cos = Math.cos(omega1 * t);
+                const a2 = (v0 + zeta * omega0 * x0) / omega1;
+                position = toValue - envelope * (a2 * sin + x0 * cos);
+                velocity =
+                    zeta * omega0 * envelope * (a2 * sin + x0 * cos) -
+                        envelope * (cos * (v0 + zeta * omega0 * x0) - omega1 * x0 * sin);
+            }
+            else {
+                // Critically damped (RN applies the same formula when overdamped).
+                const envelope = Math.exp(-omega0 * t);
+                position = toValue - envelope * (x0 + (v0 + omega0 * x0) * t);
+                velocity = envelope * (v0 * (t * omega0 - 1) + t * x0 * omega0 * omega0);
+            }
+            // Checked before publishing, so a clamped spring never reports a value
+            // past its target.
+            const overshooting = overshootClamping &&
+                (startValue < toValue ? position > toValue : position < toValue);
+            const atRest = Math.abs(velocity) <= restSpeedThreshold &&
+                Math.abs(toValue - position) <= restDisplacementThreshold;
+            if (overshooting || atRest) {
+                return { position: toValue, done: true };
+            }
+            return { position, done: false };
+        };
+    });
+};
+//# sourceMappingURL=spring.js.map

package/dist/animated/spring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spring.js","sourceRoot":"","sources":["../../src/animated/spring.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,yEAAyE;AACzE,6EAA6E;AAC7E,oEAAoE;AACpE,4EAA4E;AAC5E,WAAW;AAEX,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AAGzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAExD,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,SAAyB,EACzB,KAAoB,EACpB,MAAoB,EACA,EAAE;IACtB,MAAM,EAAE,OAAO,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,MAAM,CAAA;IACrC,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,GAAG,CAAA;IACzC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAA;IACpC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,CAAC,CAAA;IAC7B,MAAM,eAAe,GAAG,MAAM,CAAC,eAAe,IAAI,CAAC,CAAA;IACnD,MAAM,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,IAAI,KAAK,CAAA;IAC3D,MAAM,yBAAyB,GAAG,MAAM,CAAC,yBAAyB,IAAI,KAAK,CAAA;IAC3E,MAAM,kBAAkB,GAAG,MAAM,CAAC,kBAAkB,IAAI,KAAK,CAAA;IAC7D,IAAI,SAAS,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CACb,+DAA+D,CAChE,CAAA;IACH,CAAC;IACD,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QAC3B,uBAAuB,EAAE,CAAA;IAC3B,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,CAAA;IACxD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,CAAA,CAAC,4BAA4B;IACvE,MAAM,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,CAAA;IAE5D,OAAO,oBAAoB,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC,UAAU,EAAE,EAAE;QAC3D,MAAM,EAAE,GAAG,OAAO,GAAG,UAAU,CAAA;QAC/B,MAAM,EAAE,GAAG,CAAC,eAAe,CAAA;QAC3B,OAAO,CAAC,SAAS,EAAE,EAAE;YACnB,MAAM,CAAC,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,IAAI,CAAA;YACpC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBACV,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;YACxC,CAAC;YAED,IAAI,QAAgB,CAAA;YACpB,IAAI,QAAgB,CAAA;YACpB,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;gBACb,2BAA2B;gBAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,MAAM,GAAG,CAAC,CAAC,CAAA;gBAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;gBAChC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;gBAChC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,IAAI,GAAG,MAAM,GAAG,EAAE,CAAC,GAAG,MAAM,CAAA;gBAC7C,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,CAAC,EAAE,GAAG,GAAG,GAAG,EAAE,GAAG,GAAG,CAAC,CAAA;gBACrD,QAAQ;oBACN,IAAI,GAAG,MAAM,GAAG,QAAQ,GAAG,CAAC,EAAE,GAAG,GAAG,GAAG,EAAE,GAAG,GAAG,CAAC;wBAChD,QAAQ,GAAG,CAAC,GAAG,GAAG,CAAC,EAAE,GAAG,IAAI,GAAG,MAAM,GAAG,EAAE,CAAC,GAAG,MAAM,GAAG,EAAE,GAAG,GAAG,CAAC,CAAA;YACpE,CAAC;iBAAM,CAAC;gBACN,mEAAmE;gBACnE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;gBACtC,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,MAAM,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;gBAC7D,QAAQ,GAAG,QAAQ,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,MAAM,GAAG,MAAM,CAAC,CAAA;YAC1E,CAAC;YAED,uEAAuE;YACvE,mBAAmB;YACnB,MAAM,YAAY,GAChB,iBAAiB;gBACjB,CAAC,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAA;YAClE,MAAM,MAAM,GACV,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,kBAAkB;gBACxC,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,QAAQ,CAAC,IAAI,yBAAyB,CAAA;YAC3D,IAAI,YAAY,IAAI,MAAM,EAAE,CAAC;gBAC3B,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;YAC1C,CAAC;YACD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;QAClC,CAAC,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA","sourcesContent":["// Animated.spring: analytic damped harmonic oscillator — the same closed-form\n// solution RN uses — evaluated from the elapsed time the frame scheduler\n// reports, so the trajectory is deterministic for any frame cadence. The run\n// completes when both velocity and displacement fall under the rest\n// thresholds (or as soon as overshootClamping trips), then snaps exactly to\n// toValue.\n\nimport { warnNativeDriverIgnored } from \"./native-driver\"\nimport type { CompositeAnimation, FrameScheduler, SpringConfig } from \"./types\"\nimport type { AnimatedValue } from \"./value\"\nimport { createValueAnimation } from \"./value-animation\"\n\nexport const createSpring = (\n  scheduler: FrameScheduler,\n  value: AnimatedValue,\n  config: SpringConfig,\n): CompositeAnimation => {\n  const { toValue, delay = 0 } = config\n  const stiffness = config.stiffness ?? 100\n  const damping = config.damping ?? 10\n  const mass = config.mass ?? 1\n  const initialVelocity = config.initialVelocity ?? 0\n  const overshootClamping = config.overshootClamping ?? false\n  const restDisplacementThreshold = config.restDisplacementThreshold ?? 0.001\n  const restSpeedThreshold = config.restSpeedThreshold ?? 0.001\n  if (stiffness <= 0 || damping <= 0 || mass <= 0) {\n    throw new Error(\n      \"Animated.spring: stiffness, damping and mass must be positive\",\n    )\n  }\n  if (config.useNativeDriver) {\n    warnNativeDriverIgnored()\n  }\n\n  const zeta = damping / (2 * Math.sqrt(stiffness * mass))\n  const omega0 = Math.sqrt(stiffness / mass) // undamped frequency, rad/s\n  const omega1 = omega0 * Math.sqrt(Math.abs(1 - zeta * zeta))\n\n  return createValueAnimation(scheduler, value, (startValue) => {\n    const x0 = toValue - startValue\n    const v0 = -initialVelocity\n    return (elapsedMs) => {\n      const t = (elapsedMs - delay) / 1000\n      if (t < 0) {\n        return { position: null, done: false }\n      }\n\n      let position: number\n      let velocity: number\n      if (zeta < 1) {\n        // Underdamped oscillation.\n        const envelope = Math.exp(-zeta * omega0 * t)\n        const sin = Math.sin(omega1 * t)\n        const cos = Math.cos(omega1 * t)\n        const a2 = (v0 + zeta * omega0 * x0) / omega1\n        position = toValue - envelope * (a2 * sin + x0 * cos)\n        velocity =\n          zeta * omega0 * envelope * (a2 * sin + x0 * cos) -\n          envelope * (cos * (v0 + zeta * omega0 * x0) - omega1 * x0 * sin)\n      } else {\n        // Critically damped (RN applies the same formula when overdamped).\n        const envelope = Math.exp(-omega0 * t)\n        position = toValue - envelope * (x0 + (v0 + omega0 * x0) * t)\n        velocity = envelope * (v0 * (t * omega0 - 1) + t * x0 * omega0 * omega0)\n      }\n\n      // Checked before publishing, so a clamped spring never reports a value\n      // past its target.\n      const overshooting =\n        overshootClamping &&\n        (startValue < toValue ? position > toValue : position < toValue)\n      const atRest =\n        Math.abs(velocity) <= restSpeedThreshold &&\n        Math.abs(toValue - position) <= restDisplacementThreshold\n      if (overshooting || atRest) {\n        return { position: toValue, done: true }\n      }\n      return { position, done: false }\n    }\n  })\n}\n"]}

package/dist/animated/timing.d.ts

@@ -0,0 +1,3 @@
+import type { CompositeAnimation, FrameScheduler, TimingConfig } from "./types";
+import type { AnimatedValue } from "./value";
+export declare const createTiming: (scheduler: FrameScheduler, value: AnimatedValue, config: TimingConfig) => CompositeAnimation;

package/dist/animated/timing.js

@@ -0,0 +1,30 @@
+// Animated.timing: duration-based easing toward toValue with RN defaults
+// (duration 500 ms, easing inOut(ease)). delay waits out frames without
+// touching the value; duration 0 jumps to toValue on the first frame past
+// the delay.
+import { Easing } from "./easing";
+import { warnNativeDriverIgnored } from "./native-driver";
+import { createValueAnimation } from "./value-animation";
+const defaultEasing = Easing.inOut(Easing.ease);
+export const createTiming = (scheduler, value, config) => {
+    const { toValue, delay = 0 } = config;
+    const duration = config.duration ?? 500;
+    const easing = config.easing ?? defaultEasing;
+    if (config.useNativeDriver) {
+        warnNativeDriverIgnored();
+    }
+    return createValueAnimation(scheduler, value, (startValue) => (elapsedMs) => {
+        const t = elapsedMs - delay;
+        if (t < 0) {
+            return { position: null, done: false };
+        }
+        if (duration <= 0 || t >= duration) {
+            return { position: toValue, done: true };
+        }
+        return {
+            position: startValue + easing(t / duration) * (toValue - startValue),
+            done: false,
+        };
+    });
+};
+//# sourceMappingURL=timing.js.map

package/dist/animated/timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.js","sourceRoot":"","sources":["../../src/animated/timing.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,wEAAwE;AACxE,0EAA0E;AAC1E,aAAa;AAEb,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AAGzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAExD,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;AAE/C,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,SAAyB,EACzB,KAAoB,EACpB,MAAoB,EACA,EAAE;IACtB,MAAM,EAAE,OAAO,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,MAAM,CAAA;IACrC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,GAAG,CAAA;IACvC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,aAAa,CAAA;IAC7C,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QAC3B,uBAAuB,EAAE,CAAA;IAC3B,CAAC;IAED,OAAO,oBAAoB,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,EAAE;QAC1E,MAAM,CAAC,GAAG,SAAS,GAAG,KAAK,CAAA;QAC3B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACV,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;QACxC,CAAC;QACD,IAAI,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;YACnC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;QAC1C,CAAC;QACD,OAAO;YACL,QAAQ,EAAE,UAAU,GAAG,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,GAAG,UAAU,CAAC;YACpE,IAAI,EAAE,KAAK;SACZ,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA","sourcesContent":["// Animated.timing: duration-based easing toward toValue with RN defaults\n// (duration 500 ms, easing inOut(ease)). delay waits out frames without\n// touching the value; duration 0 jumps to toValue on the first frame past\n// the delay.\n\nimport { Easing } from \"./easing\"\nimport { warnNativeDriverIgnored } from \"./native-driver\"\nimport type { CompositeAnimation, FrameScheduler, TimingConfig } from \"./types\"\nimport type { AnimatedValue } from \"./value\"\nimport { createValueAnimation } from \"./value-animation\"\n\nconst defaultEasing = Easing.inOut(Easing.ease)\n\nexport const createTiming = (\n  scheduler: FrameScheduler,\n  value: AnimatedValue,\n  config: TimingConfig,\n): CompositeAnimation => {\n  const { toValue, delay = 0 } = config\n  const duration = config.duration ?? 500\n  const easing = config.easing ?? defaultEasing\n  if (config.useNativeDriver) {\n    warnNativeDriverIgnored()\n  }\n\n  return createValueAnimation(scheduler, value, (startValue) => (elapsedMs) => {\n    const t = elapsedMs - delay\n    if (t < 0) {\n      return { position: null, done: false }\n    }\n    if (duration <= 0 || t >= duration) {\n      return { position: toValue, done: true }\n    }\n    return {\n      position: startValue + easing(t / duration) * (toValue - startValue),\n      done: false,\n    }\n  })\n}\n"]}

package/dist/animated/types.d.ts

@@ -0,0 +1,51 @@
+import type { EasingFunction } from "./easing";
+export type FrameScheduler = {
+    schedule(cb: (timeMs: number) => void): () => void;
+};
+export type EndResult = {
+    finished: boolean;
+};
+export type EndCallback = (result: EndResult) => void;
+export type CompositeAnimation = {
+    start(callback?: EndCallback): void;
+    stop(): void;
+    reset(): void;
+};
+export type ValueListener = (event: {
+    value: number;
+}) => void;
+export type InterpolationListener = (event: {
+    value: number | string;
+}) => void;
+export type ExtrapolateType = "extend" | "clamp" | "identity";
+export type InterpolationConfig = {
+    inputRange: number[];
+    outputRange: number[] | string[];
+    extrapolate?: ExtrapolateType;
+};
+export type TimingConfig = {
+    toValue: number;
+    duration?: number;
+    delay?: number;
+    easing?: EasingFunction;
+    useNativeDriver?: boolean;
+};
+export type SpringConfig = {
+    toValue: number;
+    stiffness?: number;
+    damping?: number;
+    mass?: number;
+    initialVelocity?: number;
+    overshootClamping?: boolean;
+    restDisplacementThreshold?: number;
+    restSpeedThreshold?: number;
+    delay?: number;
+    useNativeDriver?: boolean;
+};
+export type ParallelConfig = {
+    stopTogether?: boolean;
+};
+export type LoopConfig = {
+    iterations?: number;
+    resetBeforeIteration?: boolean;
+};

package/dist/animated/types.js

@@ -0,0 +1,6 @@
+// Public contracts of the Animated module. The module is pure: no bridge or
+// gtkx imports, no timers, no Date — time only ever arrives through the
+// injected FrameScheduler, so the GTK frame clock (production) and a manual
+// test driver are interchangeable.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/animated/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/animated/types.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,wEAAwE;AACxE,4EAA4E;AAC5E,mCAAmC","sourcesContent":["// Public contracts of the Animated module. The module is pure: no bridge or\n// gtkx imports, no timers, no Date — time only ever arrives through the\n// injected FrameScheduler, so the GTK frame clock (production) and a manual\n// test driver are interchangeable.\n\nimport type { EasingFunction } from \"./easing\"\n\n// Frame driver injected by the host (GTK frame clock in production, a manual\n// scheduler in tests). schedule() books a one-shot callback for the next\n// frame — re-book from inside the callback to keep ticking — and returns an\n// unsubscribe that cancels the pending callback.\nexport type FrameScheduler = {\n  schedule(cb: (timeMs: number) => void): () => void\n}\n\nexport type EndResult = { finished: boolean }\n\nexport type EndCallback = (result: EndResult) => void\n\n// RN CompositeAnimation subset, plus reset() which loop() relies on to snap\n// values back before each iteration (RN has it too).\nexport type CompositeAnimation = {\n  start(callback?: EndCallback): void\n  stop(): void\n  reset(): void\n}\n\nexport type ValueListener = (event: { value: number }) => void\n\nexport type InterpolationListener = (event: { value: number | string }) => void\n\nexport type ExtrapolateType = \"extend\" | \"clamp\" | \"identity\"\n\nexport type InterpolationConfig = {\n  inputRange: number[]\n  outputRange: number[] | string[]\n  // Applied to both sides of the input range (RN's extrapolateLeft/Right are\n  // not split out in this subset). Default: \"extend\".\n  extrapolate?: ExtrapolateType\n}\n\nexport type TimingConfig = {\n  toValue: number\n  duration?: number\n  delay?: number\n  easing?: EasingFunction\n  // Accepted for RN source compatibility; the GTK backend has no native\n  // driver (everything already runs on the direct frame-clock path), so the\n  // flag is ignored with a single dev warning per session.\n  useNativeDriver?: boolean\n}\n\nexport type SpringConfig = {\n  toValue: number\n  stiffness?: number\n  damping?: number\n  mass?: number\n  initialVelocity?: number\n  overshootClamping?: boolean\n  restDisplacementThreshold?: number\n  restSpeedThreshold?: number\n  delay?: number\n  useNativeDriver?: boolean\n}\n\nexport type ParallelConfig = {\n  // Like RN: when one child ends unfinished, stop the remaining ones too.\n  // Default: true.\n  stopTogether?: boolean\n}\n\nexport type LoopConfig = {\n  // -1 (default) loops forever.\n  iterations?: number\n  // Snap the child animation back to its starting value before every\n  // iteration (RN default: true).\n  resetBeforeIteration?: boolean\n}\n"]}

package/dist/animated/value-animation.d.ts

@@ -0,0 +1,9 @@
+import type { CompositeAnimation, FrameScheduler } from "./types";
+import type { AnimatedValue } from "./value";
+export type StepResult = {
+    position: number | null;
+    done: boolean;
+};
+export type StepFn = (elapsedMs: number) => StepResult;
+export type MakeStep = (startValue: number) => StepFn;
+export declare const createValueAnimation: (scheduler: FrameScheduler, value: AnimatedValue, makeStep: MakeStep) => CompositeAnimation;

package/dist/animated/value-animation.js

@@ -0,0 +1,65 @@
+// Shared lifecycle for animations that drive a single AnimatedValue (timing,
+// spring). Implements the RN semantics: a value runs at most one animation —
+// a newer start() preempts the previous one with { finished: false }; natural
+// completion reports { finished: true }; a finished or stopped run drops its
+// frame subscription immediately (no idle ticks). The first frame after
+// start() establishes t = 0 — there is no wall clock in this module, time
+// only ever comes from the scheduler.
+import { createFrameLoop } from "./frame-loop";
+export const createValueAnimation = (scheduler, value, makeStep) => {
+    let stopActiveRun = null;
+    const start = (callback) => {
+        const step = makeStep(value.__getValue());
+        let startTime = null;
+        let ended = false;
+        const loop = createFrameLoop(scheduler, (timeMs) => {
+            if (ended) {
+                return false;
+            }
+            if (startTime === null) {
+                startTime = timeMs;
+            }
+            const { position, done } = step(timeMs - startTime);
+            if (position !== null) {
+                value.__updateValue(position);
+            }
+            if (done) {
+                end(true);
+                return false;
+            }
+            return true;
+        });
+        const handle = { stop: () => end(false) };
+        const end = (finished) => {
+            if (ended) {
+                return;
+            }
+            ended = true;
+            loop.stop();
+            if (stopActiveRun === handle.stop) {
+                stopActiveRun = null;
+            }
+            value.__endAnimation(handle);
+            callback?.({ finished });
+        };
+        stopActiveRun = handle.stop;
+        // Attaching preempts whatever ran on this value before (this animation's
+        // own previous run included) — the preempted run ends { finished: false }.
+        value.__startAnimation(handle);
+        if (!ended) {
+            loop.start();
+        }
+    };
+    return {
+        start,
+        stop: () => {
+            stopActiveRun?.();
+        },
+        // RN parity: composite reset stops the run and snaps the value back to
+        // its construction-time value (loop() relies on this between iterations).
+        reset: () => {
+            value.resetAnimation();
+        },
+    };
+};
+//# sourceMappingURL=value-animation.js.map

package/dist/animated/value-animation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-animation.js","sourceRoot":"","sources":["../../src/animated/value-animation.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,6EAA6E;AAC7E,8EAA8E;AAC9E,6EAA6E;AAC7E,wEAAwE;AACxE,0EAA0E;AAC1E,sCAAsC;AAEtC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAa9C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,SAAyB,EACzB,KAAoB,EACpB,QAAkB,EACE,EAAE;IACtB,IAAI,aAAa,GAAwB,IAAI,CAAA;IAE7C,MAAM,KAAK,GAAG,CAAC,QAAsB,EAAQ,EAAE;QAC7C,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAA;QACzC,IAAI,SAAS,GAAkB,IAAI,CAAA;QACnC,IAAI,KAAK,GAAG,KAAK,CAAA;QAEjB,MAAM,IAAI,GAAG,eAAe,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE;YACjD,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,KAAK,CAAA;YACd,CAAC;YACD,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;gBACvB,SAAS,GAAG,MAAM,CAAA;YACpB,CAAC;YACD,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;YACnD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACtB,KAAK,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;YAC/B,CAAC;YACD,IAAI,IAAI,EAAE,CAAC;gBACT,GAAG,CAAC,IAAI,CAAC,CAAA;gBACT,OAAO,KAAK,CAAA;YACd,CAAC;YACD,OAAO,IAAI,CAAA;QACb,CAAC,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,GAAS,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAA;QAE/C,MAAM,GAAG,GAAG,CAAC,QAAiB,EAAQ,EAAE;YACtC,IAAI,KAAK,EAAE,CAAC;gBACV,OAAM;YACR,CAAC;YACD,KAAK,GAAG,IAAI,CAAA;YACZ,IAAI,CAAC,IAAI,EAAE,CAAA;YACX,IAAI,aAAa,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;gBAClC,aAAa,GAAG,IAAI,CAAA;YACtB,CAAC;YACD,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAA;YAC5B,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAA;QAC1B,CAAC,CAAA;QAED,aAAa,GAAG,MAAM,CAAC,IAAI,CAAA;QAC3B,yEAAyE;QACzE,2EAA2E;QAC3E,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAA;QAC9B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,CAAC,KAAK,EAAE,CAAA;QACd,CAAC;IACH,CAAC,CAAA;IAED,OAAO;QACL,KAAK;QACL,IAAI,EAAE,GAAG,EAAE;YACT,aAAa,EAAE,EAAE,CAAA;QACnB,CAAC;QACD,uEAAuE;QACvE,0EAA0E;QAC1E,KAAK,EAAE,GAAG,EAAE;YACV,KAAK,CAAC,cAAc,EAAE,CAAA;QACxB,CAAC;KACF,CAAA;AACH,CAAC,CAAA","sourcesContent":["// Shared lifecycle for animations that drive a single AnimatedValue (timing,\n// spring). Implements the RN semantics: a value runs at most one animation —\n// a newer start() preempts the previous one with { finished: false }; natural\n// completion reports { finished: true }; a finished or stopped run drops its\n// frame subscription immediately (no idle ticks). The first frame after\n// start() establishes t = 0 — there is no wall clock in this module, time\n// only ever comes from the scheduler.\n\nimport { createFrameLoop } from \"./frame-loop\"\nimport type { CompositeAnimation, EndCallback, FrameScheduler } from \"./types\"\nimport type { AnimatedValue } from \"./value\"\n\n// Per-frame step: elapsed ms since the first frame of this run → the next\n// position (null while waiting out a delay: the value is not touched) and\n// whether the run is done. makeStep is invoked on every start() with the\n// value captured at that moment, so restarts pick up from wherever the value\n// currently is.\nexport type StepResult = { position: number | null; done: boolean }\nexport type StepFn = (elapsedMs: number) => StepResult\nexport type MakeStep = (startValue: number) => StepFn\n\nexport const createValueAnimation = (\n  scheduler: FrameScheduler,\n  value: AnimatedValue,\n  makeStep: MakeStep,\n): CompositeAnimation => {\n  let stopActiveRun: (() => void) | null = null\n\n  const start = (callback?: EndCallback): void => {\n    const step = makeStep(value.__getValue())\n    let startTime: number | null = null\n    let ended = false\n\n    const loop = createFrameLoop(scheduler, (timeMs) => {\n      if (ended) {\n        return false\n      }\n      if (startTime === null) {\n        startTime = timeMs\n      }\n      const { position, done } = step(timeMs - startTime)\n      if (position !== null) {\n        value.__updateValue(position)\n      }\n      if (done) {\n        end(true)\n        return false\n      }\n      return true\n    })\n\n    const handle = { stop: (): void => end(false) }\n\n    const end = (finished: boolean): void => {\n      if (ended) {\n        return\n      }\n      ended = true\n      loop.stop()\n      if (stopActiveRun === handle.stop) {\n        stopActiveRun = null\n      }\n      value.__endAnimation(handle)\n      callback?.({ finished })\n    }\n\n    stopActiveRun = handle.stop\n    // Attaching preempts whatever ran on this value before (this animation's\n    // own previous run included) — the preempted run ends { finished: false }.\n    value.__startAnimation(handle)\n    if (!ended) {\n      loop.start()\n    }\n  }\n\n  return {\n    start,\n    stop: () => {\n      stopActiveRun?.()\n    },\n    // RN parity: composite reset stops the run and snaps the value back to\n    // its construction-time value (loop() relies on this between iterations).\n    reset: () => {\n      value.resetAnimation()\n    },\n  }\n}\n"]}

package/dist/animated/value.d.ts

@@ -0,0 +1,46 @@
+import type { InterpolationConfig, InterpolationListener, ValueListener } from "./types";
+export type AnimationHandle = {
+    stop(): void;
+};
+type InterpolationParent = {
+    __getValue(): number | string;
+    addListener(listener: InterpolationListener): string;
+    removeListener(id: string): void;
+};
+export declare class AnimatedValue {
+    private _value;
+    private readonly _startingValue;
+    private readonly _listeners;
+    private _nextListenerId;
+    private _animation;
+    constructor(value: number);
+    setValue(value: number): void;
+    addListener(listener: ValueListener): string;
+    removeListener(id: string): void;
+    removeAllListeners(): void;
+    stopAnimation(callback?: (value: number) => void): void;
+    resetAnimation(callback?: (value: number) => void): void;
+    interpolate(config: InterpolationConfig): AnimatedInterpolation;
+    __getValue(): number;
+    /** @internal Called by the animation runner on every frame. */
+    __updateValue(value: number): void;
+    /** @internal Registers a running animation, preempting the previous one. */
+    __startAnimation(handle: AnimationHandle): void;
+    /** @internal */
+    __endAnimation(handle: AnimationHandle): void;
+}
+export declare class AnimatedInterpolation {
+    private readonly _parent;
+    private readonly _interpolator;
+    private readonly _listeners;
+    private _nextListenerId;
+    private _parentSubscription;
+    constructor(parent: InterpolationParent, config: InterpolationConfig);
+    __getValue(): number | string;
+    addListener(listener: InterpolationListener): string;
+    removeListener(id: string): void;
+    removeAllListeners(): void;
+    interpolate(config: InterpolationConfig): AnimatedInterpolation;
+    private _detachFromParent;
+}
+export {};

package/dist/animated/value.js

@@ -0,0 +1,130 @@
+// Animated.Value and the read-only interpolation node. Values are observable
+// numbers; the animation runner (value-animation.ts) drives them frame by
+// frame through the __-prefixed internal hooks. Interpolation nodes subscribe
+// to their parent lazily (only while they have listeners themselves) and can
+// be interpolated again, cascading from the parent's numeric value.
+import { createInterpolator } from "./interpolate";
+// Cascading from a string-producing parent ("45deg") interpolates over its
+// numeric part.
+const numeric = (value) => typeof value === "number" ? value : parseFloat(value);
+export class AnimatedValue {
+    _value;
+    _startingValue;
+    _listeners = new Map();
+    _nextListenerId = 1;
+    _animation = null;
+    constructor(value) {
+        this._value = value;
+        this._startingValue = value;
+    }
+    // Stops the running animation (its callback gets { finished: false }, as in
+    // RN) and jumps to the new value.
+    setValue(value) {
+        this._animation?.stop();
+        this.__updateValue(value);
+    }
+    addListener(listener) {
+        const id = String(this._nextListenerId++);
+        this._listeners.set(id, listener);
+        return id;
+    }
+    removeListener(id) {
+        this._listeners.delete(id);
+    }
+    removeAllListeners() {
+        this._listeners.clear();
+    }
+    // Stops the running animation where it stands and reports the current value
+    // to the callback. The stopped animation's own callback gets
+    // { finished: false }.
+    stopAnimation(callback) {
+        this._animation?.stop();
+        callback?.(this._value);
+    }
+    // Stops any running animation, then snaps back to the construction-time
+    // value. Unlike RN we do notify listeners about the snap-back: the direct
+    // GTK path renders from listener events, so a silent reset would leave
+    // widgets stale until the next animation frame.
+    resetAnimation(callback) {
+        this.stopAnimation(callback);
+        this.__updateValue(this._startingValue);
+    }
+    interpolate(config) {
+        return new AnimatedInterpolation(this, config);
+    }
+    __getValue() {
+        return this._value;
+    }
+    /** @internal Called by the animation runner on every frame. */
+    __updateValue(value) {
+        this._value = value;
+        for (const listener of [...this._listeners.values()]) {
+            listener({ value });
+        }
+    }
+    /** @internal Registers a running animation, preempting the previous one. */
+    __startAnimation(handle) {
+        const previous = this._animation;
+        this._animation = handle;
+        if (previous && previous !== handle) {
+            previous.stop();
+        }
+    }
+    /** @internal */
+    __endAnimation(handle) {
+        if (this._animation === handle) {
+            this._animation = null;
+        }
+    }
+}
+export class AnimatedInterpolation {
+    _parent;
+    _interpolator;
+    _listeners = new Map();
+    _nextListenerId = 1;
+    _parentSubscription = null;
+    constructor(parent, config) {
+        this._parent = parent;
+        this._interpolator = createInterpolator(config);
+    }
+    __getValue() {
+        return this._interpolator(numeric(this._parent.__getValue()));
+    }
+    addListener(listener) {
+        const id = String(this._nextListenerId++);
+        this._listeners.set(id, listener);
+        if (this._parentSubscription === null) {
+            // Lazy upstream subscription (same leak policy as the API emitters):
+            // attach with the first listener, detach with the last one.
+            this._parentSubscription = this._parent.addListener(({ value }) => {
+                const output = this._interpolator(numeric(value));
+                for (const entry of [...this._listeners.values()]) {
+                    entry({ value: output });
+                }
+            });
+        }
+        return id;
+    }
+    removeListener(id) {
+        if (!this._listeners.delete(id)) {
+            return;
+        }
+        if (this._listeners.size === 0) {
+            this._detachFromParent();
+        }
+    }
+    removeAllListeners() {
+        this._listeners.clear();
+        this._detachFromParent();
+    }
+    interpolate(config) {
+        return new AnimatedInterpolation(this, config);
+    }
+    _detachFromParent() {
+        if (this._parentSubscription !== null) {
+            this._parent.removeListener(this._parentSubscription);
+            this._parentSubscription = null;
+        }
+    }
+}
+//# sourceMappingURL=value.js.map

package/dist/animated/value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"value.js","sourceRoot":"","sources":["../../src/animated/value.ts"],"names":[],"mappings":"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","sourcesContent":["// Animated.Value and the read-only interpolation node. Values are observable\n// numbers; the animation runner (value-animation.ts) drives them frame by\n// frame through the __-prefixed internal hooks. Interpolation nodes subscribe\n// to their parent lazily (only while they have listeners themselves) and can\n// be interpolated again, cascading from the parent's numeric value.\n\nimport { createInterpolator } from \"./interpolate\"\nimport type {\n  InterpolationConfig,\n  InterpolationListener,\n  ValueListener,\n} from \"./types\"\n\n// Internal handle a running animation registers on its value; the value calls\n// stop() to preempt it when a newer animation (or setValue) takes over — the\n// preempted animation ends with { finished: false }, matching RN.\nexport type AnimationHandle = { stop(): void }\n\n// Minimal parent protocol shared by AnimatedValue and AnimatedInterpolation,\n// enabling cascaded interpolate() chains over either kind of node.\ntype InterpolationParent = {\n  __getValue(): number | string\n  addListener(listener: InterpolationListener): string\n  removeListener(id: string): void\n}\n\n// Cascading from a string-producing parent (\"45deg\") interpolates over its\n// numeric part.\nconst numeric = (value: number | string): number =>\n  typeof value === \"number\" ? value : parseFloat(value)\n\nexport class AnimatedValue {\n  private _value: number\n  private readonly _startingValue: number\n  private readonly _listeners = new Map<string, ValueListener>()\n  private _nextListenerId = 1\n  private _animation: AnimationHandle | null = null\n\n  constructor(value: number) {\n    this._value = value\n    this._startingValue = value\n  }\n\n  // Stops the running animation (its callback gets { finished: false }, as in\n  // RN) and jumps to the new value.\n  setValue(value: number): void {\n    this._animation?.stop()\n    this.__updateValue(value)\n  }\n\n  addListener(listener: ValueListener): string {\n    const id = String(this._nextListenerId++)\n    this._listeners.set(id, listener)\n    return id\n  }\n\n  removeListener(id: string): void {\n    this._listeners.delete(id)\n  }\n\n  removeAllListeners(): void {\n    this._listeners.clear()\n  }\n\n  // Stops the running animation where it stands and reports the current value\n  // to the callback. The stopped animation's own callback gets\n  // { finished: false }.\n  stopAnimation(callback?: (value: number) => void): void {\n    this._animation?.stop()\n    callback?.(this._value)\n  }\n\n  // Stops any running animation, then snaps back to the construction-time\n  // value. Unlike RN we do notify listeners about the snap-back: the direct\n  // GTK path renders from listener events, so a silent reset would leave\n  // widgets stale until the next animation frame.\n  resetAnimation(callback?: (value: number) => void): void {\n    this.stopAnimation(callback)\n    this.__updateValue(this._startingValue)\n  }\n\n  interpolate(config: InterpolationConfig): AnimatedInterpolation {\n    return new AnimatedInterpolation(this, config)\n  }\n\n  __getValue(): number {\n    return this._value\n  }\n\n  /** @internal Called by the animation runner on every frame. */\n  __updateValue(value: number): void {\n    this._value = value\n    for (const listener of [...this._listeners.values()]) {\n      listener({ value })\n    }\n  }\n\n  /** @internal Registers a running animation, preempting the previous one. */\n  __startAnimation(handle: AnimationHandle): void {\n    const previous = this._animation\n    this._animation = handle\n    if (previous && previous !== handle) {\n      previous.stop()\n    }\n  }\n\n  /** @internal */\n  __endAnimation(handle: AnimationHandle): void {\n    if (this._animation === handle) {\n      this._animation = null\n    }\n  }\n}\n\nexport class AnimatedInterpolation {\n  private readonly _parent: InterpolationParent\n  private readonly _interpolator: (input: number) => number | string\n  private readonly _listeners = new Map<string, InterpolationListener>()\n  private _nextListenerId = 1\n  private _parentSubscription: string | null = null\n\n  constructor(parent: InterpolationParent, config: InterpolationConfig) {\n    this._parent = parent\n    this._interpolator = createInterpolator(config)\n  }\n\n  __getValue(): number | string {\n    return this._interpolator(numeric(this._parent.__getValue()))\n  }\n\n  addListener(listener: InterpolationListener): string {\n    const id = String(this._nextListenerId++)\n    this._listeners.set(id, listener)\n    if (this._parentSubscription === null) {\n      // Lazy upstream subscription (same leak policy as the API emitters):\n      // attach with the first listener, detach with the last one.\n      this._parentSubscription = this._parent.addListener(({ value }) => {\n        const output = this._interpolator(numeric(value))\n        for (const entry of [...this._listeners.values()]) {\n          entry({ value: output })\n        }\n      })\n    }\n    return id\n  }\n\n  removeListener(id: string): void {\n    if (!this._listeners.delete(id)) {\n      return\n    }\n    if (this._listeners.size === 0) {\n      this._detachFromParent()\n    }\n  }\n\n  removeAllListeners(): void {\n    this._listeners.clear()\n    this._detachFromParent()\n  }\n\n  interpolate(config: InterpolationConfig): AnimatedInterpolation {\n    return new AnimatedInterpolation(this, config)\n  }\n\n  private _detachFromParent(): void {\n    if (this._parentSubscription !== null) {\n      this._parent.removeListener(this._parentSubscription)\n      this._parentSubscription = null\n    }\n  }\n}\n"]}

package/dist/apis/alert.d.ts

@@ -0,0 +1,16 @@
+import type { AlertButtonStyle, AlertHost } from "./host";
+export type AlertButton = {
+    text?: string;
+    onPress?: (value?: string) => void;
+    isPreferred?: boolean;
+    style?: AlertButtonStyle;
+};
+export type AlertOptions = {
+    cancelable?: boolean;
+    onDismiss?: () => void;
+    userInterfaceStyle?: "unspecified" | "light" | "dark";
+};
+export declare const createAlert: (host: AlertHost) => {
+    alert: (title: string, message?: string, buttons?: AlertButton[], options?: AlertOptions) => void;
+};
+export type AlertModule = ReturnType<typeof createAlert>;

package/dist/apis/alert.js

@@ -0,0 +1,33 @@
+export const createAlert = (host) => {
+    // Fire-and-forget like react-native's Alert.alert: the pressed button's
+    // onPress (or options.onDismiss) is called when the dialog resolves.
+    const alert = (title, message, buttons, options) => {
+        const effective = buttons !== undefined && buttons.length > 0 ? buttons : [{ text: "OK" }];
+        const hostButtons = effective.map((button, index) => ({
+            id: String(index),
+            label: button.text ?? "",
+            style: button.style ?? "default",
+            isPreferred: button.isPreferred ?? false,
+        }));
+        void host
+            .showAlert({
+            title,
+            message,
+            buttons: hostButtons,
+            cancelable: options?.cancelable ?? true,
+        })
+            .then((responseId) => {
+            const pressed = responseId === null ? undefined : effective[Number(responseId)];
+            if (pressed) {
+                pressed.onPress?.();
+                return;
+            }
+            options?.onDismiss?.();
+        })
+            .catch((error) => {
+            console.error("[react-native-gtkx] Alert.alert failed:", error);
+        });
+    };
+    return { alert };
+};
+//# sourceMappingURL=alert.js.map

package/dist/apis/alert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alert.js","sourceRoot":"","sources":["../../src/apis/alert.ts"],"names":[],"mappings":"AAiBA,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAe,EAAE,EAAE;IAC7C,wEAAwE;IACxE,qEAAqE;IACrE,MAAM,KAAK,GAAG,CACZ,KAAa,EACb,OAAgB,EAChB,OAAuB,EACvB,OAAsB,EAChB,EAAE;QACR,MAAM,SAAS,GACb,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QAC1E,MAAM,WAAW,GAAsB,SAAS,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YACvE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC;YACjB,KAAK,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;YACxB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,SAAS;YAChC,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,KAAK;SACzC,CAAC,CAAC,CAAA;QACH,KAAK,IAAI;aACN,SAAS,CAAC;YACT,KAAK;YACL,OAAO;YACP,OAAO,EAAE,WAAW;YACpB,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,IAAI;SACxC,CAAC;aACD,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE;YACnB,MAAM,OAAO,GACX,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAA;YACjE,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,OAAO,EAAE,EAAE,CAAA;gBACnB,OAAM;YACR,CAAC;YACD,OAAO,EAAE,SAAS,EAAE,EAAE,CAAA;QACxB,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACxB,OAAO,CAAC,KAAK,CAAC,yCAAyC,EAAE,KAAK,CAAC,CAAA;QACjE,CAAC,CAAC,CAAA;IACN,CAAC,CAAA;IAED,OAAO,EAAE,KAAK,EAAE,CAAA;AAClB,CAAC,CAAA","sourcesContent":["import type { AlertButtonStyle, AlertHost, HostAlertButton } from \"./host\"\n\nexport type AlertButton = {\n  text?: string\n  onPress?: (value?: string) => void\n  isPreferred?: boolean\n  style?: AlertButtonStyle\n}\n\nexport type AlertOptions = {\n  cancelable?: boolean\n  onDismiss?: () => void\n  // Accepted for react-native parity; ignored here — the theme is controlled\n  // globally via Appearance/AdwStyleManager.\n  userInterfaceStyle?: \"unspecified\" | \"light\" | \"dark\"\n}\n\nexport const createAlert = (host: AlertHost) => {\n  // Fire-and-forget like react-native's Alert.alert: the pressed button's\n  // onPress (or options.onDismiss) is called when the dialog resolves.\n  const alert = (\n    title: string,\n    message?: string,\n    buttons?: AlertButton[],\n    options?: AlertOptions,\n  ): void => {\n    const effective: AlertButton[] =\n      buttons !== undefined && buttons.length > 0 ? buttons : [{ text: \"OK\" }]\n    const hostButtons: HostAlertButton[] = effective.map((button, index) => ({\n      id: String(index),\n      label: button.text ?? \"\",\n      style: button.style ?? \"default\",\n      isPreferred: button.isPreferred ?? false,\n    }))\n    void host\n      .showAlert({\n        title,\n        message,\n        buttons: hostButtons,\n        cancelable: options?.cancelable ?? true,\n      })\n      .then((responseId) => {\n        const pressed =\n          responseId === null ? undefined : effective[Number(responseId)]\n        if (pressed) {\n          pressed.onPress?.()\n          return\n        }\n        options?.onDismiss?.()\n      })\n      .catch((error: unknown) => {\n        console.error(\"[react-native-gtkx] Alert.alert failed:\", error)\n      })\n  }\n\n  return { alert }\n}\n\nexport type AlertModule = ReturnType<typeof createAlert>\n"]}

package/dist/apis/app-state.d.ts

@@ -0,0 +1,11 @@
+import type { SubscriptionHandle } from "../contracts";
+import type { AppStateHost } from "./host";
+export type AppStateStatus = "active" | "background";
+export type AppStateEvent = "change" | "focus" | "blur";
+export type AppStateHandler = (state: AppStateStatus) => void;
+export declare const createAppState: (host: AppStateHost) => {
+    isAvailable: true;
+    readonly currentState: AppStateStatus;
+    addEventListener: (type: AppStateEvent, handler: AppStateHandler) => SubscriptionHandle;
+};
+export type AppStateModule = ReturnType<typeof createAppState>;

package/dist/apis/app-state.js

@@ -0,0 +1,54 @@
+const EVENT_TYPES = ["change", "focus", "blur"];
+export const createAppState = (host) => {
+    const entries = new Set();
+    let hostSubscription = null;
+    let tracked = null;
+    const compute = () => host.isActive() ? "active" : "background";
+    const onHostChange = () => {
+        const next = compute();
+        if (next === tracked) {
+            return;
+        }
+        tracked = next;
+        for (const entry of [...entries]) {
+            if (entry.type === "change" ||
+                (entry.type === "focus" && next === "active") ||
+                (entry.type === "blur" && next === "background")) {
+                entry.handler(next);
+            }
+        }
+    };
+    const addEventListener = (type, handler) => {
+        if (!EVENT_TYPES.includes(type)) {
+            throw new Error(`AppState.addEventListener: unsupported event type "${String(type)}"`);
+        }
+        const entry = { type, handler };
+        entries.add(entry);
+        if (entries.size === 1) {
+            tracked = compute();
+            hostSubscription = host.onActiveChange(onHostChange);
+        }
+        return {
+            remove: () => {
+                if (!entries.delete(entry)) {
+                    return;
+                }
+                if (entries.size === 0) {
+                    hostSubscription?.remove();
+                    hostSubscription = null;
+                    tracked = null;
+                }
+            },
+        };
+    };
+    return {
+        isAvailable: true,
+        // Event-driven while at least one listener is attached, computed live
+        // from the host otherwise.
+        get currentState() {
+            return tracked ?? compute();
+        },
+        addEventListener,
+    };
+};
+//# sourceMappingURL=app-state.js.map

package/dist/apis/app-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-state.js","sourceRoot":"","sources":["../../src/apis/app-state.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,GAA6B,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;AAEzE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAkB,EAAE,EAAE;IAGnD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAS,CAAA;IAChC,IAAI,gBAAgB,GAA8B,IAAI,CAAA;IACtD,IAAI,OAAO,GAA0B,IAAI,CAAA;IAEzC,MAAM,OAAO,GAAG,GAAmB,EAAE,CACnC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAA;IAE3C,MAAM,YAAY,GAAG,GAAS,EAAE;QAC9B,MAAM,IAAI,GAAG,OAAO,EAAE,CAAA;QACtB,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACrB,OAAM;QACR,CAAC;QACD,OAAO,GAAG,IAAI,CAAA;QACd,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC;YACjC,IACE,KAAK,CAAC,IAAI,KAAK,QAAQ;gBACvB,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,QAAQ,CAAC;gBAC7C,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,YAAY,CAAC,EAChD,CAAC;gBACD,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;YACrB,CAAC;QACH,CAAC;IACH,CAAC,CAAA;IAED,MAAM,gBAAgB,GAAG,CACvB,IAAmB,EACnB,OAAwB,EACJ,EAAE;QACtB,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,sDAAsD,MAAM,CAAC,IAAI,CAAC,GAAG,CACtE,CAAA;QACH,CAAC;QACD,MAAM,KAAK,GAAU,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;QACtC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAClB,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,GAAG,OAAO,EAAE,CAAA;YACnB,gBAAgB,GAAG,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,CAAA;QACtD,CAAC;QACD,OAAO;YACL,MAAM,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC3B,OAAM;gBACR,CAAC;gBACD,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;oBACvB,gBAAgB,EAAE,MAAM,EAAE,CAAA;oBAC1B,gBAAgB,GAAG,IAAI,CAAA;oBACvB,OAAO,GAAG,IAAI,CAAA;gBAChB,CAAC;YACH,CAAC;SACF,CAAA;IACH,CAAC,CAAA;IAED,OAAO;QACL,WAAW,EAAE,IAAa;QAC1B,sEAAsE;QACtE,2BAA2B;QAC3B,IAAI,YAAY;YACd,OAAO,OAAO,IAAI,OAAO,EAAE,CAAA;QAC7B,CAAC;QACD,gBAAgB;KACjB,CAAA;AACH,CAAC,CAAA","sourcesContent":["import type { SubscriptionHandle } from \"../contracts\"\nimport type { AppStateHost } from \"./host\"\n\n// Desktop windows are either focused or not: the RN \"inactive\" transitional\n// state has no GTK equivalent, so the surface is the active/background pair.\nexport type AppStateStatus = \"active\" | \"background\"\n\nexport type AppStateEvent = \"change\" | \"focus\" | \"blur\"\n\nexport type AppStateHandler = (state: AppStateStatus) => void\n\nconst EVENT_TYPES: readonly AppStateEvent[] = [\"change\", \"focus\", \"blur\"]\n\nexport const createAppState = (host: AppStateHost) => {\n  type Entry = { type: AppStateEvent; handler: AppStateHandler }\n\n  const entries = new Set<Entry>()\n  let hostSubscription: SubscriptionHandle | null = null\n  let tracked: AppStateStatus | null = null\n\n  const compute = (): AppStateStatus =>\n    host.isActive() ? \"active\" : \"background\"\n\n  const onHostChange = (): void => {\n    const next = compute()\n    if (next === tracked) {\n      return\n    }\n    tracked = next\n    for (const entry of [...entries]) {\n      if (\n        entry.type === \"change\" ||\n        (entry.type === \"focus\" && next === \"active\") ||\n        (entry.type === \"blur\" && next === \"background\")\n      ) {\n        entry.handler(next)\n      }\n    }\n  }\n\n  const addEventListener = (\n    type: AppStateEvent,\n    handler: AppStateHandler,\n  ): SubscriptionHandle => {\n    if (!EVENT_TYPES.includes(type)) {\n      throw new Error(\n        `AppState.addEventListener: unsupported event type \"${String(type)}\"`,\n      )\n    }\n    const entry: Entry = { type, handler }\n    entries.add(entry)\n    if (entries.size === 1) {\n      tracked = compute()\n      hostSubscription = host.onActiveChange(onHostChange)\n    }\n    return {\n      remove: () => {\n        if (!entries.delete(entry)) {\n          return\n        }\n        if (entries.size === 0) {\n          hostSubscription?.remove()\n          hostSubscription = null\n          tracked = null\n        }\n      },\n    }\n  }\n\n  return {\n    isAvailable: true as const,\n    // Event-driven while at least one listener is attached, computed live\n    // from the host otherwise.\n    get currentState(): AppStateStatus {\n      return tracked ?? compute()\n    },\n    addEventListener,\n  }\n}\n\nexport type AppStateModule = ReturnType<typeof createAppState>\n"]}

package/dist/apis/appearance.d.ts

@@ -0,0 +1,12 @@
+import type { SubscriptionHandle } from "../contracts";
+import type { AppearanceHost, ColorSchemeName } from "./host";
+export type AppearancePreferences = {
+    colorScheme: ColorSchemeName;
+};
+export type AppearanceChangeHandler = (preferences: AppearancePreferences) => void;
+export declare const createAppearance: (host: AppearanceHost) => {
+    getColorScheme: () => ColorSchemeName;
+    setColorScheme: (scheme: ColorSchemeName | null | undefined) => void;
+    addChangeListener: (handler: AppearanceChangeHandler) => SubscriptionHandle;
+};
+export type AppearanceModule = ReturnType<typeof createAppearance>;