react-native-gtkx 0.1.0-alpha.1

package/dist/apis/appearance.js

@@ -0,0 +1,33 @@
+import { createSharedEmitter } from "./emitter";
+export const createAppearance = (host) => {
+    let lastEmitted = null;
+    const emitter = createSharedEmitter(() => {
+        lastEmitted = host.getColorScheme();
+        const subscription = host.onColorSchemeChange(() => {
+            const colorScheme = host.getColorScheme();
+            if (colorScheme === lastEmitted) {
+                return;
+            }
+            lastEmitted = colorScheme;
+            emitter.emit({ colorScheme });
+        });
+        return () => {
+            subscription.remove();
+            lastEmitted = null;
+        };
+    });
+    return {
+        // Always resolved to "light" | "dark" (never null): Adwaita reports an
+        // effective scheme even while following the system preference.
+        getColorScheme: () => host.getColorScheme(),
+        // Implemented for real (not a no-op): forces the scheme app-wide through
+        // AdwStyleManager (FORCE_LIGHT / FORCE_DARK); null or undefined returns
+        // to following the system preference. Listeners fire via the resulting
+        // host change notification.
+        setColorScheme: (scheme) => {
+            host.setColorScheme(scheme ?? null);
+        },
+        addChangeListener: (handler) => emitter.add(handler),
+    };
+};
+//# sourceMappingURL=appearance.js.map

package/dist/apis/appearance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appearance.js","sourceRoot":"","sources":["../../src/apis/appearance.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAS/C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAoB,EAAE,EAAE;IACvD,IAAI,WAAW,GAA2B,IAAI,CAAA;IAE9C,MAAM,OAAO,GAAG,mBAAmB,CAA0B,GAAG,EAAE;QAChE,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,CAAA;QACnC,MAAM,YAAY,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,EAAE;YACjD,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,CAAA;YACzC,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;gBAChC,OAAM;YACR,CAAC;YACD,WAAW,GAAG,WAAW,CAAA;YACzB,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC,CAAA;QAC/B,CAAC,CAAC,CAAA;QACF,OAAO,GAAG,EAAE;YACV,YAAY,CAAC,MAAM,EAAE,CAAA;YACrB,WAAW,GAAG,IAAI,CAAA;QACpB,CAAC,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,OAAO;QACL,uEAAuE;QACvE,+DAA+D;QAC/D,cAAc,EAAE,GAAoB,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE;QAC5D,yEAAyE;QACzE,wEAAwE;QACxE,uEAAuE;QACvE,4BAA4B;QAC5B,cAAc,EAAE,CAAC,MAA0C,EAAQ,EAAE;YACnE,IAAI,CAAC,cAAc,CAAC,MAAM,IAAI,IAAI,CAAC,CAAA;QACrC,CAAC;QACD,iBAAiB,EAAE,CAAC,OAAgC,EAAsB,EAAE,CAC1E,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;KACvB,CAAA;AACH,CAAC,CAAA","sourcesContent":["import type { SubscriptionHandle } from \"../contracts\"\nimport { createSharedEmitter } from \"./emitter\"\nimport type { AppearanceHost, ColorSchemeName } from \"./host\"\n\nexport type AppearancePreferences = { colorScheme: ColorSchemeName }\n\nexport type AppearanceChangeHandler = (\n  preferences: AppearancePreferences,\n) => void\n\nexport const createAppearance = (host: AppearanceHost) => {\n  let lastEmitted: ColorSchemeName | null = null\n\n  const emitter = createSharedEmitter<[AppearancePreferences]>(() => {\n    lastEmitted = host.getColorScheme()\n    const subscription = host.onColorSchemeChange(() => {\n      const colorScheme = host.getColorScheme()\n      if (colorScheme === lastEmitted) {\n        return\n      }\n      lastEmitted = colorScheme\n      emitter.emit({ colorScheme })\n    })\n    return () => {\n      subscription.remove()\n      lastEmitted = null\n    }\n  })\n\n  return {\n    // Always resolved to \"light\" | \"dark\" (never null): Adwaita reports an\n    // effective scheme even while following the system preference.\n    getColorScheme: (): ColorSchemeName => host.getColorScheme(),\n    // Implemented for real (not a no-op): forces the scheme app-wide through\n    // AdwStyleManager (FORCE_LIGHT / FORCE_DARK); null or undefined returns\n    // to following the system preference. Listeners fire via the resulting\n    // host change notification.\n    setColorScheme: (scheme: ColorSchemeName | null | undefined): void => {\n      host.setColorScheme(scheme ?? null)\n    },\n    addChangeListener: (handler: AppearanceChangeHandler): SubscriptionHandle =>\n      emitter.add(handler),\n  }\n}\n\nexport type AppearanceModule = ReturnType<typeof createAppearance>\n"]}

package/dist/apis/dev-settings.d.ts

