@lorion-org/registry-hub 1.0.0-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+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

@@ -0,0 +1,158 @@
+# @lorion-org/registry-hub
+
+Framework-free typed registry and registry-hub primitives.
+
+This package provides small registry primitives for systems that need typed named entries without coupling the registry to a framework runtime.
+It stays intentionally small and does not know anything about Nuxt, Nitro, H3, or app-specific lifecycle hooks.
+
+## Design goals
+
+- generic names for reusable runtime terms
+- deterministic overwrite behavior for duplicate item ids
+- lazy registry creation via the hub
+- no framework globals, events, priorities, or persistence
+- `entries()` covers explicit inspect/debug and enumeration use cases in v1
+
+## Installation
+
+```shell
+pnpm add @lorion-org/registry-hub
+```
+
+## When not to use this package
+
+This package is intentionally small. It is not a fit if you need:
+
+- ordered or priority-based plugin execution
+- unregister or disposal semantics
+- async lifecycle orchestration
+- persistence or distributed registry state
+
+## API
+
+```ts
+import { createRegistry, createRegistryHub } from '@lorion-org/registry-hub';
+```
+
+### Create a single registry
+
+```ts
+import { createRegistry, type RegistryItem } from '@lorion-org/registry-hub';
+
+type Command = RegistryItem & {
+  command: string;
+};
+
+const commands = createRegistry<Command>('commands');
+
+commands.register({ id: 'build', command: 'pnpm build' });
+
+commands.get('build');
+commands.list();
+commands.entries();
+```
+
+### Use a registry hub
+
+```ts
+import { createRegistryHub, type RegistryItem } from '@lorion-org/registry-hub';
+
+type Tool = RegistryItem & {
+  title: string;
+};
+
+const hub = createRegistryHub();
+
+hub.createRegistry<Tool>('tools');
+hub.register<Tool>('tools', { id: 'lint', title: 'Lint workspace' });
+
+const tool = hub.get<Tool>('tools', 'lint');
+const tools = hub.list<Tool>('tools');
+const registries = hub.entries();
+```
+
+### Renderer registry example
+
+```ts
+import { createRegistry, type RegistryItem } from '@lorion-org/registry-hub';
+
+type FieldRenderer = RegistryItem & {
+  component: string;
+};
+
+const renderers = createRegistry<FieldRenderer>('field-renderers');
+
+renderers.register([
+  { id: 'text', component: 'TextFieldRenderer' },
+  { id: 'date', component: 'DateFieldRenderer' },
+]);
+
+const knownRenderers = renderers.entries();
+```
+
+### Framework recipe
+
+The package does not ship framework bindings, but it is designed to be easy to inject into one.
+
+```ts
+import { createRegistryHub } from '@lorion-org/registry-hub';
+
+export default defineNuxtPlugin(() => {
+  const registryHub = createRegistryHub();
+
+  return {
+    provide: {
+      registryHub,
+    },
+  };
+});
+```
+
+Another plugin can then consume that injected hub and register its own entries.
+
+```ts
+import type { RegistryItem } from '@lorion-org/registry-hub';
+
+type Tool = RegistryItem & {
+  title: string;
+};
+
+export default defineNuxtPlugin((nuxtApp) => {
+  nuxtApp.$registryHub.register<Tool>('tools', {
+    id: 'lint',
+    title: 'Lint workspace',
+  });
+});
+```
+
+A composable can later load all entries of one typed registry from that same hub.
+
+```ts
+import type { RegistryItem } from '@lorion-org/registry-hub';
+
+type Tool = RegistryItem & {
+  title: string;
+};
+
+export function useTools(): Tool[] {
+  return useNuxtApp().$registryHub.list<Tool>('tools');
+}
+```
+
+Runnable example files live in [`examples/`](./examples).
+The Node example imports the published package name instead of local source files so it mirrors real consumer usage.
+The examples use neutral domain names so the package can be understood as a generic registry utility.
+
+## Local commands
+
+```shell
+cd packages/registry-hub
+pnpm build
+pnpm test
+pnpm coverage
+pnpm typecheck
+pnpm package:check
+```
+
+`pnpm package:check` builds the package, runs `pnpm pack --dry-run`, and
+validates the published package shape with `publint`.

package/dist/index.cjs

