@nomiedge/registry 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nomiedge
+
+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,35 @@
+# @nomiedge/registry
+
+A generated, machine-readable manifest of every `@nomiedge/ui` component, `@nomiedge/icons`
+icon, `@nomiedge/tokens` export, `@nomiedge/motion` export, and `@nomiedge/charts` chart type.
+
+## What this is
+
+`registry.json` is generated _from_ the real package sources — never hand-maintained. It's the
+substrate the CLI (Milestone 55), templates (Milestone 56), and AI tooling (Milestone 58) all
+consume: one canonical, typed description of what NDL is, instead of five different tools each
+inventing their own partial version of it.
+
+## Regenerating
+
+```sh
+pnpm --filter @nomiedge/registry build:registry
+```
+
+This overwrites `registry.json`. CI regenerates it on every PR and fails if the result differs
+from what's checked in — if you change a component's props or add/remove an export, regenerate
+and commit the updated `registry.json` alongside your change.
+
+## Usage
+
+```ts
+import { loadRegistry, listByKind, getEntry } from "@nomiedge/registry";
+
+const button = getEntry("Button"); // { kind: "component", name: "Button", props: [...], ... }
+const allIcons = listByKind("icon");
+```
+
+## Adding a new entry kind
+
+Add the shape to `src/schema.ts`'s `registryEntrySchema` discriminated union, write a new
+`src/build/extract-<name>.ts`, and call it from `src/build/assemble.ts`.

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import { type RegistryEntry, type RegistryFile } from "./schema.js";
+/** Validated once at module load — a hand-edited or corrupted registry.json fails loudly here, not silently downstream. */
+export declare function loadRegistry(): RegistryFile;
+export declare function listByKind<K extends RegistryEntry["kind"]>(kind: K): Extract<RegistryEntry, {
+    kind: K;
+}>[];
+export declare function getEntry(name: string): RegistryEntry | undefined;
+export type { RegistryEntry, RegistryFile } from "./schema.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":"AAEA,OAAO,EAAsB,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAIxF,2HAA2H;AAC3H,wBAAgB,YAAY,IAAI,YAAY,CAE3C;AAED,wBAAgB,UAAU,CAAC,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,EACxD,IAAI,EAAE,CAAC,GACN,OAAO,CAAC,aAAa,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,EAAE,CAIvC;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEhE;AAED,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+// packages/registry/src/index.ts
+import registryData from "../registry.json" with { type: "json" };
+import { registryFileSchema } from "./schema.js";
+const registry = registryFileSchema.parse(registryData);
+/** Validated once at module load — a hand-edited or corrupted registry.json fails loudly here, not silently downstream. */
+export function loadRegistry() {
+    return registry;
+}
+export function listByKind(kind) {
+    return registry.entries.filter((entry) => entry.kind === kind);
+}
+export function getEntry(name) {
+    return registry.entries.find((entry) => entry.name === name);
+}
+//# 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,iCAAiC;AACjC,OAAO,YAAY,MAAM,kBAAkB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAyC,MAAM,aAAa,CAAC;AAExF,MAAM,QAAQ,GAAiB,kBAAkB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;AAEtE,2HAA2H;AAC3H,MAAM,UAAU,YAAY;IAC1B,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,IAAO;IAEP,OAAO,QAAQ,CAAC,OAAO,CAAC,MAAM,CAC5B,CAAC,KAAK,EAAgD,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAC7E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC/D,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,125 @@
+import { z } from "zod";
+/**
+ * One entry per prop, shared by `component` and `chart` entries — both have real per-instance
+ * TypeScript prop types extracted via `react-docgen-typescript` (see `reactDocgenMapping.ts`).
+ * `defaultValue`/`description` are optional: `react-docgen-typescript` returns `""` for
+ * description and `null` for defaultValue when neither exists on the source prop — the
+ * extractor mapping (not this schema) is responsible for converting those to `undefined`.
+ */
+declare const propSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodString;
+    required: z.ZodBoolean;
+    defaultValue: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const registryEntrySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"component">;
+    name: z.ZodString;
+    source: z.ZodString;
+    dependencies: z.ZodArray<z.ZodString>;
+    props: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+        required: z.ZodBoolean;
+        defaultValue: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"icon">;
+    name: z.ZodString;
+    source: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"token">;
+    name: z.ZodString;
+    source: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"motionPreset">;
+    name: z.ZodString;
+    source: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"chart">;
+    name: z.ZodString;
+    source: z.ZodString;
+    dependencies: z.ZodArray<z.ZodString>;
+    props: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+        required: z.ZodBoolean;
+        defaultValue: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"pattern">;
+    name: z.ZodString;
+    source: z.ZodString;
+    dependencies: z.ZodArray<z.ZodString>;
+    patternDependencies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    props: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+        required: z.ZodBoolean;
+        defaultValue: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>], "kind">;
+export declare const registryFileSchema: z.ZodObject<{
+    version: z.ZodString;
+    schemaVersion: z.ZodLiteral<1>;
+    generatedAt: z.ZodString;
+    entries: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"component">;
+        name: z.ZodString;
+        source: z.ZodString;
+        dependencies: z.ZodArray<z.ZodString>;
+        props: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodString;
+            required: z.ZodBoolean;
+            defaultValue: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"icon">;
+        name: z.ZodString;
+        source: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"token">;
+        name: z.ZodString;
+        source: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"motionPreset">;
+        name: z.ZodString;
+        source: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"chart">;
+        name: z.ZodString;
+        source: z.ZodString;
+        dependencies: z.ZodArray<z.ZodString>;
+        props: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodString;
+            required: z.ZodBoolean;
+            defaultValue: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"pattern">;
+        name: z.ZodString;
+        source: z.ZodString;
+        dependencies: z.ZodArray<z.ZodString>;
+        patternDependencies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        props: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodString;
+            required: z.ZodBoolean;
+            defaultValue: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>], "kind">>;
+}, z.core.$strip>;
+export type PropEntry = z.infer<typeof propSchema>;
+export type RegistryEntry = z.infer<typeof registryEntrySchema>;
+export type RegistryFile = z.infer<typeof registryFileSchema>;
+export {};
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;GAMG;AACH,QAAA,MAAM,UAAU;;;;;;iBAMd,CAAC;AA8DH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAO9B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAK7B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AACnD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/schema.js

