@fougere/registry 0.0.0-stage → 0.23.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fougere contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,43 @@
-# Temporary Holding Version
+# @fougere/registry
+> One answer per name
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+`Sources` says which source type is `'sqlite'`, `Generators` which generator is `'ulid'`, `Protocols`
+which adapter serves `'graphql'`. Each is a registry: a package answers a question by NAME, and a name
+has one answer. Zero dependencies. (A question answered by TYPE — a class that extends a port — is
+the other form of the same extension point, read off the class hierarchy at boot.)
+
+## Installation
+```bash
+pnpm add @fougere/registry
+```
+
+## The rule
+
+```ts
+const Generators = new Registry<() => string>('generator');
+
+Generators.register('ulid', ulid);     // the answer
+Generators.register('ulid', ulid);     // the same answer again: nothing happens
+Generators.register('ulid', other);    // refused — 'ulid' is answered twice for generator
+Generators.replace('ulid', other);     // said: standing in its place is the point
+```
+
+A host that re-reads a project in the same process re-runs the files that answer, and says so:
+
+```ts
+await Registry.reloading(() => boot(), (registry, name) => log.debug(`${registry} '${name}' replaced`));
+```
+
+Inside that call, an answer replaces the one it had. The packages the host does not re-run keep
+theirs, so a reload loses nothing.
+
+## A term
+
+```ts
+export const ulid = Generators.term('ulid', () => …);   // a name and its answer, as a value
+ulid.register();                                         // registered where it is used
+```
+
+A term is what a project's `vocabulary/` file exports: the statement lists it for the process
+(`export const vocabulary = [ulid]` in `fronds.ts`), and the boot registers it. Imported for a value,
+it is never dropped by a bundler the way a file imported only to register is.

package/dist/Registry.d.ts

@@ -0,0 +1,38 @@
+import { Term } from './Term.js';
+/** What a reload replaced — told to whoever reloaded, since this package holds no logger. */
+export type Replaced = (registry: string, name: string) => void;
+/**
+ * A question a package opens — `which source type is 'sqlite'?`, `which generator is 'ulid'?` — and
+ * the one answer each name has. A name answered twice is refused naming the registry, unless the same
+ * answer comes back or `replace` says standing in its place is the point.
+ *
+ * A host that re-reads a project in the same process — `fougere serve --watch` — re-runs the files
+ * that answer, and says so: inside `Registry.reloading`, an answer replaces the one it had.
+ * The packages it does not re-run keep theirs, so nothing is lost and nothing is noted.
+ */
+export declare class Registry<T> {
+    readonly label: string;
+    private readonly hint?;
+    private static replaced;
+    /** Every registry this process made — what a report of the extension points reads. */
+    private static readonly made;
+    private readonly held;
+    constructor(label: string, hint?: string | undefined, entries?: Iterable<readonly [string, T]>);
+    /** Every registry this process made, each by its label and the names it answers. */
+    static every(): {
+        label: string;
+        names: string[];
+    }[];
+    /** Runs `reload`, during which a second answer under a name replaces the first. */
+    static reloading<R>(reload: () => Promise<R>, replaced?: Replaced): Promise<R>;
+    register(name: string, value: T): T;
+    /** The answer as a value — exported from `vocabulary/`, registered by the frond that states it. */
+    term(name: string, value: T): Term<T>;
+    replace(name: string, value: T): T;
+    find(name: string): T | undefined;
+    resolve(name: string, path?: string): T;
+    get names(): string[];
+    get entries(): [string, T][];
+    get all(): T[];
+}
+//# sourceMappingURL=Registry.d.ts.map

