@g3nomaly/ui 0.3.0 → 0.3.2

package/dist/cli/commands/ls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ls.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/ls.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,WAAW,SAAU,SAAQ,SAAS;IAC1C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAK,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,OAAO,GAAE,SAAc,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAe9F"}

package/dist/cli/commands/ls.js

@@ -0,0 +1,25 @@
+// packages/ui/src/cli/commands/ls.ts
+import { lsEntries, lsSourceRegistry } from "@g3nomaly/core/cli";
+import { fileFlags, installedComponents, openComponentRegistry, openUiProject, uiSources } from "../adapter";
+/**
+ * @brief Lists the components the sources offer, `●` marking installed ones, or with `installed` only what is installed.
+ *
+ * @param options - Output and filter options.
+ * @param deps - Test injection.
+ */
+export async function lsCommand(options = {}, deps = {}) {
+    const project = await openUiProject(deps);
+    const installed = installedComponents(project);
+    if (options.installed === true) {
+        lsEntries(installed, options);
+        return;
+    }
+    const registry = await openComponentRegistry(project, fileFlags(project), options.source);
+    try {
+        lsSourceRegistry(registry, uiSources(project), installed, options);
+    }
+    finally {
+        registry.dispose();
+    }
+}
+//# sourceMappingURL=ls.js.map

package/dist/cli/commands/ls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ls.js","sourceRoot":"","sources":["../../../src/cli/commands/ls.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAc7G;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAO,GAAc,EAAE,EAAE,IAAI,GAAgB,EAAE;IAC7E,MAAM,OAAO,GAAK,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAE/C,IAAI,OAAO,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QAC/B,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC9B,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1F,IAAI,CAAC;QACH,gBAAgB,CAAC,QAAQ,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;YAAS,CAAC;QACT,QAAQ,CAAC,OAAO,EAAE,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/cli/commands/manifest.d.ts

@@ -0,0 +1,19 @@
+import { glob as _glob } from "glob";
+import type { ProjectDeps } from "../adapter";
+/**
+ * @brief Injection points for `manifestCommand`, on top of the project ones.
+ *
+ * @property glob - Glob used to list the install directory, in place of the `glob` package.
+ */
+export interface ManifestDeps extends ProjectDeps {
+    glob?: typeof _glob;
+}
+/**
+ * @brief Scans the install directory and rebuilds the manifest from what is on
+ * disk: every component the sources offer with at least one file present is
+ * recorded, the first source offering a key winning.
+ *
+ * @param deps - Test injection, including the glob.
+ */
+export declare function manifestCommand(deps?: ManifestDeps): Promise<void>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/cli/commands/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/manifest.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,IAAI,KAAK,EAAE,MAAM,MAAM,CAAC;AAQrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;GAIG;AACH,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC/C,IAAI,CAAC,EAAE,OAAO,KAAK,CAAC;CACrB;AAqCD;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqE5E"}

package/dist/cli/commands/manifest.js

