@flighthq/registry-catalog 0.3.1-next.616.aa7ae7f

package/dist/builtInRegistryCatalogEntries.d.ts

@@ -0,0 +1,3 @@
+import type { RegistryCatalogEntry } from '@flighthq/types/contract';
+export declare const BUILT_IN_REGISTRY_CATALOG_ENTRIES: readonly RegistryCatalogEntry[];
+//# sourceMappingURL=builtInRegistryCatalogEntries.d.ts.map

package/dist/builtInRegistryCatalogEntries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtInRegistryCatalogEntries.d.ts","sourceRoot":"","sources":["../src/builtInRegistryCatalogEntries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAIrE,eAAO,MAAM,iCAAiC,EAAE,SAAS,oBAAoB,EAAO,CAAC"}

package/dist/builtInRegistryCatalogEntries.js

@@ -0,0 +1,4 @@
+// GENERATED by `npm run catalog` from scripts/catalog.ts. DO NOT EDIT BY HAND.
+// Stage 4 builds the mechanism only; built-in ownership rows remain deliberately unpopulated.
+export const BUILT_IN_REGISTRY_CATALOG_ENTRIES = [];
+//# sourceMappingURL=builtInRegistryCatalogEntries.js.map

package/dist/builtInRegistryCatalogEntries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtInRegistryCatalogEntries.js","sourceRoot":"","sources":["../src/builtInRegistryCatalogEntries.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,8FAA8F;AAC9F,MAAM,CAAC,MAAM,iCAAiC,GAAoC,EAAE,CAAC"}

package/dist/contract.d.ts

@@ -0,0 +1,3 @@
+export * from './registryCatalog';
+export * from './builtInRegistryCatalogEntries';
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,iCAAiC,CAAC"}

package/dist/contract.js

@@ -0,0 +1,3 @@
+export * from './registryCatalog';
+export * from './builtInRegistryCatalogEntries';
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,iCAAiC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './contract';
+//# 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,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './contract';
+//# 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,cAAc,YAAY,CAAC"}

package/dist/registryCatalog.d.ts

@@ -0,0 +1,7 @@
+import type { Kind, RegistryCatalog, RegistryCatalogEntry, RequirementFacet } from '@flighthq/types/contract';
+export declare function createRegistryCatalog(entries?: readonly Readonly<RegistryCatalogEntry>[]): RegistryCatalog;
+export declare function findRegistryCatalogEntries(catalog: Readonly<RegistryCatalog>, backend: string, facet: RequirementFacet, kind: Kind): readonly RegistryCatalogEntry[];
+export declare function getRegistryCatalogEntries(catalog: Readonly<RegistryCatalog>): readonly RegistryCatalogEntry[];
+export declare function registerRegistryCatalogEntry(catalog: RegistryCatalog, entry: Readonly<RegistryCatalogEntry>): void;
+export declare function unregisterRegistryCatalogEntry(catalog: RegistryCatalog, entry: Readonly<RegistryCatalogEntry>): boolean;
+//# sourceMappingURL=registryCatalog.d.ts.map

package/dist/registryCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registryCatalog.d.ts","sourceRoot":"","sources":["../src/registryCatalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE9G,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,SAAS,QAAQ,CAAC,oBAAoB,CAAC,EAAO,GAAG,eAAe,CAE9G;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,QAAQ,CAAC,eAAe,CAAC,EAClC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,IAAI,GACT,SAAS,oBAAoB,EAAE,CAIjC;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,SAAS,oBAAoB,EAAE,CAE7G;AAID,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAOlH;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GACpC,OAAO,CAMT"}

package/dist/registryCatalog.js

@@ -0,0 +1,44 @@
+export function createRegistryCatalog(entries = []) {
+    return { entries: entries.map(copyCatalogEntry) };
+}
+export function findRegistryCatalogEntries(catalog, backend, facet, kind) {
+    return catalog.entries
+        .filter((entry) => entry.backend === backend && entry.facet === facet && entry.kind === kind)
+        .map(copyCatalogEntry);
+}
+export function getRegistryCatalogEntries(catalog) {
+    return catalog.entries.map(copyCatalogEntry);
+}
+// The row identity includes the registrar. One requirement may need multiple registrations, so adding a
+// distinct registrar appends instead of replacing another call for the same backend/facet/kind.
+export function registerRegistryCatalogEntry(catalog, entry) {
+    const index = catalog.entries.findIndex((candidate) => registryCatalogEntryIdentity(candidate) === registryCatalogEntryIdentity(entry));
+    const copy = copyCatalogEntry(entry);
+    if (index === -1)
+        catalog.entries.push(copy);
+    else
+        catalog.entries[index] = copy;
+}
+export function unregisterRegistryCatalogEntry(catalog, entry) {
+    const identity = registryCatalogEntryIdentity(entry);
+    const index = catalog.entries.findIndex((candidate) => registryCatalogEntryIdentity(candidate) === identity);
+    if (index === -1)
+        return false;
+    catalog.entries.splice(index, 1);
+    return true;
+}
+function copyCatalogEntry(entry) {
+    return {
+        backend: entry.backend,
+        facet: entry.facet,
+        implementationImport: entry.implementationImport,
+        implementationSymbol: entry.implementationSymbol,
+        kind: entry.kind,
+        registrarImport: entry.registrarImport,
+        registrarSymbol: entry.registrarSymbol,
+    };
+}
+function registryCatalogEntryIdentity(entry) {
+    return [entry.backend, entry.facet, entry.kind, entry.registrarImport, entry.registrarSymbol].join('\0');
+}
+//# sourceMappingURL=registryCatalog.js.map