package/dist/Registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Registry.d.ts","sourceRoot":"","sources":["../src/Registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,6FAA6F;AAC7F,MAAM,MAAM,QAAQ,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAEhE;;;;;;;;GAQG;AACH,qBAAa,QAAQ,CAAC,CAAC;IASnB,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IATxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuB;IAE9C,sFAAsF;IACtF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAgC;IAE5D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiB;IAEtC,YACW,KAAK,EAAE,MAAM,EACL,IAAI,CAAC,EAAE,MAAM,YAAA,EAC9B,OAAO,CAAC,EAAE,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAIzC;IAED,oFAAoF;IACpF,MAAM,CAAC,KAAK,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAEnD;IAED,mFAAmF;IACnF,OAAa,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,GAAE,QAAmB,GAAG,OAAO,CAAC,CAAC,CAAC,CAQ7F;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAgBlC;IAED,mGAAmG;IACnG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAEpC;IAED,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAQjC;IAED,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAEhC;IAED,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,CAAC,CAStC;IAED,IAAI,KAAK,IAAI,MAAM,EAAE,CAEpB;IAED,IAAI,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAE3B;IAED,IAAI,GAAG,IAAI,CAAC,EAAE,CAEb;CACF"}

package/dist/Registry.js

@@ -0,0 +1,84 @@
+import { RegistryError } from './RegistryError.js';
+import { Term } from './Term.js';
+/**
+ * A question a package opens — `which source type is 'sqlite'?`, `which generator is 'ulid'?` — and
+ * the one answer each name has. A name answered twice is refused naming the registry, unless the same
+ * answer comes back or `replace` says standing in its place is the point.
+ *
+ * A host that re-reads a project in the same process — `fougere serve --watch` — re-runs the files
+ * that answer, and says so: inside `Registry.reloading`, an answer replaces the one it had.
+ * The packages it does not re-run keep theirs, so nothing is lost and nothing is noted.
+ */
+export class Registry {
+    label;
+    hint;
+    static replaced;
+    /** Every registry this process made — what a report of the extension points reads. */
+    static made = new Set();
+    held;
+    constructor(label, hint, entries) {
+        this.label = label;
+        this.hint = hint;
+        this.held = new Map(entries);
+        Registry.made.add(this);
+    }
+    /** Every registry this process made, each by its label and the names it answers. */
+    static every() {
+        return [...Registry.made].map((one) => ({ label: one.label, names: one.names }));
+    }
+    /** Runs `reload`, during which a second answer under a name replaces the first. */
+    static async reloading(reload, replaced = () => { }) {
+        const outer = Registry.replaced;
+        Registry.replaced = replaced;
+        try {
+            return await reload();
+        }
+        finally {
+            Registry.replaced = outer;
+        }
+    }
+    register(name, value) {
+        const held = this.held.get(name);
+        if (held !== undefined && held !== value) {
+            const replaced = Registry.replaced;
+            if (!replaced) {
+                throw new RegistryError(`'${name}' is answered twice for ${this.label} — a second answer would silently replace the first. `
+                    + 'Name one of them differently, or call replace() when standing in its place is the point.');
+            }
+            replaced(this.label, name);
+        }
+        this.held.set(name, value);
+        return value;
+    }
+    /** The answer as a value — exported from `vocabulary/`, registered by the frond that states it. */
+    term(name, value) {
+        return new Term(this, name, value);
+    }
+    replace(name, value) {
+        if (!this.held.has(name)) {
+            throw new RegistryError(`'${name}' answers nothing for ${this.label} yet, so nothing can be replaced — use register().`);
+        }
+        this.held.set(name, value);
+        return value;
+    }
+    find(name) {
+        return this.held.get(name);
+    }
+    resolve(name, path) {
+        const found = this.find(name);
+        if (found !== undefined)
+            return found;
+        throw new RegistryError(`${path ? `${path}: ` : ''}Unknown ${this.label} '${name}'${this.hint ? ` — ${this.hint}` : ''}. `
+            + `This process answers ${this.names.join(', ') || 'nothing yet'}.`);
+    }
+    get names() {
+        return [...this.held.keys()];
+    }
+    get entries() {
+        return [...this.held];
+    }
+    get all() {
+        return [...this.held.values()];
+    }
+}
+//# sourceMappingURL=Registry.js.map

package/dist/Registry.js.map

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

package/dist/RegistryError.d.ts

@@ -0,0 +1,4 @@
+export declare class RegistryError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=RegistryError.d.ts.map

package/dist/RegistryError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegistryError.d.ts","sourceRoot":"","sources":["../src/RegistryError.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAO,EAAE,MAAM,EAI1B;CACF"}