@@ -0,0 +1,95 @@
+// packages/ui/src/cli/commands/manifest.ts
+import chalk from "chalk";
+import fs from "node:fs";
+import path from "node:path";
+import { glob as _glob } from "glob";
+import { register } from "@g3nomaly/core/registry";
+import { offers, saveInstallManifest } from "@g3nomaly/core/installer";
+import { hashFile } from "@g3nomaly/core/hash";
+import { c, sym, lineError } from "@g3nomaly/core/cli";
+import { ComponentMetaSchema } from "../../registry/types";
+import { fileFlags, openComponentRegistry, openUiProject } from "../adapter";
+/**
+ * @brief A path with forward slashes only.
+ *
+ * @param p - Path with any separators.
+ * @returns The same path with `/` separators.
+ */
+function normalisePath(p) {
+    return p.replace(/\\/g, "/");
+}
+/**
+ * @brief Whether a file found on disk is the registry file, compared by path ending.
+ *
+ * @param diskPath - Path found by the disk scan, relative to the install directory.
+ * @param registryPath - Path recorded in the registry, relative to the install directory.
+ */
+function matchesRegistryPath(diskPath, registryPath) {
+    return normalisePath(diskPath).endsWith(normalisePath(registryPath));
+}
+/**
+ * @brief Scans the install directory and rebuilds the manifest from what is on
+ * disk: every component the sources offer with at least one file present is
+ * recorded, the first source offering a key winning.
+ *
+ * @param deps - Test injection, including the glob.
+ */
+export async function manifestCommand(deps = {}) {
+    const { glob = _glob } = deps;
+    const project = await openUiProject(deps);
+    const { projectRoot, config, target } = project;
+    if (!fs.existsSync(target.installDir)) {
+        console.error(lineError(`Install directory not found: ${c.dir(target.installDir)}`));
+        process.exit(1);
+    }
+    console.log();
+    console.log(`${sym.search}  Scanning ${c.dir(config.g3nui.settings.componentsDir)}...`);
+    console.log();
+    const diskFiles = await glob("**/*", { cwd: target.installDir, nodir: true, absolute: false });
+    const registry = await openComponentRegistry(project, fileFlags(project));
+    const available = {};
+    for (const { key, entry } of offers(registry))
+        available[key] ??= entry;
+    registry.dispose();
+    const results = [];
+    for (const [key, meta] of Object.entries(available)) {
+        const presentFiles = [];
+        const missingFiles = [];
+        for (const file of meta.files) {
+            const matched = diskFiles.find((df) => matchesRegistryPath(df, file.path));
+            if (matched) {
+                const hash = await hashFile(path.join(target.installDir, matched));
+                presentFiles.push({ ...file, hash });
+            }
+            else {
+                missingFiles.push(file);
+            }
+        }
+        if (presentFiles.length > 0) {
+            results.push({ key, meta, presentFiles, missingFiles });
+        }
+    }
+    if (results.length === 0) {
+        console.log(chalk.dim("No registered components found on disk."));
+        return;
+    }
+    console.log(chalk.bold(`Found ${chalk.white(results.length)} component${results.length !== 1 ? "s" : ""} matching registry:\n`));
+    for (const { key, meta, presentFiles, missingFiles } of results) {
+        const total = meta.files.length;
+        const found = presentFiles.length;
+        const keyLabel = c.key(key.padEnd(16));
+        if (missingFiles.length === 0) {
+            console.log(`  ${sym.success}  ${keyLabel} ${chalk.dim(`(${found}/${total} files present)`)}`);
+        }
+        else {
+            const missingNames = missingFiles.map((f) => c.file(path.basename(f.path))).join(", ");
+            console.log(`  ${sym.warn}  ${keyLabel} ${chalk.yellow(`(${found}/${total} files present`)} — ${missingNames} ${chalk.yellow("missing)")}`);
+        }
+        register(target.store, key, { ...meta, files: presentFiles });
+    }
+    saveInstallManifest(target.manifest, ComponentMetaSchema);
+    console.log();
+    console.log(chalk.green("Manifest written to ") + c.file(path.relative(projectRoot, target.manifest.filePath)));
+    console.log();
+}
+//# sourceMappingURL=manifest.js.map

package/dist/cli/commands/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../src/cli/commands/manifest.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,IAAI,IAAI,KAAK,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAY7E;;;;;GAKG;AACH,SAAS,aAAa,CAAC,CAAS;IAC9B,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,SAAS,mBAAmB,CAAC,QAAgB,EAAE,YAAoB;IACjE,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;AACvE,CAAC;AAiBD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAI,GAAiB,EAAE;IAC3D,MAAM,EAAE,IAAI,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;IAC9B,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAEhD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QACtC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;QACrF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,cAAc,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACxF,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IAE/F,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1E,MAAM,SAAS,GAAkC,EAAE,CAAC;IACpD,KAAK,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,MAAM,CAAC,QAAQ,CAAC;QAAE,SAAS,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC;IACxE,QAAQ,CAAC,OAAO,EAAE,CAAC;IAEnB,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACpD,MAAM,YAAY,GAAoB,EAAE,CAAC;QACzC,MAAM,YAAY,GAAoB,EAAE,CAAC;QAEzC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,mBAAmB,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAC3E,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;gBACnE,YAAY,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACvC,CAAC;iBAAM,CAAC;gBACN,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC,CAAC;QAClE,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,uBAAuB,CAAC,CAAC,CAAC;IAEjI,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,IAAI,OAAO,EAAE,CAAC;QAChE,MAAM,KAAK,GAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;QACnC,MAAM,KAAK,GAAM,YAAY,CAAC,MAAM,CAAC;QACrC,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAEvC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,KAAK,iBAAiB,CAAC,EAAE,CAAC,CAAC;QACjG,CAAC;aAAM,CAAC;YACN,MAAM,YAAY,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvF,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,KAAK,gBAAgB,CAAC,MAAM,YAAY,IAAI,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAC9I,CAAC;QAED,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,mBAAmB,CAAC,MAAM,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;IAE1D,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAChH,OAAO,CAAC,GAAG,EAAE,CAAC;AAChB,CAAC"}

package/dist/cli/commands/remove.d.ts

@@ -0,0 +1,15 @@
+import type { InstallOptions } from "@g3nomaly/core/cli";
+import type { ProjectDeps } from "../adapter";
+/** Options of `removeCommand`: the core install options, unchanged. */
+export interface RemoveOptions extends InstallOptions {
+}
+/**
+ * @brief Removes installed components and drops them from the manifest. Works from
+ * the manifest alone; installed dependents are offered for removal too.
+ *
+ * @param names - Installed component keys to remove.
+ * @param options - Force flag.
+ * @param deps - Test injection.
+ */
+export declare function removeCommand(names: string[], options?: RemoveOptions, deps?: ProjectDeps): Promise<void>;
+//# sourceMappingURL=remove.d.ts.map

package/dist/cli/commands/remove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/remove.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,uEAAuE;AACvE,MAAM,WAAW,aAAc,SAAQ,cAAc;CAAG;AAExD;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,aAAkB,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGvH"}

package/dist/cli/commands/remove.js

@@ -0,0 +1,16 @@
+// packages/ui/src/cli/commands/remove.ts
+import { removeFromTargets } from "@g3nomaly/core/cli";
+import { UI_CONTEXT, openUiProject } from "../adapter";
+/**
+ * @brief Removes installed components and drops them from the manifest. Works from
+ * the manifest alone; installed dependents are offered for removal too.
+ *
+ * @param names - Installed component keys to remove.
+ * @param options - Force flag.
+ * @param deps - Test injection.
+ */
+export async function removeCommand(names, options = {}, deps = {}) {
+    const project = await openUiProject(deps);
+    await removeFromTargets([project.target], names, options, UI_CONTEXT);
+}
+//# sourceMappingURL=remove.js.map

package/dist/cli/commands/remove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.js","sourceRoot":"","sources":["../../../src/cli/commands/remove.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAMvD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAe,EAAE,OAAO,GAAkB,EAAE,EAAE,IAAI,GAAgB,EAAE;IACtG,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,iBAAiB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AACxE,CAAC"}

package/dist/cli/commands/source.d.ts

@@ -0,0 +1,41 @@
+import type { ProjectDeps } from "../adapter";
+/**
+ * @brief Options of `sourceAddCommand`.
+ *
+ * @property name - Name to register under; derived from the source when absent.
+ * @property ref - Branch or tag a git source is pinned to.
+ */
+export interface SourceAddOptions {
+    name?: string;
+    ref?: string;
+}
+/**
+ * @brief Registers a git repository, npm package or local folder holding a built
+ * `dist/components.json` as a component source, after checking it offers at
+ * least one component.
+ *
+ * @param input - The source as typed, e.g. `owner/repo`, `npm:@scope/ui` or `./dist`.
+ * @param options - Name and ref of the source.
+ * @param deps - Test injection.
+ */
+export declare function sourceAddCommand(input: string, options?: SourceAddOptions, deps?: ProjectDeps): Promise<void>;
+/**
+ * @brief Lists the built-in and registered sources, with how many installed components came from each.
+ *
+ * @param options - Output format.
+ * @param deps - Test injection.
+ */
+export declare function sourceLsCommand(options?: {
+    json?: boolean;
+}, deps?: ProjectDeps): Promise<void>;
+/**
+ * @brief Unregisters a source; refused for built-in sources and, unless forced, while components came from it.
+ *
+ * @param name - Name of the source to unregister, as `source ls` prints it.
+ * @param options - Force flag.
+ * @param deps - Test injection.
+ */
+export declare function sourceRemoveCommand(name: string, options?: {
+    force?: boolean;
+}, deps?: ProjectDeps): Promise<void>;
+//# sourceMappingURL=source.d.ts.map

package/dist/cli/commands/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/source.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAG,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAG3H;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAG7G;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhI"}

package/dist/cli/commands/source.js

@@ -0,0 +1,38 @@
+// packages/ui/src/cli/commands/source.ts
+import { addSourceEntries, lsSources, removeSourceEntries } from "@g3nomaly/core/cli";
+import { openUiProject, uiSourceContext } from "../adapter";
+/**
+ * @brief Registers a git repository, npm package or local folder holding a built
+ * `dist/components.json` as a component source, after checking it offers at
+ * least one component.
+ *
+ * @param input - The source as typed, e.g. `owner/repo`, `npm:@scope/ui` or `./dist`.
+ * @param options - Name and ref of the source.
+ * @param deps - Test injection.
+ */
+export async function sourceAddCommand(input, options = {}, deps = {}) {
+    const project = await openUiProject(deps);
+    await addSourceEntries([project.target], input, options, uiSourceContext(project));
+}
+/**
+ * @brief Lists the built-in and registered sources, with how many installed components came from each.
+ *
+ * @param options - Output format.
+ * @param deps - Test injection.
+ */
+export async function sourceLsCommand(options = {}, deps = {}) {
+    const project = await openUiProject(deps);
+    lsSources([project.target], options, uiSourceContext(project));
+}
+/**
+ * @brief Unregisters a source; refused for built-in sources and, unless forced, while components came from it.
+ *
+ * @param name - Name of the source to unregister, as `source ls` prints it.
+ * @param options - Force flag.
+ * @param deps - Test injection.
+ */
+export async function sourceRemoveCommand(name, options = {}, deps = {}) {
+    const project = await openUiProject(deps);
+    removeSourceEntries([project.target], name, options, uiSourceContext(project));
+}
+//# sourceMappingURL=source.js.map

package/dist/cli/commands/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../../src/cli/commands/source.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAc5D;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAa,EAAE,OAAO,GAAqB,EAAE,EAAE,IAAI,GAAgB,EAAE;IAC1G,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,gBAAgB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;AACrF,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAO,GAAuB,EAAE,EAAE,IAAI,GAAgB,EAAE;IAC5F,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;IAC1C,SAAS,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;AACjE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAY,EAAE,OAAO,GAAwB,EAAE,EAAE,IAAI,GAAgB,EAAE;IAC/G,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;IAC1C,mBAAmB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;AACjF,CAAC"}

package/dist/cli/commands/update.d.ts

@@ -0,0 +1,16 @@
+import type { InstallOptions } from "@g3nomaly/core/cli";
+import type { ProjectDeps } from "../adapter";
+/** Options of `updateCommand`: the core install options, unchanged. */
+export interface UpdateOptions extends InstallOptions {
+}
+/**
+ * @brief Re-installs installed components from the source each one was installed
+ * from; with no names, everything installed. Files the user changed since
+ * install are kept unless overwritten.
+ *
+ * @param names - Installed component keys to update; empty for everything installed.
+ * @param options - Force and dry-run flags.
+ * @param deps - Test injection.
+ */
+export declare function updateCommand(names: string[], options?: UpdateOptions, deps?: ProjectDeps): Promise<void>;
+//# sourceMappingURL=update.d.ts.map

package/dist/cli/commands/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/update.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,uEAAuE;AACvE,MAAM,WAAW,aAAc,SAAQ,cAAc;CAAG;AAExD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,aAAkB,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGvH"}

package/dist/cli/commands/update.js

@@ -0,0 +1,17 @@
+// packages/ui/src/cli/commands/update.ts
+import { updateFromSources } from "@g3nomaly/core/cli";
+import { UI_CONTEXT, fileFlags, openComponentRegistry, openUiProject } from "../adapter";
+/**
+ * @brief Re-installs installed components from the source each one was installed
+ * from; with no names, everything installed. Files the user changed since
+ * install are kept unless overwritten.
+ *
+ * @param names - Installed component keys to update; empty for everything installed.
+ * @param options - Force and dry-run flags.
+ * @param deps - Test injection.
+ */
+export async function updateCommand(names, options = {}, deps = {}) {
+    const project = await openUiProject(deps);
+    await updateFromSources([project.target], names, () => openComponentRegistry(project, fileFlags(project)), options, UI_CONTEXT);
+}
+//# sourceMappingURL=update.js.map

package/dist/cli/commands/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/cli/commands/update.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAMzF;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAe,EAAE,OAAO,GAAkB,EAAE,EAAE,IAAI,GAAgB,EAAE;IACtG,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,iBAAiB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,qBAAqB,CAAC,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AAClI,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env bun
+// packages/ui/src/cli/index.ts
+import { Command } from "commander";
+import { readPackageMeta, warnIfOutdated } from "@g3nomaly/core/utils";
+import { initCommand } from "./commands/init";
+import { addCommand } from "./commands/add";
+import { removeCommand } from "./commands/remove";
+import { updateCommand } from "./commands/update";
+import { lsCommand } from "./commands/ls";
+import { manifestCommand } from "./commands/manifest";
+import { sourceAddCommand, sourceLsCommand, sourceRemoveCommand } from "./commands/source";
+const program = new Command()
+    .name("g3nui")
+    .description("Install components from any registered source into a project");
+program
+    .command("init")
+    .description("Initialize g3nui config in this project")
+    .option("-f, --force", "Overwrite existing config without prompting")
+    .option("--install-dir <path>", "Components install directory (skips interactive prompt)")
+    .action(async (opts) => {
+    await initCommand({ force: opts.force, installDir: opts.installDir });
+});
+const source = program
+    .command("source")
+    .description("Register, list and unregister the sources components are installed from");
+source
+    .command("add <source>")
+    .description("Register a git repository, npm package or local folder holding a built dist/components.json")
+    .option("--name <name>", "Name to register it under (default: derived from the source)")
+    .option("--ref <ref>", "Branch or tag to pin a git source to (default: its default branch)")
+    .action(async (input, opts) => {
+    await sourceAddCommand(input, { name: opts.name, ref: opts.ref });
+});
+source
+    .command("ls")
+    .description("List the registered sources, built-in ones first")
+    .option("--json", "Output as JSON")
+    .action(async (opts) => {
+    await sourceLsCommand({ json: opts.json });
+});
+source
+    .command("remove <name>")
+    .description("Unregister a source; built-in sources cannot be removed")
+    .option("-f, --force", "Unregister even when installed components came from it")
+    .action(async (name, opts) => {
+    await sourceRemoveCommand(name, { force: opts.force });
+});
+program
+    .command("add [components...]")
+    .description("Add components or whole groups with their dependencies; name one source with <component>@<source>")
+    .option("-f, --force", "Overwrite locally modified files")
+    .option("--debug", "Include .debug.ts files")
+    .option("--meta", "Include .meta.ts files")
+    .action(async (components, opts) => {
+    await addCommand(components, { force: opts.force, debug: opts.debug, meta: opts.meta });
+});
+program
+    .command("remove [components...]")
+    .description("Remove components from your project")
+    .option("-f, --force", "Remove even if files have been modified")
+    .action(async (components, opts) => {
+    await removeCommand(components, { force: opts.force });
+});
+program
+    .command("update [components...]")
+    .description("Re-install installed components from the source each came from")
+    .option("-f, --force", "Overwrite conflicting files without prompting")
+    .option("--dry-run", "Preview changes without writing files")
+    .action(async (components, opts) => {
+    await updateCommand(components, { force: opts.force, dryRun: opts.dryRun });
+});
+program
+    .command("ls")
+    .description("List the components the sources offer")
+    .option("--json", "Output as JSON")
+    .option("--source <name>", "Only this source")
+    .option("--installed", "List what the manifest records instead of what the sources offer")
+    .action(async (opts) => {
+    await lsCommand({ json: opts.json, source: opts.source, installed: opts.installed });
+});
+program
+    .command("manifest")
+    .description("Scan install directory and rebuild the manifest")
+    .action(async () => {
+    await manifestCommand();
+});
+const self = readPackageMeta(import.meta.url);
+await warnIfOutdated(self.name, self.version, import.meta.url);
+program.parseAsync();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/components/basic/Card.css

@@ -0,0 +1,32 @@
+.g3nui {
+  &.card {
+    border-radius: 0.5rem;
+    background-color: white;
+    overflow: hidden;
+    transition: all 0.2s ease;
+    
+    /* Variants */
+    &--default {
+      border: 1px solid #e5e7eb;
+    }
+    
+    &--outlined {
+      border: 2px solid #d1d5db;
+    }
+    
+    &--elevated {
+      border: 1px solid #e5e7eb;
+      box-shadow: 0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1);
+      
+      &:hover {
+        box-shadow: 0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1);
+      }
+    }
+    
+    /* Dark mode support */
+    @media (prefers-color-scheme: dark) {
+      background-color: #1f2937;
+      border-color: #374151;
+    }
+  }
+}