@@ -0,0 +1,84 @@
+import { z } from "zod";
+/**
+ * One entry per prop, shared by `component` and `chart` entries — both have real per-instance
+ * TypeScript prop types extracted via `react-docgen-typescript` (see `reactDocgenMapping.ts`).
+ * `defaultValue`/`description` are optional: `react-docgen-typescript` returns `""` for
+ * description and `null` for defaultValue when neither exists on the source prop — the
+ * extractor mapping (not this schema) is responsible for converting those to `undefined`.
+ */
+const propSchema = z.object({
+    name: z.string(),
+    type: z.string(),
+    required: z.boolean(),
+    defaultValue: z.string().optional(),
+    description: z.string().optional(),
+});
+const componentEntrySchema = z.object({
+    kind: z.literal("component"),
+    name: z.string(),
+    source: z.string(),
+    dependencies: z.array(z.string()),
+    props: z.array(propSchema),
+});
+const iconEntrySchema = z.object({
+    kind: z.literal("icon"),
+    name: z.string(),
+    source: z.string(),
+});
+const tokenEntrySchema = z.object({
+    kind: z.literal("token"),
+    name: z.string(),
+    source: z.string(),
+});
+/**
+ * `Transition`/`MotionConfig` are genuine components with real props, but every export from
+ * `@nomiedge/motion` (functions, hooks, presets, components alike) gets this same, uniform
+ * shape — no `props` array, unlike `component`/`chart`. A deliberate simplification, not an
+ * oversight: see the design spec's Decision on why motion's two real components don't get
+ * per-prop extraction the way ui/charts components do.
+ */
+const motionPresetEntrySchema = z.object({
+    kind: z.literal("motionPreset"),
+    name: z.string(),
+    source: z.string(),
+});
+const chartEntrySchema = z.object({
+    kind: z.literal("chart"),
+    name: z.string(),
+    source: z.string(),
+    dependencies: z.array(z.string()),
+    props: z.array(propSchema),
+});
+const patternEntrySchema = z.object({
+    kind: z.literal("pattern"),
+    name: z.string(),
+    source: z.string(),
+    dependencies: z.array(z.string()),
+    /**
+     * Other `@nomiedge/patterns` entries this pattern's own source imports directly (e.g.
+     * `DataTable` importing `EmptyState` from a sibling directory) — distinct from `dependencies`,
+     * which is external `@nomiedge/*` packages only. Package-mode installs don't need this (the
+     * whole `@nomiedge/patterns` package already ships every pattern's file together), but
+     * source-mode vendoring does: without it, `nomiedge add pattern:DataTable --mode=source`
+     * copies only `DataTable.tsx` and leaves its `../empty-state/EmptyState` import dangling in
+     * the target project. Defaults to `[]` so entries with no intra-package composition (the
+     * common case) don't need to say so explicitly.
+     */
+    patternDependencies: z.array(z.string()).default([]),
+    props: z.array(propSchema),
+});
+export const registryEntrySchema = z.discriminatedUnion("kind", [
+    componentEntrySchema,
+    iconEntrySchema,
+    tokenEntrySchema,
+    motionPresetEntrySchema,
+    chartEntrySchema,
+    patternEntrySchema,
+]);
+export const registryFileSchema = z.object({
+    version: z.string(),
+    schemaVersion: z.literal(1),
+    generatedAt: z.string(),
+    entries: z.array(registryEntrySchema),
+});
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

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

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@nomiedge/registry",
+  "version": "0.1.0",
+  "description": "A generated, machine-readable manifest of every @nomiedge/ui component, icon, token, motion export, and chart type.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "registry.json"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "zod": "^4.4.3",
+    "@nomiedge/ui": "0.1.0",
+    "@nomiedge/icons": "0.1.0",
+    "@nomiedge/tokens": "0.1.0",
+    "@nomiedge/motion": "0.1.0",
+    "@nomiedge/charts": "0.1.0",
+    "@nomiedge/patterns": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.0",
+    "@types/react": "^19.0.2",
+    "react": "^19.0.0",
+    "react-docgen-typescript": "^2.4.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3",
+    "vitest": "^3.2.6"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "build:registry": "tsx src/build/run.ts",
+    "check-registry": "tsx src/build/check-drift.ts",
+    "lint": "eslint src",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist"
+  }
+}