@@ -0,0 +1,9 @@
+export declare const DevSettings: {
+    /**
+     * Adds an entry to the Dev Menu. Registering the same title again
+     * replaces the previous handler (RN semantics).
+     */
+    addMenuItem(title: string, handler: () => void): void;
+    /** Reloads the application (dev mode only; a no-op in release). */
+    reload(reason?: string): void;
+};

package/dist/apis/dev-settings.js

@@ -0,0 +1,25 @@
+// RN DevSettings for the linux platform. In dev mode (`run-linux --dev`)
+// the dev host installs the reload hook and shows registered items in the
+// Dev Menu (Ctrl+Shift+D); in release builds neither exists, so every call
+// is a silent no-op — the same contract as RN release builds. The globals
+// are declared in ../runner/globals.d.ts (the host↔bundle bridge).
+export const DevSettings = {
+    /**
+     * Adds an entry to the Dev Menu. Registering the same title again
+     * replaces the previous handler (RN semantics).
+     */
+    addMenuItem(title, handler) {
+        const items = (globalThis.__rnGtkxDevMenuItems ??= []);
+        const existing = items.findIndex((item) => item.title === title);
+        if (existing >= 0) {
+            items[existing] = { title, handler };
+            return;
+        }
+        items.push({ title, handler });
+    },
+    /** Reloads the application (dev mode only; a no-op in release). */
+    reload(reason) {
+        globalThis.__rnGtkxDevHost?.reload(reason);
+    },
+};
+//# sourceMappingURL=dev-settings.js.map

package/dist/apis/dev-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-settings.js","sourceRoot":"","sources":["../../src/apis/dev-settings.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,0EAA0E;AAC1E,2EAA2E;AAC3E,0EAA0E;AAC1E,mEAAmE;AAEnE,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB;;;OAGG;IACH,WAAW,CAAC,KAAa,EAAE,OAAmB;QAC5C,MAAM,KAAK,GAAG,CAAC,UAAU,CAAC,oBAAoB,KAAK,EAAE,CAAC,CAAA;QACtD,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,CAAA;QAChE,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;YAClB,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;YACpC,OAAM;QACR,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;IAChC,CAAC;IAED,mEAAmE;IACnE,MAAM,CAAC,MAAe;QACpB,UAAU,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;IAC5C,CAAC;CACF,CAAA","sourcesContent":["// RN DevSettings for the linux platform. In dev mode (`run-linux --dev`)\n// the dev host installs the reload hook and shows registered items in the\n// Dev Menu (Ctrl+Shift+D); in release builds neither exists, so every call\n// is a silent no-op — the same contract as RN release builds. The globals\n// are declared in ../runner/globals.d.ts (the host↔bundle bridge).\n\nexport const DevSettings = {\n  /**\n   * Adds an entry to the Dev Menu. Registering the same title again\n   * replaces the previous handler (RN semantics).\n   */\n  addMenuItem(title: string, handler: () => void): void {\n    const items = (globalThis.__rnGtkxDevMenuItems ??= [])\n    const existing = items.findIndex((item) => item.title === title)\n    if (existing >= 0) {\n      items[existing] = { title, handler }\n      return\n    }\n    items.push({ title, handler })\n  },\n\n  /** Reloads the application (dev mode only; a no-op in release). */\n  reload(reason?: string): void {\n    globalThis.__rnGtkxDevHost?.reload(reason)\n  },\n}\n"]}

package/dist/apis/dimensions.d.ts

@@ -0,0 +1,14 @@
+import type { SubscriptionHandle } from "../contracts";
+import type { DimensionsHost, ScaledSize } from "./host";
+export type DimensionKey = "window" | "screen";
+export type DimensionsPayload = {
+    window: ScaledSize;
+    screen: ScaledSize;
+};
+export type DimensionsChangeHandler = (payload: DimensionsPayload) => void;
+export declare const createDimensions: (host: DimensionsHost) => {
+    get: (key: DimensionKey) => ScaledSize;
+    set: (dimensions: Partial<Record<DimensionKey, Partial<ScaledSize>>>) => void;
+    addEventListener: (type: "change", handler: DimensionsChangeHandler) => SubscriptionHandle;
+};
+export type DimensionsModule = ReturnType<typeof createDimensions>;

package/dist/apis/dimensions.js