package/dist/components/basic/Card.debug.ts

@@ -0,0 +1,5 @@
+// packages/ui/src/components/basic/Card.debug.ts
+export const __debug = {
+  componentName: "Card",
+  version: "0.1.0",
+};

package/dist/components/basic/Card.tsx

@@ -0,0 +1,31 @@
+// packages/ui/src/components/basic/Card.tsx
+import React from 'react';
+import './Card.css';
+
+/**
+ * @brief Props of Card: the content, the extra classes and the look.
+ *
+ * @property children - Content rendered inside the card.
+ * @property className - Extra classes appended to the root element.
+ * @property variant - Look of the card: `default`, `outlined` or `elevated`, set as the `card--<variant>` class.
+ */
+export interface CardProps {
+  children?: React.ReactNode;
+  className?: string;
+  variant?: 'default' | 'outlined' | 'elevated';
+}
+
+export const Card = React.forwardRef<HTMLDivElement, CardProps>(
+  ({ children, className = '', variant = 'default' }, ref) => {
+    return (
+      <div 
+        ref={ref}
+        className={`g3nui card card--${variant} ${className}`}
+      >
+        {children}
+      </div>
+    );
+  }
+);
+
+Card.displayName = 'Card';

package/dist/components/basic/CardFooter.css

@@ -0,0 +1,16 @@
+.g3nui {
+  &.card__footer {
+    padding: 1rem 1.5rem;
+    border-top: 1px solid #e5e7eb;
+    background-color: #f9fafb;
+    
+    &:first-child {
+      border-top: none;
+    }
+    
+    @media (prefers-color-scheme: dark) {
+      border-color: #374151;
+      background-color: #111827;
+    }
+  }
+}