package/dist/RegistryError.js

@@ -0,0 +1,7 @@
+export class RegistryError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'RegistryError';
+    }
+}
+//# sourceMappingURL=RegistryError.js.map

package/dist/RegistryError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegistryError.js","sourceRoot":"","sources":["../src/RegistryError.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/dist/Term.d.ts

@@ -0,0 +1,15 @@
+import type { Registry } from './Registry.js';
+/**
+ * A name and its answer, held as a value — what a `vocabulary/` file exports, and what the frond
+ * stating it registers. A declaration still writes the NAME (`format: 'slug'`), which is what a card
+ * carries; the answer travels with the frond, so it is imported rather than loaded for its effect.
+ */
+export declare class Term<T> {
+    readonly registry: Registry<T>;
+    readonly name: string;
+    readonly answer: T;
+    constructor(registry: Registry<T>, name: string, answer: T);
+    static is(value: unknown): value is Term<unknown>;
+    register(): void;
+}
+//# sourceMappingURL=Term.d.ts.map

package/dist/Term.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Term.d.ts","sourceRoot":"","sources":["../src/Term.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C;;;;GAIG;AACH,qBAAa,IAAI,CAAC,CAAC;IAEf,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,MAAM,EAAE,CAAC;IAHpB,YACW,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EACrB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,EAChB;IAEJ,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,CAEhD;IAED,QAAQ,IAAI,IAAI,CAEf;CACF"}

package/dist/Term.js

@@ -0,0 +1,22 @@
+/**
+ * A name and its answer, held as a value — what a `vocabulary/` file exports, and what the frond
+ * stating it registers. A declaration still writes the NAME (`format: 'slug'`), which is what a card
+ * carries; the answer travels with the frond, so it is imported rather than loaded for its effect.
+ */
+export class Term {
+    registry;
+    name;
+    answer;
+    constructor(registry, name, answer) {
+        this.registry = registry;
+        this.name = name;
+        this.answer = answer;
+    }
+    static is(value) {
+        return value instanceof Term;
+    }
+    register() {
+        this.registry.register(this.name, this.answer);
+    }
+}
+//# sourceMappingURL=Term.js.map

package/dist/Term.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Term.js","sourceRoot":"","sources":["../src/Term.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,OAAO,IAAI;IAEJ,QAAQ;IACR,IAAI;IACJ,MAAM;IAHjB,YACW,QAAqB,EACrB,IAAY,EACZ,MAAS;wBAFT,QAAQ;oBACR,IAAI;sBACJ,MAAM;IACd,CAAC;IAEJ,MAAM,CAAC,EAAE,CAAC,KAAc;QACtB,OAAO,KAAK,YAAY,IAAI,CAAC;IAC/B,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { Registry, type Replaced } from './Registry.js';
+export { RegistryError } from './RegistryError.js';
+export { Term } from './Term.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { Registry } from './Registry.js';
+export { RegistryError } from './RegistryError.js';
+export { Term } from './Term.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAiB,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/package.json