@@ -0,0 +1,80 @@
+import { createSharedEmitter } from "./emitter";
+const sameSize = (a, b) => a.width === b.width &&
+    a.height === b.height &&
+    a.scale === b.scale &&
+    a.fontScale === b.fontScale;
+export const createDimensions = (host) => {
+    const cache = {
+        window: null,
+        screen: null,
+    };
+    // Reads through to the host while keeping object identity stable when the
+    // values are unchanged (required by the useSyncExternalStore snapshot
+    // contract in useWindowDimensions).
+    const refresh = (key) => {
+        const next = key === "window" ? host.getWindowMetrics() : host.getScreenMetrics();
+        const previous = cache[key];
+        if (previous && sameSize(previous, next)) {
+            return previous;
+        }
+        cache[key] = next;
+        return next;
+    };
+    const emitter = createSharedEmitter(() => {
+        // Prime the cache when going live so the first host event can diff.
+        refresh("window");
+        refresh("screen");
+        const subscription = host.onMetricsChange(() => {
+            const previousWindow = cache.window;
+            const previousScreen = cache.screen;
+            const window = refresh("window");
+            const screen = refresh("screen");
+            if (window !== previousWindow || screen !== previousScreen) {
+                emitter.emit({ window, screen });
+            }
+        });
+        return () => subscription.remove();
+    });
+    const get = (key) => {
+        if (key !== "window" && key !== "screen") {
+            throw new Error(`Dimensions.get: unknown dimension "${String(key)}"`);
+        }
+        // While subscribed the cache is kept fresh by host events; when idle we
+        // read through to the host on every call.
+        if (emitter.hasListeners()) {
+            return cache[key] ?? refresh(key);
+        }
+        return refresh(key);
+    };
+    // react-native parity escape hatch (RN uses it for bootstrap/tests): merges
+    // overrides into the cached values and notifies listeners. The next host
+    // read or resize event replaces the override with real metrics.
+    const set = (dimensions) => {
+        let changed = false;
+        for (const key of ["window", "screen"]) {
+            const patch = dimensions[key];
+            if (!patch) {
+                continue;
+            }
+            const base = cache[key] ?? refresh(key);
+            const next = { ...base, ...patch };
+            if (!sameSize(base, next)) {
+                cache[key] = next;
+                changed = true;
+            }
+        }
+        if (changed) {
+            const window = cache.window ?? refresh("window");
+            const screen = cache.screen ?? refresh("screen");
+            emitter.emit({ window, screen });
+        }
+    };
+    const addEventListener = (type, handler) => {
+        if (type !== "change") {
+            throw new Error(`Dimensions.addEventListener: unsupported event type "${String(type)}"`);
+        }
+        return emitter.add(handler);
+    };
+    return { get, set, addEventListener };
+};
+//# sourceMappingURL=dimensions.js.map

package/dist/apis/dimensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimensions.js","sourceRoot":"","sources":["../../src/apis/dimensions.ts"],"names":[],"mappings":"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","sourcesContent":["import type { SubscriptionHandle } from \"../contracts\"\nimport { createSharedEmitter } from \"./emitter\"\nimport type { DimensionsHost, ScaledSize } from \"./host\"\n\nexport type DimensionKey = \"window\" | \"screen\"\n\nexport type DimensionsPayload = { window: ScaledSize; screen: ScaledSize }\n\nexport type DimensionsChangeHandler = (payload: DimensionsPayload) => void\n\nconst sameSize = (a: ScaledSize, b: ScaledSize): boolean =>\n  a.width === b.width &&\n  a.height === b.height &&\n  a.scale === b.scale &&\n  a.fontScale === b.fontScale\n\nexport const createDimensions = (host: DimensionsHost) => {\n  const cache: Record<DimensionKey, ScaledSize | null> = {\n    window: null,\n    screen: null,\n  }\n\n  // Reads through to the host while keeping object identity stable when the\n  // values are unchanged (required by the useSyncExternalStore snapshot\n  // contract in useWindowDimensions).\n  const refresh = (key: DimensionKey): ScaledSize => {\n    const next =\n      key === \"window\" ? host.getWindowMetrics() : host.getScreenMetrics()\n    const previous = cache[key]\n    if (previous && sameSize(previous, next)) {\n      return previous\n    }\n    cache[key] = next\n    return next\n  }\n\n  const emitter = createSharedEmitter<[DimensionsPayload]>(() => {\n    // Prime the cache when going live so the first host event can diff.\n    refresh(\"window\")\n    refresh(\"screen\")\n    const subscription = host.onMetricsChange(() => {\n      const previousWindow = cache.window\n      const previousScreen = cache.screen\n      const window = refresh(\"window\")\n      const screen = refresh(\"screen\")\n      if (window !== previousWindow || screen !== previousScreen) {\n        emitter.emit({ window, screen })\n      }\n    })\n    return () => subscription.remove()\n  })\n\n  const get = (key: DimensionKey): ScaledSize => {\n    if (key !== \"window\" && key !== \"screen\") {\n      throw new Error(`Dimensions.get: unknown dimension \"${String(key)}\"`)\n    }\n    // While subscribed the cache is kept fresh by host events; when idle we\n    // read through to the host on every call.\n    if (emitter.hasListeners()) {\n      return cache[key] ?? refresh(key)\n    }\n    return refresh(key)\n  }\n\n  // react-native parity escape hatch (RN uses it for bootstrap/tests): merges\n  // overrides into the cached values and notifies listeners. The next host\n  // read or resize event replaces the override with real metrics.\n  const set = (\n    dimensions: Partial<Record<DimensionKey, Partial<ScaledSize>>>,\n  ): void => {\n    let changed = false\n    for (const key of [\"window\", \"screen\"] as const) {\n      const patch = dimensions[key]\n      if (!patch) {\n        continue\n      }\n      const base = cache[key] ?? refresh(key)\n      const next = { ...base, ...patch }\n      if (!sameSize(base, next)) {\n        cache[key] = next\n        changed = true\n      }\n    }\n    if (changed) {\n      const window = cache.window ?? refresh(\"window\")\n      const screen = cache.screen ?? refresh(\"screen\")\n      emitter.emit({ window, screen })\n    }\n  }\n\n  const addEventListener = (\n    type: \"change\",\n    handler: DimensionsChangeHandler,\n  ): SubscriptionHandle => {\n    if (type !== \"change\") {\n      throw new Error(\n        `Dimensions.addEventListener: unsupported event type \"${String(type)}\"`,\n      )\n    }\n    return emitter.add(handler)\n  }\n\n  return { get, set, addEventListener }\n}\n\nexport type DimensionsModule = ReturnType<typeof createDimensions>\n"]}