package/dist/components/basic/CardFooter.debug.ts

@@ -0,0 +1,5 @@
+// packages/ui/src/components/basic/CardFooter.debug.ts
+export const __debug = {
+  componentName: "CardFooter",
+  version: "0.1.0",
+};

package/dist/components/basic/CardFooter.tsx

@@ -0,0 +1,29 @@
+// packages/ui/src/components/basic/CardFooter.tsx
+import React from 'react';
+import './CardFooter.css';
+
+/**
+ * @brief Props of CardFooter: the content and the extra classes.
+ *
+ * @property children - Content rendered inside the footer.
+ * @property className - Extra classes appended to the root element.
+ */
+export interface CardFooterProps {
+  children?: React.ReactNode;
+  className?: string;
+}
+
+export const CardFooter = React.forwardRef<HTMLDivElement, CardFooterProps>(
+  ({ children, className = '' }, ref) => {
+    return (
+      <div 
+        ref={ref}
+        className={`g3nui card__footer ${className}`}
+      >
+        {children}
+      </div>
+    );
+  }
+);
+
+CardFooter.displayName = 'CardFooter';

package/dist/components/basic/CardHeader.css

@@ -0,0 +1,14 @@
+.g3nui {
+  &.card__header {
+    padding: 1.5rem;
+    border-bottom: 1px solid #e5e7eb;
+    
+    &:last-child {
+      border-bottom: none;
+    }
+    
+    @media (prefers-color-scheme: dark) {
+      border-color: #374151;
+    }
+  }
+}