@@ -1,6 +1,43 @@
 {
   "name": "@fougere/registry",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.23.0-alpha.0",
+  "description": "Fougere's registry: one answer per name, refused when a second one arrives, and a reload that says it replaces. Zero dependencies.",
+  "keywords": [
+    "fougere",
+    "typescript",
+    "registry",
+    "plugin"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chok/fougere.git",
+    "directory": "packages/registry"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "devDependencies": {
+    "vitest": "^4.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit -p tsconfig.test.json"
+  }
 }

package/src/Registry.ts

@@ -0,0 +1,108 @@
+import { RegistryError } from './RegistryError.js';
+import { Term } from './Term.js';
+
+/** What a reload replaced — told to whoever reloaded, since this package holds no logger. */
+export type Replaced = (registry: string, name: string) => void;
+
+/**
+ * A question a package opens — `which source type is 'sqlite'?`, `which generator is 'ulid'?` — and
+ * the one answer each name has. A name answered twice is refused naming the registry, unless the same
+ * answer comes back or `replace` says standing in its place is the point.
+ *
+ * A host that re-reads a project in the same process — `fougere serve --watch` — re-runs the files
+ * that answer, and says so: inside `Registry.reloading`, an answer replaces the one it had.
+ * The packages it does not re-run keep theirs, so nothing is lost and nothing is noted.
+ */
+export class Registry<T> {
+  private static replaced: Replaced | undefined;
+
+  /** Every registry this process made — what a report of the extension points reads. */
+  private static readonly made = new Set<Registry<unknown>>();
+
+  private readonly held: Map<string, T>;
+
+  constructor(
+    readonly label: string,
+    private readonly hint?: string,
+    entries?: Iterable<readonly [string, T]>,
+  ) {
+    this.held = new Map(entries);
+    Registry.made.add(this as Registry<unknown>);
+  }
+
+  /** Every registry this process made, each by its label and the names it answers. */
+  static every(): { label: string; names: string[] }[] {
+    return [...Registry.made].map((one) => ({ label: one.label, names: one.names }));
+  }
+
+  /** Runs `reload`, during which a second answer under a name replaces the first. */
+  static async reloading<R>(reload: () => Promise<R>, replaced: Replaced = () => {}): Promise<R> {
+    const outer = Registry.replaced;
+    Registry.replaced = replaced;
+    try {
+      return await reload();
+    } finally {
+      Registry.replaced = outer;
+    }
+  }
+
+  register(name: string, value: T): T {
+    const held = this.held.get(name);
+    if (held !== undefined && held !== value) {
+      const replaced = Registry.replaced;
+      if (!replaced) {
+        throw new RegistryError(
+          `'${name}' is answered twice for ${this.label} — a second answer would silently replace the first. `
+            + 'Name one of them differently, or call replace() when standing in its place is the point.',
+        );
+      }
+      replaced(this.label, name);
+    }
+
+    this.held.set(name, value);
+
+    return value;
+  }
+
+  /** The answer as a value — exported from `vocabulary/`, registered by the frond that states it. */
+  term(name: string, value: T): Term<T> {
+    return new Term(this, name, value);
+  }
+
+  replace(name: string, value: T): T {
+    if (!this.held.has(name)) {
+      throw new RegistryError(`'${name}' answers nothing for ${this.label} yet, so nothing can be replaced — use register().`);
+    }
+
+    this.held.set(name, value);
+
+    return value;
+  }
+
+  find(name: string): T | undefined {
+    return this.held.get(name);
+  }
+
+  resolve(name: string, path?: string): T {
+    const found = this.find(name);
+
+    if (found !== undefined) return found;
+
+    throw new RegistryError(
+      `${path ? `${path}: ` : ''}Unknown ${this.label} '${name}'${this.hint ? ` — ${this.hint}` : ''}. `
+        + `This process answers ${this.names.join(', ') || 'nothing yet'}.`,
+    );
+  }
+
+  get names(): string[] {
+    return [...this.held.keys()];
+  }
+
+  get entries(): [string, T][] {
+    return [...this.held];
+  }
+
+  get all(): T[] {
+    return [...this.held.values()];
+  }
+}

package/src/RegistryError.ts

@@ -0,0 +1,7 @@
+export class RegistryError extends Error {
+  constructor(message: string) {
+    super(message);
+
+    this.name = 'RegistryError';
+  }
+}

package/src/Term.ts

@@ -0,0 +1,22 @@
+import type { Registry } from './Registry.js';
+
+/**
+ * A name and its answer, held as a value — what a `vocabulary/` file exports, and what the frond
+ * stating it registers. A declaration still writes the NAME (`format: 'slug'`), which is what a card
+ * carries; the answer travels with the frond, so it is imported rather than loaded for its effect.
+ */
+export class Term<T> {
+  constructor(
+    readonly registry: Registry<T>,
+    readonly name: string,
+    readonly answer: T,
+  ) {}
+
+  static is(value: unknown): value is Term<unknown> {
+    return value instanceof Term;
+  }
+
+  register(): void {
+    this.registry.register(this.name, this.answer);
+  }
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export { Registry, type Replaced } from './Registry.js';
+export { RegistryError } from './RegistryError.js';
+export { Term } from './Term.js';