@@ -0,0 +1,73 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createRegistry: () => createRegistry,
+  createRegistryHub: () => createRegistryHub
+});
+module.exports = __toCommonJS(index_exports);
+function createRegistry(id) {
+  const map = /* @__PURE__ */ new Map();
+  return {
+    id,
+    get: (itemId) => map.get(itemId),
+    list: () => Array.from(map.values()),
+    entries: () => Array.from(map.entries()),
+    register: (items) => {
+      const normalized = Array.isArray(items) ? items : [items];
+      for (const item of normalized) map.set(item.id, item);
+      return normalized;
+    }
+  };
+}
+function createRegistryHub() {
+  const registries = /* @__PURE__ */ new Map();
+  return {
+    createRegistry: (id) => {
+      const existing = registries.get(id);
+      if (existing) return existing;
+      const created = createRegistry(id);
+      registries.set(id, created);
+      return created;
+    },
+    getRegistry: (id) => registries.get(id),
+    register: (registryId, items) => {
+      const registry = registries.get(registryId) ?? createRegistry(registryId);
+      if (!registries.has(registryId))
+        registries.set(registryId, registry);
+      return registry.register(items);
+    },
+    get: (registryId, itemId) => {
+      const registry = registries.get(registryId);
+      return registry?.get(itemId);
+    },
+    list: (registryId) => {
+      const registry = registries.get(registryId);
+      return registry?.list() ?? [];
+    },
+    entries: () => Array.from(registries.entries())
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createRegistry,
+  createRegistryHub
+});

package/dist/index.d.cts

@@ -0,0 +1,22 @@
+type RegistryItem = {
+    id: string;
+};
+type Registry<T extends RegistryItem = RegistryItem> = {
+    id: string;
+    get: (id: string) => T | undefined;
+    list: () => T[];
+    register: (items: T | T[]) => T[];
+    entries: () => Array<[string, T]>;
+};
+type RegistryHub = {
+    createRegistry: <T extends RegistryItem>(id: string) => Registry<T>;
+    getRegistry: <T extends RegistryItem>(id: string) => Registry<T> | undefined;
+    register: <T extends RegistryItem>(registryId: string, items: T | T[]) => T[];
+    get: <T extends RegistryItem>(registryId: string, itemId: string) => T | undefined;
+    list: <T extends RegistryItem>(registryId: string) => T[];
+    entries: () => Array<[string, Registry<RegistryItem>]>;
+};
+declare function createRegistry<T extends RegistryItem>(id: string): Registry<T>;
+declare function createRegistryHub(): RegistryHub;
+
+export { type Registry, type RegistryHub, type RegistryItem, createRegistry, createRegistryHub };

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+type RegistryItem = {
+    id: string;
+};
+type Registry<T extends RegistryItem = RegistryItem> = {
+    id: string;
+    get: (id: string) => T | undefined;
+    list: () => T[];
+    register: (items: T | T[]) => T[];
+    entries: () => Array<[string, T]>;
+};
+type RegistryHub = {
+    createRegistry: <T extends RegistryItem>(id: string) => Registry<T>;
+    getRegistry: <T extends RegistryItem>(id: string) => Registry<T> | undefined;
+    register: <T extends RegistryItem>(registryId: string, items: T | T[]) => T[];
+    get: <T extends RegistryItem>(registryId: string, itemId: string) => T | undefined;
+    list: <T extends RegistryItem>(registryId: string) => T[];
+    entries: () => Array<[string, Registry<RegistryItem>]>;
+};
+declare function createRegistry<T extends RegistryItem>(id: string): Registry<T>;
+declare function createRegistryHub(): RegistryHub;
+
+export { type Registry, type RegistryHub, type RegistryItem, createRegistry, createRegistryHub };

package/dist/index.js

@@ -0,0 +1,47 @@
+// src/index.ts
+function createRegistry(id) {
+  const map = /* @__PURE__ */ new Map();
+  return {
+    id,
+    get: (itemId) => map.get(itemId),
+    list: () => Array.from(map.values()),
+    entries: () => Array.from(map.entries()),
+    register: (items) => {
+      const normalized = Array.isArray(items) ? items : [items];
+      for (const item of normalized) map.set(item.id, item);
+      return normalized;
+    }
+  };
+}
+function createRegistryHub() {
+  const registries = /* @__PURE__ */ new Map();
+  return {
+    createRegistry: (id) => {
+      const existing = registries.get(id);
+      if (existing) return existing;
+      const created = createRegistry(id);
+      registries.set(id, created);
+      return created;
+    },
+    getRegistry: (id) => registries.get(id),
+    register: (registryId, items) => {
+      const registry = registries.get(registryId) ?? createRegistry(registryId);
+      if (!registries.has(registryId))
+        registries.set(registryId, registry);
+      return registry.register(items);
+    },
+    get: (registryId, itemId) => {
+      const registry = registries.get(registryId);
+      return registry?.get(itemId);
+    },
+    list: (registryId) => {
+      const registry = registries.get(registryId);
+      return registry?.list() ?? [];
+    },
+    entries: () => Array.from(registries.entries())
+  };
+}
+export {
+  createRegistry,
+  createRegistryHub
+};