package/dist/registryCatalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registryCatalog.js","sourceRoot":"","sources":["../src/registryCatalog.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,qBAAqB,CAAC,UAAqD,EAAE;IAC3F,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,OAAkC,EAClC,OAAe,EACf,KAAuB,EACvB,IAAU;IAEV,OAAO,OAAO,CAAC,OAAO;SACnB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,OAAO,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;SAC5F,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,OAAkC;IAC1E,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAC/C,CAAC;AAED,wGAAwG;AACxG,gGAAgG;AAChG,MAAM,UAAU,4BAA4B,CAAC,OAAwB,EAAE,KAAqC;IAC1G,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CACrC,CAAC,SAAS,EAAE,EAAE,CAAC,4BAA4B,CAAC,SAAS,CAAC,KAAK,4BAA4B,CAAC,KAAK,CAAC,CAC/F,CAAC;IACF,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;QACxC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,OAAwB,EACxB,KAAqC;IAErC,MAAM,QAAQ,GAAG,4BAA4B,CAAC,KAAK,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,4BAA4B,CAAC,SAAS,CAAC,KAAK,QAAQ,CAAC,CAAC;IAC7G,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/B,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACjC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAqC;IAC7D,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;QAChD,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;QAChD,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,eAAe,EAAE,KAAK,CAAC,eAAe;KACvC,CAAC;AACJ,CAAC;AAED,SAAS,4BAA4B,CAAC,KAAqC;IACzE,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC3G,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@flighthq/registry-catalog",
+  "version": "0.3.1-next.616.aa7ae7f",
+  "author": "Joshua Granick and other contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flighthq/flight.git",
+    "directory": "packages/registry-catalog"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./contract": {
+      "types": "./dist/contract.d.ts",
+      "default": "./dist/contract.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/types": "0.3.1-next.616.aa7ae7f"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Caller-owned open registry of backend-specific registration remedies",
+  "sideEffects": false
+}

package/src/registryCatalog.test.ts

@@ -0,0 +1,86 @@
+import type { RegistryCatalogEntry } from '@flighthq/types/contract';
+import { RequirementFacet } from '@flighthq/types/contract';
+
+import {
+  createRegistryCatalog,
+  findRegistryCatalogEntries,
+  getRegistryCatalogEntries,
+  registerRegistryCatalogEntry,
+  unregisterRegistryCatalogEntry,
+} from './registryCatalog';
+
+const first: RegistryCatalogEntry = {
+  backend: 'webgl',
+  facet: RequirementFacet.SceneNodeKind,
+  implementationImport: '@flighthq/scene2d-gl',
+  implementationSymbol: 'defaultGlShapeRenderer',
+  kind: 'Shape',
+  registrarImport: '@flighthq/render',
+  registrarSymbol: 'registerRenderer',
+};
+
+describe('createRegistryCatalog', () => {
+  it('creates an isolated empty catalog and copies supplied entries', () => {
+    const source = [first];
+    const catalog = createRegistryCatalog(source);
+    source.length = 0;
+
+    expect(catalog.entries).toEqual([first]);
+    expect(createRegistryCatalog().entries).toEqual([]);
+    expect(createRegistryCatalog().entries).not.toBe(createRegistryCatalog().entries);
+  });
+});
+
+describe('findRegistryCatalogEntries', () => {
+  it('looks up every row by backend, facet, and kind and returns detached values', () => {
+    const catalog = createRegistryCatalog([first]);
+    const entries = findRegistryCatalogEntries(catalog, 'webgl', RequirementFacet.SceneNodeKind, 'Shape');
+    expect(entries).toEqual([first]);
+    expect(entries[0]).not.toBe(catalog.entries[0]);
+    expect(findRegistryCatalogEntries(catalog, 'webgpu', RequirementFacet.SceneNodeKind, 'Shape')).toEqual([]);
+  });
+});
+
+describe('getRegistryCatalogEntries', () => {
+  it('returns a detached ordered snapshot', () => {
+    const catalog = createRegistryCatalog([first]);
+    const snapshot = getRegistryCatalogEntries(catalog);
+    expect(getRegistryCatalogEntries(catalog)).toEqual([first]);
+    expect(snapshot).not.toBe(catalog.entries);
+    expect(snapshot[0]).not.toBe(catalog.entries[0]);
+  });
+});
+
+describe('registerRegistryCatalogEntry', () => {
+  it('replaces a matching key in place and copies caller data', () => {
+    const catalog = createRegistryCatalog([first]);
+    const replacement: RegistryCatalogEntry = {
+      ...first,
+      implementationImport: '@acme/gl',
+      implementationSymbol: 'defaultAcmeShapeRenderer',
+    };
+    registerRegistryCatalogEntry(catalog, replacement);
+
+    expect(catalog.entries).toEqual([replacement]);
+  });
+
+  it('preserves multiple registrar rows for one requirement', () => {
+    const catalog = createRegistryCatalog([first]);
+    const commands = {
+      ...first,
+      registrarImport: '@flighthq/scene2d-gl',
+      registrarSymbol: 'registerGlShapeCommands',
+    };
+    registerRegistryCatalogEntry(catalog, commands);
+    expect(catalog.entries).toEqual([first, commands]);
+  });
+});
+
+describe('unregisterRegistryCatalogEntry', () => {
+  it('removes only the requested kind and registry', () => {
+    const catalog = createRegistryCatalog([first]);
+    expect(unregisterRegistryCatalogEntry(catalog, { ...first, registrarSymbol: 'unknown' })).toBe(false);
+    expect(unregisterRegistryCatalogEntry(catalog, first)).toBe(true);
+    expect(catalog.entries).toEqual([]);
+  });
+});