package/dist/components/basic/CardHeader.debug.ts

@@ -0,0 +1,5 @@
+// packages/ui/src/components/basic/CardHeader.debug.ts
+export const __debug = {
+  componentName: "CardHeader",
+  version: "0.1.0",
+};

package/dist/components/basic/CardHeader.tsx

@@ -0,0 +1,29 @@
+// packages/ui/src/components/basic/CardHeader.tsx
+import React from 'react';
+import './CardHeader.css';
+
+/**
+ * @brief Props of CardHeader: the content and the extra classes.
+ *
+ * @property children - Content rendered inside the header.
+ * @property className - Extra classes appended to the root element.
+ */
+export interface CardHeaderProps {
+  children?: React.ReactNode;
+  className?: string;
+}
+
+export const CardHeader = React.forwardRef<HTMLDivElement, CardHeaderProps>(
+  ({ children, className = '' }, ref) => {
+    return (
+      <div 
+        ref={ref}
+        className={`g3nui card__header ${className}`}
+      >
+        {children}
+      </div>
+    );
+  }
+);
+
+CardHeader.displayName = 'CardHeader';

package/dist/components/basic/card.meta.ts

@@ -0,0 +1,14 @@
+// packages/ui/src/components/basic/card.meta.ts
+import type { PackagedComponent } from "@g3nomaly/ui/types";
+
+export default {
+  name: "Card",
+  description: "A flexible card component.",
+  category: "basic",
+  files: [
+    { path: "basic/Card.tsx",      type: "component" },
+    { path: "basic/Card.css",      type: "style"     },
+    { path: "basic/Card.debug.ts", type: "util"      },
+  ],
+  registryDependencies: [],
+} satisfies PackagedComponent;