package/examples/node-basic.js

@@ -0,0 +1,10 @@
+import { createRegistryHub } from '@lorion-org/registry-hub';
+import process from 'node:process';
+
+const hub = createRegistryHub();
+
+hub.register('commands', { id: 'build', command: 'pnpm build' });
+hub.register('tools', { id: 'lint', title: 'Lint workspace' });
+
+process.stdout.write(`${JSON.stringify(hub.list('commands'))}\n`);
+process.stdout.write(`${JSON.stringify(hub.get('tools', 'lint'))}\n`);

package/examples/node-basic.ts

@@ -0,0 +1,20 @@
+import { createRegistryHub, type RegistryItem } from '@lorion-org/registry-hub';
+
+type Command = RegistryItem & {
+  command: string;
+};
+
+type Tool = RegistryItem & {
+  title: string;
+};
+
+const hub = createRegistryHub();
+
+hub.register<Command>('commands', { id: 'build', command: 'pnpm build' });
+hub.register<Tool>('tools', { id: 'lint', title: 'Lint workspace' });
+
+console.log(hub.list<Command>('commands'));
+// [{ id: 'build', command: 'pnpm build' }]
+
+console.log(hub.get<Tool>('tools', 'lint'));
+// { id: 'lint', title: 'Lint workspace' }

package/examples/nuxt-plugin.ts

@@ -0,0 +1,14 @@
+import { createRegistryHub } from '@lorion-org/registry-hub';
+
+export default defineNuxtPlugin(() => {
+  const registryHub = createRegistryHub();
+
+  console.log(['registryHub']);
+  // ['registryHub']
+
+  return {
+    provide: {
+      registryHub,
+    },
+  };
+});

package/examples/renderer-registry.js

@@ -0,0 +1,16 @@
+import { createRegistry } from '@lorion-org/registry-hub';
+import process from 'node:process';
+
+const renderers = createRegistry('field-renderers');
+
+renderers.register([
+  { id: 'text', component: 'TextFieldRenderer' },
+  { id: 'date', component: 'DateFieldRenderer' },
+]);
+
+process.stdout.write(
+  `${renderers.id}:${renderers
+    .entries()
+    .map(([id]) => id)
+    .join(',')}\n`,
+);

package/examples/renderer-registry.ts

@@ -0,0 +1,18 @@
+import { createRegistry, type RegistryItem } from '@lorion-org/registry-hub';
+
+type FieldRenderer = RegistryItem & {
+  component: string;
+};
+
+const renderers = createRegistry<FieldRenderer>('field-renderers');
+
+renderers.register([
+  { id: 'text', component: 'TextFieldRenderer' },
+  { id: 'date', component: 'DateFieldRenderer' },
+]);
+
+console.log(renderers.entries());
+// [
+//   ['text', { id: 'text', component: 'TextFieldRenderer' }],
+//   ['date', { id: 'date', component: 'DateFieldRenderer' }]
+// ]

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@lorion-org/registry-hub",
+  "version": "1.0.0-beta.0",
+  "description": "Framework-free typed registry and registry-hub primitives.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lorion-org/lorion.git",
+    "directory": "packages/registry-hub"
+  },
+  "homepage": "https://github.com/lorion-org/lorion/tree/main/packages/registry-hub#readme",
+  "bugs": {
+    "url": "https://github.com/lorion-org/lorion/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "examples",
+    "LICENSE"
+  ],
+  "keywords": [
+    "registry",
+    "hub",
+    "typed",
+    "typescript"
+  ],
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "clean": "rimraf coverage dist tsconfig.tsbuildinfo",
+    "example:node": "node ./examples/node-basic.js",
+    "example:renderer": "node ./examples/renderer-registry.js",
+    "lint": "eslint src --ext .ts",
+    "test": "vitest run --root ../.. --config vitest.config.mts packages/registry-hub/src/index.spec.ts",
+    "coverage": "vitest run --coverage --coverage.include=packages/registry-hub/src/index.ts --root ../.. --config vitest.config.mts packages/registry-hub/src/index.spec.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "package:check": "pnpm build && pnpm pack --dry-run && publint"
+  }
+}