@g3nomaly/ui 0.3.0 → 0.3.2

package/dist/registry/manifest.js

@@ -0,0 +1,88 @@
+// packages/ui/src/registry/manifest.ts
+import fs from "node:fs";
+import path from "node:path";
+import { z } from "zod";
+import { COMPONENTS_DIR } from "./componentsJson";
+import { groupOf } from "./readSource";
+import { ComponentFileSchema } from "./types";
+const MANIFEST_DIR = ".g3n";
+const MANIFEST_BASE = ".g3nui-manifest";
+/** Source name shadcn components are recorded under. */
+export const SHADCN_SOURCE = "shadcn";
+/** An entry as manifests before the shared `{ sources, entries }` shape recorded it. */
+const LegacyEntrySchema = z.object({
+    name: z.string().min(1),
+    description: z.string().optional(),
+    version: z.string().optional(),
+    category: z.string().optional(),
+    group: z.string().optional(),
+    author: z.string().optional(),
+    packageOrigin: z.string().optional(),
+    registryDependencies: z.array(z.string()).optional(),
+    files: z.array(ComponentFileSchema).min(1),
+});
+/**
+ * @brief Path of the project's g3nui manifest.
+ *
+ * @param projectRoot - Absolute project root, e.g. `/home/me/app`.
+ * @returns absolute path, e.g. `/home/me/app/.g3n/.g3nui-manifest.json`
+ */
+export function uiManifestPath(projectRoot) {
+    return path.join(projectRoot, MANIFEST_DIR, `${MANIFEST_BASE}.json`);
+}
+/**
+ * @brief Converts one legacy entry to the shared shape, taking its origin from `packageOrigin`.
+ *
+ * @param entry - Legacy entry as `LegacyEntrySchema` parses it.
+ * @returns The entry with `group` and `origin` set, as `ComponentMeta` holds them.
+ */
+function migrateEntry(entry) {
+    const { packageOrigin, group, ...rest } = entry;
+    const shadcn = packageOrigin === SHADCN_SOURCE;
+    return {
+        ...rest,
+        group: group ?? groupOf(entry),
+        origin: shadcn ? { source: SHADCN_SOURCE, dir: "" } : { source: "g3nui", dir: COMPONENTS_DIR, version: entry.version },
+    };
+}
+/**
+ * @brief Writes legacy entries as a shared-shape manifest at the JSON path.
+ *
+ * @param projectRoot - Absolute project root, e.g. `/home/me/app`.
+ * @param legacy - Parsed flat manifest: legacy entries keyed by component key.
+ */
+function writeMigrated(projectRoot, legacy) {
+    const entries = Object.fromEntries(Object.entries(z.record(z.string(), LegacyEntrySchema).parse(legacy)).map(([key, entry]) => [key, migrateEntry(entry)]));
+    fs.mkdirSync(path.join(projectRoot, MANIFEST_DIR), { recursive: true });
+    fs.writeFileSync(uiManifestPath(projectRoot), JSON.stringify({ sources: {}, entries }, null, 2) + "\n");
+}
+/**
+ * @brief Rewrites a manifest from before the shared `{ sources, entries }` shape:
+ * a flat `.g3nui-manifest.json`, or a `.g3nui-manifest.ts` whose `registry`
+ * export becomes the JSON file and is then deleted. Does nothing when the
+ * manifest is already in the shared shape or does not exist.
+ *
+ * @param projectRoot - Absolute project root, e.g. `/home/me/app`.
+ * @returns the path that was migrated, or `null` when nothing changed
+ * @throws {Error} When a legacy manifest does not match the old entry shape.
+ */
+export async function migrateLegacyManifest(projectRoot) {
+    const jsonPath = uiManifestPath(projectRoot);
+    const tsPath = path.join(projectRoot, MANIFEST_DIR, `${MANIFEST_BASE}.ts`);
+    if (fs.existsSync(jsonPath)) {
+        const raw = JSON.parse(fs.readFileSync(jsonPath, "utf8"));
+        const shared = typeof raw === "object" && raw !== null && ("entries" in raw || "sources" in raw);
+        if (shared)
+            return null;
+        writeMigrated(projectRoot, raw);
+        return jsonPath;
+    }
+    if (fs.existsSync(tsPath)) {
+        const legacy = z.object({ registry: z.unknown() }).parse(await import(tsPath));
+        writeMigrated(projectRoot, legacy.registry);
+        fs.rmSync(tsPath);
+        return tsPath;
+    }
+    return null;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/registry/manifest.js.map

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

package/dist/registry/readSource.d.ts

@@ -0,0 +1,37 @@
+import type { ReadSource } from "@g3nomaly/core/installer";
+import type { ComponentFile, ComponentMeta, PackagedComponent } from "./types";
+/**
+ * @brief Which optional files of a component get installed.
+ *
+ * @property includeDebug - Install `.debug.ts` files.
+ * @property includeMeta - Install `.meta.ts` files.
+ */
+export interface ComponentFileFlags {
+    includeDebug: boolean;
+    includeMeta: boolean;
+}
+/**
+ * @brief The files of a component the flags allow: `.debug.ts` and `.meta.ts` files only when asked for.
+ *
+ * @param files - Files of one component, each with its path and type.
+ * @param flags - Which optional files to keep.
+ * @returns The kept files, in their original order.
+ */
+export declare function filterFiles(files: readonly ComponentFile[], flags: ComponentFileFlags): ComponentFile[];
+/**
+ * @brief A component's display group: its category, else the first folder of its first file.
+ *
+ * @param meta - Component whose `category` and `files` decide the group.
+ * @returns The group name, or `unknown` when the first file sits at the top level.
+ */
+export declare function groupOf(meta: Pick<PackagedComponent, "category" | "files">): string;
+/**
+ * @brief Reader for a source that is a component package: its `dist/components.json`,
+ * with the files the flags leave out dropped. Handed to `loadSourceRegistry`
+ * by every g3nui command.
+ *
+ * @param flags - Which optional files to keep.
+ * @returns Reader that yields the package's components, skipping any left with no files.
+ */
+export declare function readComponentSource(flags: ComponentFileFlags): ReadSource<ComponentMeta>;
+//# sourceMappingURL=readSource.d.ts.map

package/dist/registry/readSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readSource.d.ts","sourceRoot":"","sources":["../../src/registry/readSource.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE/E;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAG,OAAO,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,EAAE,KAAK,EAAE,kBAAkB,GAAG,aAAa,EAAE,CAMvG;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,MAAM,CAInF;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,GAAG,UAAU,CAAC,aAAa,CAAC,CAmBxF"}

package/dist/registry/readSource.js

@@ -0,0 +1,58 @@
+import { COMPONENTS_DIR, readComponentsJson } from "./componentsJson";
+/**
+ * @brief The files of a component the flags allow: `.debug.ts` and `.meta.ts` files only when asked for.
+ *
+ * @param files - Files of one component, each with its path and type.
+ * @param flags - Which optional files to keep.
+ * @returns The kept files, in their original order.
+ */
+export function filterFiles(files, flags) {
+    return files.filter((file) => {
+        if (file.path.endsWith(".debug.ts"))
+            return flags.includeDebug;
+        if (file.path.endsWith(".meta.ts"))
+            return flags.includeMeta;
+        return true;
+    });
+}
+/**
+ * @brief A component's display group: its category, else the first folder of its first file.
+ *
+ * @param meta - Component whose `category` and `files` decide the group.
+ * @returns The group name, or `unknown` when the first file sits at the top level.
+ */
+export function groupOf(meta) {
+    if (meta.category !== undefined)
+        return meta.category;
+    const first = meta.files[0]?.path ?? "";
+    return first.includes("/") ? first.split("/")[0] ?? "unknown" : "unknown";
+}
+/**
+ * @brief Reader for a source that is a component package: its `dist/components.json`,
+ * with the files the flags leave out dropped. Handed to `loadSourceRegistry`
+ * by every g3nui command.
+ *
+ * @param flags - Which optional files to keep.
+ * @returns Reader that yields the package's components, skipping any left with no files.
+ */
+export function readComponentSource(flags) {
+    return async (checkout) => {
+        const entries = [];
+        const warnings = [];
+        for (const [key, meta] of Object.entries(readComponentsJson(checkout.dir))) {
+            const files = filterFiles(meta.files, flags);
+            if (files.length === 0) {
+                warnings.push(`${key} has no files left after filtering, skipped`);
+                continue;
+            }
+            entries.push([key, {
+                    ...meta,
+                    group: groupOf(meta),
+                    origin: { source: checkout.name, dir: COMPONENTS_DIR, commit: checkout.commit, version: checkout.version },
+                    files,
+                }]);
+        }
+        return { entries, warnings };
+    };
+}
+//# sourceMappingURL=readSource.js.map

package/dist/registry/readSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readSource.js","sourceRoot":"","sources":["../../src/registry/readSource.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AActE;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,KAA+B,EAAE,KAAyB;IACpF,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3B,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;YAAE,OAAO,KAAK,CAAC,YAAY,CAAC;QAC/D,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;YAAG,OAAO,KAAK,CAAC,WAAW,CAAC;QAC9D,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,IAAmD;IACzE,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,QAAQ,CAAC;IACtD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;IACxC,OAAO,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAyB;IAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,EAAE;QACxB,MAAM,OAAO,GAA8B,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC3E,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAC7C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,QAAQ,CAAC,IAAI,CAAC,GAAG,GAAG,6CAA6C,CAAC,CAAC;gBACnE,SAAS;YACX,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE;oBACjB,GAAG,IAAI;oBACP,KAAK,EAAG,OAAO,CAAC,IAAI,CAAC;oBACrB,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE;oBAC1G,KAAK;iBACN,CAAC,CAAC,CAAC;QACN,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAC/B,CAAC,CAAC;AACJ,CAAC"}

package/dist/registry/types.d.ts

@@ -0,0 +1,100 @@
+import { z } from "zod";
+export declare const ComponentFileTypeSchema: z.ZodEnum<{
+    component: "component";
+    hook: "hook";
+    meta: "meta";
+    style: "style";
+    type: "type";
+    util: "util";
+}>;
+/** Kind of a component file: `component`, `style`, `util`, `hook`, `type` or `meta`. */
+export type ComponentFileType = z.infer<typeof ComponentFileTypeSchema>;
+/** One file of a component; `path` is relative to the components directory, e.g. `basic/Card.tsx`. */
+export declare const ComponentFileSchema: z.ZodObject<{
+    path: z.ZodString;
+    hash: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    type: z.ZodEnum<{
+        component: "component";
+        hook: "hook";
+        meta: "meta";
+        style: "style";
+        type: "type";
+        util: "util";
+    }>;
+}, z.core.$strip>;
+/** A file of a component: the base file entry plus its `ComponentFileType`. */
+export type ComponentFile = z.infer<typeof ComponentFileSchema>;
+/**
+ * @brief A component as it ships: what a `*.meta.ts` file declares and what
+ * `dist/components.json` holds per component, before a source reads it.
+ *
+ * @property version - Set at build time from the package version.
+ * @property registryDependencies - Keys of components this one needs installed beside it, e.g. `button`.
+ * @property files - Files of the component, each with its path and `ComponentFileType`.
+ */
+export declare const PackagedComponentSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodString>;
+    registryDependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        hash: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+        type: z.ZodEnum<{
+            component: "component";
+            hook: "hook";
+            meta: "meta";
+            style: "style";
+            type: "type";
+            util: "util";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** A component as it ships, the type `PackagedComponentSchema` parses. */
+export type PackagedComponent = z.infer<typeof PackagedComponentSchema>;
+/**
+ * @brief One installable component, read from a source by `readComponentSource`
+ * or the shadcn adapter, and written per install into the g3nui manifest by
+ * the `add` and `update` commands.
+ *
+ * @property group - Display group: the category, or the first folder of the first file, e.g. `basic`.
+ * @property files - Files the install writes, each with its path and `ComponentFileType`.
+ */
+export declare const ComponentMetaSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    registryDependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    origin: z.ZodObject<{
+        source: z.ZodString;
+        dir: z.ZodString;
+        commit: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    forkedFrom: z.ZodOptional<z.ZodString>;
+    group: z.ZodString;
+    category: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodString>;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        hash: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+        type: z.ZodEnum<{
+            component: "component";
+            hook: "hook";
+            meta: "meta";
+            style: "style";
+            type: "type";
+            util: "util";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** One installable component, the type `ComponentMetaSchema` parses. */
+export type ComponentMeta = z.infer<typeof ComponentMetaSchema>;
+/** Installable components by key, e.g. `button` or `@shadcn/button`. */
+export type ComponentRegistry = Record<string, ComponentMeta>;
+//# sourceMappingURL=types.d.ts.map

package/dist/registry/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/registry/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,uBAAuB;;;;;;;EAOlC,CAAC;AAEH,wFAAwF;AACxF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,sGAAsG;AACtG,eAAO,MAAM,mBAAmB;;;;;;;;;;;;iBAE9B,CAAC;AAEH,+EAA+E;AAC/E,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;iBAQlC,CAAC;AAEH,0EAA0E;AAC1E,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAK9B,CAAC;AAEH,wEAAwE;AACxE,MAAM,MAAM,aAAa,GAAO,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACpE,wEAAwE;AACxE,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC"}

package/dist/registry/types.js

@@ -0,0 +1,48 @@
+// packages/ui/src/registry/types.ts
+import { z } from "zod";
+import { BaseFileEntrySchema } from "@g3nomaly/core/registry";
+import { OriginEntrySchema } from "@g3nomaly/core/installer";
+export const ComponentFileTypeSchema = z.enum([
+    "component",
+    "style",
+    "util",
+    "hook",
+    "type",
+    "meta",
+]);
+/** One file of a component; `path` is relative to the components directory, e.g. `basic/Card.tsx`. */
+export const ComponentFileSchema = BaseFileEntrySchema.extend({
+    type: ComponentFileTypeSchema,
+});
+/**
+ * @brief A component as it ships: what a `*.meta.ts` file declares and what
+ * `dist/components.json` holds per component, before a source reads it.
+ *
+ * @property version - Set at build time from the package version.
+ * @property registryDependencies - Keys of components this one needs installed beside it, e.g. `button`.
+ * @property files - Files of the component, each with its path and `ComponentFileType`.
+ */
+export const PackagedComponentSchema = z.object({
+    name: z.string().min(1),
+    description: z.string().optional(),
+    version: z.string().min(1).optional(),
+    category: z.string().optional(),
+    author: z.string().optional(),
+    registryDependencies: z.array(z.string()).optional(),
+    files: z.array(ComponentFileSchema).min(1),
+});
+/**
+ * @brief One installable component, read from a source by `readComponentSource`
+ * or the shadcn adapter, and written per install into the g3nui manifest by
+ * the `add` and `update` commands.
+ *
+ * @property group - Display group: the category, or the first folder of the first file, e.g. `basic`.
+ * @property files - Files the install writes, each with its path and `ComponentFileType`.
+ */
+export const ComponentMetaSchema = OriginEntrySchema.extend({
+    group: z.string().min(1),
+    category: z.string().optional(),
+    author: z.string().optional(),
+    files: z.array(ComponentFileSchema).min(1),
+});
+//# sourceMappingURL=types.js.map

package/dist/registry/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/registry/types.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC5C,WAAW;IACX,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;CACP,CAAC,CAAC;AAKH,sGAAsG;AACtG,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,MAAM,CAAC;IAC5D,IAAI,EAAE,uBAAuB;CAC9B,CAAC,CAAC;AAKH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAkB,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvC,WAAW,EAAW,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3C,OAAO,EAAe,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAClD,QAAQ,EAAc,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3C,MAAM,EAAgB,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3C,oBAAoB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpD,KAAK,EAAiB,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CAC1D,CAAC,CAAC;AAKH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC,MAAM,CAAC;IAC1D,KAAK,EAAK,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,MAAM,EAAI,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,KAAK,EAAK,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CAC9C,CAAC,CAAC"}

package/dist/sources/builtins.d.ts

@@ -0,0 +1,8 @@
+import type { SourceRecord } from "@g3nomaly/core/sources";
+/**
+ * @brief Sources every project has without registering them; they cannot be
+ * removed. `g3nui` is this package's own folder, so the components always
+ * match the CLI that installs them.
+ */
+export declare const BUILTIN_SOURCES: SourceRecord;
+//# sourceMappingURL=builtins.d.ts.map

package/dist/sources/builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../src/sources/builtins.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG3D;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,YAE7B,CAAC"}

package/dist/sources/builtins.js

@@ -0,0 +1,10 @@
+import { findPackageRoot } from "@g3nomaly/core/utils";
+/**
+ * @brief Sources every project has without registering them; they cannot be
+ * removed. `g3nui` is this package's own folder, so the components always
+ * match the CLI that installs them.
+ */
+export const BUILTIN_SOURCES = {
+    g3nui: { kind: "local", path: findPackageRoot(import.meta.dir) },
+};
+//# sourceMappingURL=builtins.js.map

package/dist/sources/builtins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.js","sourceRoot":"","sources":["../../src/sources/builtins.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAiB;IAC3C,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE;CACjE,CAAC"}

package/package.json

@@ -1,6 +1,87 @@
 {
   "name": "@g3nomaly/ui",
-  "version": "0.3.0",
-  "description": "Placeholder. This package name is reserved; no functional release is currently published.",
-  "license": "MIT"
+  "version": "0.3.2",
+  "description": "Component library with CLI installer for g3n projects.",
+  "type": "module",
+  "bin": {
+    "g3nui": "./dist/cli/index.js"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./registry": {
+      "types": "./dist/registry/index.d.ts",
+      "default": "./dist/registry/index.js"
+    },
+    "./types": {
+      "types": "./dist/registry/types.d.ts",
+      "default": "./dist/registry/types.js"
+    },
+    "./package.json": "./package.json",
+    "./cli/adapter": {
+      "types": "./dist/cli/adapter.d.ts",
+      "default": "./dist/cli/adapter.js"
+    },
+    "./cli/commands": {
+      "types": "./dist/cli/commands/index.d.ts",
+      "default": "./dist/cli/commands/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build:types": "tsc --project tsconfig.build.json",
+    "build:components": "bun scripts/build-components.ts",
+    "build:registry": "bun scripts/build-registry.ts",
+    "build": "rm -rf dist && bun run build:types && bun run build:components && bun run build:registry",
+    "dev": "tsc --project tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts,.tsx",
+    "g3nui": "bun run src/cli/index.ts"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.7.0",
+    "@g3nomaly/core": "^0.3.2",
+    "chalk": "^6.0.0",
+    "commander": "^15.0.0",
+    "glob": "^13.0.6",
+    "zod": "^4.4.3"
+  },
+  "overrides": {
+    "minimatch": "^10.2.5"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.4.0",
+    "@types/node": "^26.2.0",
+    "typescript": "^7.0.2"
+  },
+  "peerDependencies": {
+    "react": "latest",
+    "react-dom": "latest"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "keywords": [
+    "components",
+    "ui",
+    "cli",
+    "registry",
+    "shadcn"
+  ],
+  "license": "Elastic-2.0",
+  "publishConfig": {
+    "access": "public"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# @g3nomaly/ui
-
-Placeholder. This package name is reserved; no functional release is currently published.