package/dist/apis/emitter.d.ts

@@ -0,0 +1,8 @@
+import type { SubscriptionHandle } from "../contracts";
+type Teardown = () => void;
+export declare const createSharedEmitter: <Args extends unknown[]>(onActive?: () => Teardown) => {
+    add: (handler: (...args: Args) => void) => SubscriptionHandle;
+    emit: (...args: Args) => void;
+    hasListeners: () => boolean;
+};
+export {};

package/dist/apis/emitter.js

@@ -0,0 +1,35 @@
+// Shared listener registry behind every addEventListener/addChangeListener.
+// Leak policy (documented across the API modules): the upstream host
+// subscription is attached lazily when the first listener arrives and torn
+// down when the last listener is removed, so idle modules hold no GTK signal
+// connections. remove() is idempotent and a removed handler is never invoked
+// again (emit iterates over a snapshot).
+export const createSharedEmitter = (onActive) => {
+    const listeners = new Set();
+    let teardown = null;
+    const add = (handler) => {
+        const entry = { handler };
+        listeners.add(entry);
+        if (listeners.size === 1 && onActive) {
+            teardown = onActive();
+        }
+        return {
+            remove: () => {
+                if (!listeners.delete(entry)) {
+                    return;
+                }
+                if (listeners.size === 0 && teardown) {
+                    teardown();
+                    teardown = null;
+                }
+            },
+        };
+    };
+    const emit = (...args) => {
+        for (const entry of [...listeners]) {
+            entry.handler(...args);
+        }
+    };
+    return { add, emit, hasListeners: () => listeners.size > 0 };
+};
+//# sourceMappingURL=emitter.js.map

package/dist/apis/emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../../src/apis/emitter.ts"],"names":[],"mappings":"AAIA,4EAA4E;AAC5E,qEAAqE;AACrE,2EAA2E;AAC3E,6EAA6E;AAC7E,6EAA6E;AAC7E,yCAAyC;AACzC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,QAAyB,EACzB,EAAE;IACF,MAAM,SAAS,GAAG,IAAI,GAAG,EAAwC,CAAA;IACjE,IAAI,QAAQ,GAAoB,IAAI,CAAA;IAEpC,MAAM,GAAG,GAAG,CAAC,OAAgC,EAAsB,EAAE;QACnE,MAAM,KAAK,GAAG,EAAE,OAAO,EAAE,CAAA;QACzB,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACpB,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,IAAI,QAAQ,EAAE,CAAC;YACrC,QAAQ,GAAG,QAAQ,EAAE,CAAA;QACvB,CAAC;QACD,OAAO;YACL,MAAM,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC7B,OAAM;gBACR,CAAC;gBACD,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,IAAI,QAAQ,EAAE,CAAC;oBACrC,QAAQ,EAAE,CAAA;oBACV,QAAQ,GAAG,IAAI,CAAA;gBACjB,CAAC;YACH,CAAC;SACF,CAAA;IACH,CAAC,CAAA;IAED,MAAM,IAAI,GAAG,CAAC,GAAG,IAAU,EAAQ,EAAE;QACnC,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC;YACnC,KAAK,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAA;QACxB,CAAC;IACH,CAAC,CAAA;IAED,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,EAAE,CAAA;AAC9D,CAAC,CAAA","sourcesContent":["import type { SubscriptionHandle } from \"../contracts\"\n\ntype Teardown = () => void\n\n// Shared listener registry behind every addEventListener/addChangeListener.\n// Leak policy (documented across the API modules): the upstream host\n// subscription is attached lazily when the first listener arrives and torn\n// down when the last listener is removed, so idle modules hold no GTK signal\n// connections. remove() is idempotent and a removed handler is never invoked\n// again (emit iterates over a snapshot).\nexport const createSharedEmitter = <Args extends unknown[]>(\n  onActive?: () => Teardown,\n) => {\n  const listeners = new Set<{ handler: (...args: Args) => void }>()\n  let teardown: Teardown | null = null\n\n  const add = (handler: (...args: Args) => void): SubscriptionHandle => {\n    const entry = { handler }\n    listeners.add(entry)\n    if (listeners.size === 1 && onActive) {\n      teardown = onActive()\n    }\n    return {\n      remove: () => {\n        if (!listeners.delete(entry)) {\n          return\n        }\n        if (listeners.size === 0 && teardown) {\n          teardown()\n          teardown = null\n        }\n      },\n    }\n  }\n\n  const emit = (...args: Args): void => {\n    for (const entry of [...listeners]) {\n      entry.handler(...args)\n    }\n  }\n\n  return { add, emit, hasListeners: () => listeners.size > 0 }\n}\n"]}

