@gjsify/resolve-npm 0.48.0 → 0.49.0

package/lib/gi-renderers.mjs

@@ -0,0 +1,46 @@
+// WHICH PACKAGE ANSWERS `gi://Ns` ON A TARGET WITH NO GOBJECT INTROSPECTION — ADR 0034 stage 9.
+//
+// `gi://Gtk?version=4.0` is not a GJS-only specifier in this repository; it is the runtime
+// axis, and every target already resolves it: `--app gjs` takes the native protocol,
+// `--app node` a lazy `requireGi` proxy (`plugins/gjs-gi-node.ts`), and `--app browser` /
+// `--app nativescript` an EMPTY module. The empty one is the row this table changes: a
+// namespace substituted by `{}` makes `Adw.ActionRow` `undefined`, and
+// `class X extends undefined` is `Class extends value undefined`, thrown far from the
+// import that caused it.
+//
+// WHAT A RENDERER SUPPLIES. ADR 0034 clause 2 makes every widget surface export its widgets
+// through `Adw` / `Gtk` namespace OBJECTS, which is exactly the shape `gi://` evaluates to
+// on GJS — so the substitution is a re-export and not a translation layer.
+//
+// THE VERSIONS ARE A GIR FACT, NOT A RENDERER CHOICE. `Adw-1` and `Gtk-4.0` are the
+// namespace versions `@gjsify/gtk-host`'s generated widget table was built against; that
+// file stamps them in `GENERATED_PROVENANCE`, and `tests/e2e/gi-renderer-arms` holds this
+// table against that stamp. Two derivations, one written by a generator that never reads
+// this file.
+//
+// WHY A CURATED TABLE AND NOT A SCAN of `gjsify.widgetVocabulary`. The manifest declaration
+// says which SIDE of the vocabulary comparison a package is on (`reference` / `renderer`),
+// and there is more than one renderer per repo: `@gjsify/adwaita-react-native` declares
+// itself one too, and it is not this table's answer for any `--app` because Metro owns a
+// React Native build (root AGENTS.md § Runtime & platform model). Deriving the row from the
+// declaration would have to invent that exclusion anyway.
+
+/**
+ * `--app <target>` → the package whose `Adw` / `Gtk` namespace exports answer `gi://`, and
+ * the GIR namespace versions that arm accepts.
+ *
+ * @type {Readonly<Record<string, { renderer: string, namespaces: Readonly<Record<string, string>> }>>}
+ */
+export const GI_RENDERERS = {
+    browser: {
+        renderer: '@gjsify/adwaita-web',
+        namespaces: { Adw: '1', Gtk: '4.0' },
+    },
+    nativescript: {
+        renderer: '@gjsify/adwaita-nativescript',
+        namespaces: { Adw: '1', Gtk: '4.0' },
+    },
+};
+
+/** The `--app` values that have an arm, for a flag that must name them when refused. */
+export const GI_RENDERER_APPS = Object.freeze(Object.keys(GI_RENDERERS));

package/lib/index.d.ts

@@ -94,3 +94,17 @@ export declare function listDeclaredRuntimes(): Promise<
         }
     >
 >;
+
+/**
+ * `--app <target>` → the package whose `Adw` / `Gtk` namespace exports answer `gi://` on
+ * that target, and the GI namespace versions the arm accepts (ADR 0034 stage 9).
+ *
+ * A target absent from this record has no arm: `gi://*` there keeps resolving to the empty
+ * module, which is what every target but `gjs` and `node` did before the arms existed.
+ */
+export declare const GI_RENDERERS: Readonly<
+    Record<string, { renderer: string; namespaces: Readonly<Record<string, string>> }>
+>;
+
+/** The `--app` values {@link GI_RENDERERS} has a row for, so a refused flag can name them. */
+export declare const GI_RENDERER_APPS: readonly string[];

package/lib/index.mjs

@@ -11,6 +11,12 @@ export {
     resetRuntimeAliasesCache,
 } from './runtime-aliases.mjs';
 
+// Which package answers `gi://Ns` on a target with no GObject introspection — ADR 0034
+// stage 9. Kept beside the other per-target routing tables for the same reason they live
+// here: one source of truth per `--app`, reachable from the Vite presets as well as from
+// `gjsify build`.
+export { GI_RENDERERS, GI_RENDERER_APPS } from './gi-renderers.mjs';
+
 import { getDerivedAliasesSync as _getDerivedAliasesSync } from './runtime-aliases.mjs';
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/resolve-npm",
-    "version": "0.48.0",
+    "version": "0.49.0",
     "description": "Resolve NPM package aliases",
     "type": "module",
     "main": "lib/index.mjs",