package/dist/apis/hooks.d.ts

@@ -0,0 +1,11 @@
+import type { AppearanceModule } from "./appearance";
+import type { DimensionsModule } from "./dimensions";
+import type { ColorSchemeName, ScaledSize } from "./host";
+export type ExternalStore<T> = {
+    subscribe: (onStoreChange: () => void) => () => void;
+    getSnapshot: () => T;
+};
+export declare const createWindowDimensionsStore: (dimensions: DimensionsModule) => ExternalStore<ScaledSize>;
+export declare const createColorSchemeStore: (appearance: AppearanceModule) => ExternalStore<ColorSchemeName>;
+export declare const createUseWindowDimensions: (dimensions: DimensionsModule) => () => ScaledSize;
+export declare const createUseColorScheme: (appearance: AppearanceModule) => () => ColorSchemeName;

package/dist/apis/hooks.js

@@ -0,0 +1,29 @@
+import { useSyncExternalStore } from "react";
+// The store pairs are exported separately so unit tests can exercise the
+// useSyncExternalStore contract (subscribe/getSnapshot/identity) directly,
+// without rendering React components.
+export const createWindowDimensionsStore = (dimensions) => ({
+    subscribe: (onStoreChange) => {
+        const subscription = dimensions.addEventListener("change", onStoreChange);
+        return () => subscription.remove();
+    },
+    getSnapshot: () => dimensions.get("window"),
+});
+export const createColorSchemeStore = (appearance) => ({
+    subscribe: (onStoreChange) => {
+        const subscription = appearance.addChangeListener(onStoreChange);
+        return () => subscription.remove();
+    },
+    getSnapshot: () => appearance.getColorScheme(),
+});
+export const createUseWindowDimensions = (dimensions) => {
+    const store = createWindowDimensionsStore(dimensions);
+    const useWindowDimensions = () => useSyncExternalStore(store.subscribe, store.getSnapshot);
+    return useWindowDimensions;
+};
+export const createUseColorScheme = (appearance) => {
+    const store = createColorSchemeStore(appearance);
+    const useColorScheme = () => useSyncExternalStore(store.subscribe, store.getSnapshot);
+    return useColorScheme;
+};
+//# sourceMappingURL=hooks.js.map

package/dist/apis/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/apis/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAA;AAU5C,yEAAyE;AACzE,2EAA2E;AAC3E,sCAAsC;AAEtC,MAAM,CAAC,MAAM,2BAA2B,GAAG,CACzC,UAA4B,EACD,EAAE,CAAC,CAAC;IAC/B,SAAS,EAAE,CAAC,aAAa,EAAE,EAAE;QAC3B,MAAM,YAAY,GAAG,UAAU,CAAC,gBAAgB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAA;QACzE,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,CAAA;IACpC,CAAC;IACD,WAAW,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC;CAC5C,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,UAA4B,EACI,EAAE,CAAC,CAAC;IACpC,SAAS,EAAE,CAAC,aAAa,EAAE,EAAE;QAC3B,MAAM,YAAY,GAAG,UAAU,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAA;QAChE,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,CAAA;IACpC,CAAC;IACD,WAAW,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,cAAc,EAAE;CAC/C,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,UAA4B,EAAE,EAAE;IACxE,MAAM,KAAK,GAAG,2BAA2B,CAAC,UAAU,CAAC,CAAA;IACrD,MAAM,mBAAmB,GAAG,GAAe,EAAE,CAC3C,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,WAAW,CAAC,CAAA;IAC1D,OAAO,mBAAmB,CAAA;AAC5B,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,UAA4B,EAAE,EAAE;IACnE,MAAM,KAAK,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAA;IAChD,MAAM,cAAc,GAAG,GAAoB,EAAE,CAC3C,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,WAAW,CAAC,CAAA;IAC1D,OAAO,cAAc,CAAA;AACvB,CAAC,CAAA","sourcesContent":["import { useSyncExternalStore } from \"react\"\nimport type { AppearanceModule } from \"./appearance\"\nimport type { DimensionsModule } from \"./dimensions\"\nimport type { ColorSchemeName, ScaledSize } from \"./host\"\n\nexport type ExternalStore<T> = {\n  subscribe: (onStoreChange: () => void) => () => void\n  getSnapshot: () => T\n}\n\n// The store pairs are exported separately so unit tests can exercise the\n// useSyncExternalStore contract (subscribe/getSnapshot/identity) directly,\n// without rendering React components.\n\nexport const createWindowDimensionsStore = (\n  dimensions: DimensionsModule,\n): ExternalStore<ScaledSize> => ({\n  subscribe: (onStoreChange) => {\n    const subscription = dimensions.addEventListener(\"change\", onStoreChange)\n    return () => subscription.remove()\n  },\n  getSnapshot: () => dimensions.get(\"window\"),\n})\n\nexport const createColorSchemeStore = (\n  appearance: AppearanceModule,\n): ExternalStore<ColorSchemeName> => ({\n  subscribe: (onStoreChange) => {\n    const subscription = appearance.addChangeListener(onStoreChange)\n    return () => subscription.remove()\n  },\n  getSnapshot: () => appearance.getColorScheme(),\n})\n\nexport const createUseWindowDimensions = (dimensions: DimensionsModule) => {\n  const store = createWindowDimensionsStore(dimensions)\n  const useWindowDimensions = (): ScaledSize =>\n    useSyncExternalStore(store.subscribe, store.getSnapshot)\n  return useWindowDimensions\n}\n\nexport const createUseColorScheme = (appearance: AppearanceModule) => {\n  const store = createColorSchemeStore(appearance)\n  const useColorScheme = (): ColorSchemeName =>\n    useSyncExternalStore(store.subscribe, store.getSnapshot)\n  return useColorScheme\n}\n"]}

package/dist/apis/host.d.ts

@@ -0,0 +1,45 @@
+import type { SubscriptionHandle } from "../contracts";
+export type ColorSchemeName = "light" | "dark";
+export type ScaledSize = {
+    width: number;
+    height: number;
+    scale: number;
+    fontScale: number;
+};
+export type AlertButtonStyle = "default" | "cancel" | "destructive";
+export type HostAlertButton = {
+    id: string;
+    label: string;
+    style: AlertButtonStyle;
+    isPreferred: boolean;
+};
+export type HostAlertRequest = {
+    title: string;
+    message?: string;
+    buttons: HostAlertButton[];
+    cancelable: boolean;
+};
+export interface PlatformHost {
+    gtkVersion(): string;
+}
+export interface DimensionsHost {
+    getWindowMetrics(): ScaledSize;
+    getScreenMetrics(): ScaledSize;
+    onMetricsChange(notify: () => void): SubscriptionHandle;
+}
+export interface AppearanceHost {
+    getColorScheme(): ColorSchemeName;
+    setColorScheme(scheme: ColorSchemeName | null): void;
+    onColorSchemeChange(notify: () => void): SubscriptionHandle;
+}
+export interface AppStateHost {
+    isActive(): boolean;
+    onActiveChange(notify: () => void): SubscriptionHandle;
+}
+export interface AlertHost {
+    showAlert(request: HostAlertRequest): Promise<string | null>;
+}
+export interface LinkingHost {
+    launchUri(uri: string): Promise<void>;
+}
+export type Host = PlatformHost & DimensionsHost & AppearanceHost & AppStateHost & AlertHost & LinkingHost;

package/dist/apis/host.gtkx.d.ts

@@ -0,0 +1,2 @@
+import type { Host } from "./host";
+export declare const gtkxHost: Host;

package/dist/apis/host.gtkx.js

@@ -0,0 +1,301 @@
+// Production host adapter: the ONLY module under src/apis/ allowed to import
+// the gtkx bridge. Everything GTK-specific lives here; the API modules stay
+// pure and receive this object (or a mock in unit tests) via injection.
+import { Adw, colorScheme, Gdk, Gio, Gtk, styleManager, toNumber, } from "../gtkx/bridge/index";
+const FALLBACK_METRICS = {
+    width: 0,
+    height: 0,
+    scale: 1,
+    fontScale: 1,
+};
+const getApplication = () => Gio.Application.getDefault();
+const getActiveAppWindow = () => {
+    const app = getApplication();
+    if (!app || typeof app.getActiveWindow !== "function") {
+        return null;
+    }
+    return app.getActiveWindow() ?? null;
+};
+const windowAt = (model, index) => model.getItem(index);
+// The application's active window if any, otherwise the first toplevel. The
+// toplevel fallback covers the test harness, where windows exist without a
+// GtkApplication (`Gio.Application.getDefault()` is null there).
+// RN's Dimensions("window") means the MAIN window: transient toplevels
+// (Modal → modal GtkWindow, dialogs) must never be resolved as "the window" —
+// an open modal becomes the active window and would shrink the app viewport
+// to the modal size.
+const isMainWindow = (window) => window.getTransientFor() === null;
+const resolveWindow = () => {
+    const active = getActiveAppWindow();
+    if (active && isMainWindow(active)) {
+        return active;
+    }
+    const toplevels = Gtk.Window.getToplevels();
+    const count = toNumber(toplevels.getNItems());
+    let first = null;
+    for (let index = 0; index < count; index += 1) {
+        const window = windowAt(toplevels, index);
+        if (!window || !isMainWindow(window)) {
+            continue;
+        }
+        if (window.isActive()) {
+            return window;
+        }
+        first = first ?? window;
+    }
+    return first;
+};
+const isAnyWindowActive = () => {
+    const toplevels = Gtk.Window.getToplevels();
+    const count = toNumber(toplevels.getNItems());
+    for (let index = 0; index < count; index += 1) {
+        if (windowAt(toplevels, index)?.isActive()) {
+            return true;
+        }
+    }
+    return false;
+};
+const windowMetrics = () => {
+    const window = resolveWindow();
+    if (!window) {
+        return FALLBACK_METRICS;
+    }
+    // RN's Dimensions("window") is the app viewport: the window CHILD's
+    // allocation (the content area under the headerbar), not the window widget
+    // size. Falls back to the window size before the first allocation.
+    const child = window.getChild();
+    const childAllocation = child?.getAllocation();
+    const allocatedWidth = childAllocation && childAllocation.width > 0
+        ? toNumber(childAllocation.width)
+        : toNumber(window.getWidth());
+    const allocatedHeight = childAllocation && childAllocation.height > 0
+        ? toNumber(childAllocation.height)
+        : toNumber(window.getHeight());
+    // Before the first allocation everything reports 0 — fall back to
+    // the requested default size (which GTK4 also keeps updated on resize).
+    const width = allocatedWidth > 0
+        ? allocatedWidth
+        : Math.max(toNumber(window.defaultWidth ?? 0), 0);
+    const height = allocatedHeight > 0
+        ? allocatedHeight
+        : Math.max(toNumber(window.defaultHeight ?? 0), 0);
+    return {
+        width,
+        height,
+        scale: toNumber(window.getScaleFactor()),
+        fontScale: 1,
+    };
+};
+const screenMetrics = () => {
+    const display = Gdk.Display.getDefault();
+    if (!display) {
+        return windowMetrics();
+    }
+    const monitors = display.getMonitors();
+    if (toNumber(monitors.getNItems()) === 0) {
+        return windowMetrics();
+    }
+    const monitor = monitors.getItem(0);
+    if (!monitor) {
+        return windowMetrics();
+    }
+    const geometry = monitor.getGeometry();
+    return {
+        width: toNumber(geometry.width),
+        height: toNumber(geometry.height),
+        scale: toNumber(monitor.getScaleFactor()),
+        fontScale: 1,
+    };
+};
+// GtkNative.getSurface is an interface method merged onto Gtk.Window at
+// runtime via mixins; accessed defensively to stay typecheckable either way.
+const surfaceOf = (window) => {
+    const native = window;
+    return typeof native.getSurface === "function"
+        ? (native.getSurface() ?? null)
+        : null;
+};
+// Tracks the "current" window across creation/destruction/focus moves:
+// listens on the given signals of the resolved window (and, when requested,
+// its GdkSurface) plus the toplevel list model, re-resolving and re-attaching
+// whenever the tracked window may have changed. Modules dedupe, so
+// over-notifying is fine.
+//
+// Why the surface: notify::default-width fires when setDefaultSize() is
+// called, i.e. before the compositor actually resizes the surface — the
+// allocated size (what Dimensions reports) only changes when the surface
+// does. And GdkSurface notify::width/height fires at configure time, still
+// before the widget allocation pass, so the "layout" signal is also needed:
+// it is emitted during the frame's layout phase and — because GTK's own
+// relayout handler is connected first — our handler observes the updated
+// allocation. The module dedupes, so early/no-op emissions cost nothing.
+const watchWindow = (windowSignals, surfaceSignals, notify) => {
+    let window = null;
+    let surface = null;
+    const attachWindow = () => {
+        if (!window) {
+            return;
+        }
+        for (const signal of windowSignals) {
+            window.on(signal, onSignal);
+        }
+    };
+    const detachWindow = () => {
+        if (!window) {
+            return;
+        }
+        for (const signal of windowSignals) {
+            window.off(signal, onSignal);
+        }
+    };
+    const attachSurface = () => {
+        if (!surface) {
+            return;
+        }
+        for (const signal of surfaceSignals) {
+            surface.on(signal, onSignal);
+        }
+    };
+    const detachSurface = () => {
+        if (!surface) {
+            return;
+        }
+        for (const signal of surfaceSignals) {
+            surface.off(signal, onSignal);
+        }
+    };
+    const syncTargets = () => {
+        const nextWindow = resolveWindow();
+        if (nextWindow !== window) {
+            detachWindow();
+            window = nextWindow;
+            attachWindow();
+        }
+        const nextSurface = window && surfaceSignals.length > 0 ? surfaceOf(window) : null;
+        if (nextSurface !== surface) {
+            detachSurface();
+            surface = nextSurface;
+            attachSurface();
+        }
+    };
+    const onSignal = () => {
+        syncTargets();
+        notify();
+    };
+    const toplevels = Gtk.Window.getToplevels();
+    const onToplevelsChanged = () => {
+        syncTargets();
+        notify();
+    };
+    toplevels.on("items-changed", onToplevelsChanged);
+    syncTargets();
+    return {
+        remove: () => {
+            detachWindow();
+            detachSurface();
+            window = null;
+            surface = null;
+            toplevels.off("items-changed", onToplevelsChanged);
+        },
+    };
+};
+// realize/map re-run target resolution so the surface listeners attach as
+// soon as the surface exists.
+const WINDOW_SIZE_SIGNALS = [
+    "notify::default-width",
+    "notify::default-height",
+    "realize",
+    "map",
+];
+const SURFACE_SIZE_SIGNALS = [
+    "notify::width",
+    "notify::height",
+    "layout",
+];
+const WINDOW_ACTIVE_SIGNALS = ["notify::is-active"];
+const gtkVersion = () => `${toNumber(Gtk.getMajorVersion())}.${toNumber(Gtk.getMinorVersion())}.${toNumber(Gtk.getMicroVersion())}`;
+const setColorScheme = (scheme) => {
+    const manager = styleManager();
+    if (scheme === "dark") {
+        manager.setColorScheme(Adw.ColorScheme.FORCE_DARK);
+    }
+    else if (scheme === "light") {
+        manager.setColorScheme(Adw.ColorScheme.FORCE_LIGHT);
+    }
+    else {
+        manager.setColorScheme(Adw.ColorScheme.DEFAULT);
+    }
+    // Our apps are GtkApplication (not AdwApplication), so Adwaita may not
+    // restyle widgets: duplicate the request through the classic GTK setting,
+    // which the theme always honors.
+    const settings = Gtk.Settings.getDefault();
+    if (settings) {
+        if (scheme === null) {
+            settings.resetProperty("gtk-application-prefer-dark-theme");
+        }
+        else {
+            settings.gtkApplicationPreferDarkTheme = scheme === "dark";
+        }
+    }
+};
+const onColorSchemeChange = (notify) => {
+    const manager = styleManager();
+    const listener = () => notify();
+    manager.on("notify::dark", listener);
+    return { remove: () => manager.off("notify::dark", listener) };
+};
+const showAlert = async (request) => {
+    const dialog = new Adw.AlertDialog();
+    dialog.setHeading(request.title);
+    if (request.message !== undefined && request.message.length > 0) {
+        dialog.setBody(request.message);
+    }
+    let closeResponse = null;
+    for (const button of request.buttons) {
+        dialog.addResponse(button.id, button.label);
+        if (button.style === "destructive") {
+            dialog.setResponseAppearance(button.id, Adw.ResponseAppearance.DESTRUCTIVE);
+        }
+        if (button.isPreferred) {
+            dialog.setResponseAppearance(button.id, Adw.ResponseAppearance.SUGGESTED);
+            dialog.setDefaultResponse(button.id);
+        }
+        if (button.style === "cancel") {
+            closeResponse = button.id;
+        }
+    }
+    if (closeResponse !== null) {
+        // Esc / close maps onto the cancel button, like RN's cancel semantics.
+        dialog.setCloseResponse(closeResponse);
+    }
+    else if (!request.cancelable) {
+        // No cancel button and not cancelable: block Esc-dismissal. Responses
+        // still close the dialog (they bypass the can-close guard).
+        dialog.setCanClose(false);
+    }
+    const response = await dialog.choose(resolveWindow());
+    // Anything that is not one of our buttons (e.g. the built-in "close"
+    // response) is a dismissal.
+    return request.buttons.some((button) => button.id === response)
+        ? response
+        : null;
+};
+const launchUri = async (uri) => {
+    const launcher = new Gtk.UriLauncher({ uri });
+    // Promisified by the gi codegen; rejects with the GError on failure.
+    await launcher.launch(resolveWindow());
+};
+export const gtkxHost = {
+    gtkVersion,
+    getWindowMetrics: windowMetrics,
+    getScreenMetrics: screenMetrics,
+    onMetricsChange: (notify) => watchWindow(WINDOW_SIZE_SIGNALS, SURFACE_SIZE_SIGNALS, notify),
+    getColorScheme: () => colorScheme(),
+    setColorScheme,
+    onColorSchemeChange,
+    isActive: isAnyWindowActive,
+    onActiveChange: (notify) => watchWindow(WINDOW_ACTIVE_SIGNALS, [], notify),
+    showAlert,
+    launchUri,
+};
+//# sourceMappingURL=host.gtkx.js.map