@g3nomaly/ui 0.3.2 → 0.3.4

package/README.md

@@ -0,0 +1,145 @@
+# @g3nomaly/ui
+
+`@g3nomaly/ui` copies React components into your project as source files, the way shadcn does. You own the copied files and can edit them. This package is the installer only. The g3n components live in [`@g3nomaly/g3n-ui`](https://www.npmjs.com/package/@g3nomaly/g3n-ui), which is built in as a source and always available. The installer can also install shadcn components, and you can register other sources: a git repository, an npm package or a local folder.
+
+## Requirements
+
+- [Bun](https://bun.sh). The CLI runs on Bun only.
+- A git repository. The installer anchors every command to the repository root.
+- React, for the components you install.
+
+For shadcn components you also need:
+
+- the `shadcn` package next to `@g3nomaly/ui` in your project: `bun add -d @g3nomaly/ui shadcn@latest`
+- Tailwind CSS, because shadcn components are styled with Tailwind classes
+- network access, since the installer reads the component list from `ui.shadcn.com`
+
+No `components.json` is needed. The installer keeps its own config.
+
+## Install components
+
+Run these from the root of your project:
+
+```sh
+bunx @g3nomaly/ui init                   # writes .g3n.config.json and asks where components go
+bunx @g3nomaly/ui ls                     # lists the components you can install
+bunx @g3nomaly/ui add button             # installs one component
+bunx @g3nomaly/ui add basic              # or every component in the basic group
+bunx @g3nomaly/ui add                    # or pick from a list
+```
+
+`init` asks for the install directory, `src/components/ui` by default, whether to copy the `.debug.ts` and `.meta.ts` files that come with each component, and for your global stylesheet, which it finds itself when shadcn's `components.json` names it or it sits in a usual place such as `src/index.css`. When your `package.json` lists `shadcn`, it also asks whether to install shadcn components. Pass `--install-dir <path>` to skip the questions, which turns shadcn on when `package.json` lists it, or `-f` to reconfigure without being asked first.
+
+`add` installs the dependencies of a component too, so `add cardheader` also installs `card`. When more than one source offers a name, as a group or a component, `add` asks which source to take it from. Name the source yourself to skip the question: `g3n-ui:basic` for a group, `button@g3n-ui` for a component. Without a terminal, as in CI, `add` prints these forms and stops. Files keep their group folder: `button` lands in `src/components/ui/input/Button.tsx`. The `--debug` and `--meta` flags include the optional files for one run.
+
+Some files stay in their source package, such as a store that manages a component's data. The installer never copies them, and the component imports them from the package, so they update with `bun install`. Such a source must be installed with `bun add` (not `-d`, since your app imports it at runtime) and registered as `npm:<package>`. `add --include-unsafe` copies them next to the component anyway, as an unsafe copy: the component keeps importing the package's version until you point the import at the copy yourself, and `update` and `remove` leave the copy alone.
+
+A component can declare theme tokens its CSS needs, such as shadcn's sidebar colours. After `add` and `update`, the installer adds the ones your stylesheet lacks: to `:root`, `.dark` and `@theme inline`, the blocks a shadcn or tweakcn `globals.css` has. A token your stylesheet already defines keeps your value. Without a stylesheet set, the installer prints the tokens to add by hand.
+
+A component can list the npm packages its files import, such as `radix-ui` or `recharts@3.8.0`. After `add` and `update`, the installer prints each package that your `package.json` does not list, and each installed package whose version is outside the range a component asks for, with the `bun add` command that fixes it. Pass `--install` to run that command for you.
+
+The installer records what it installed, and the sources you registered, in `.g3n/ui.json`. Commit it with `.g3n.config.json` so your team gets the same components and sources.
+
+The g3n components the built-in `g3n-ui` source offers are listed in the [`@g3nomaly/g3n-ui` README](https://www.npmjs.com/package/@g3nomaly/g3n-ui). The installer reads them from `node_modules/@g3nomaly/g3n-ui` when your project has that package, and downloads the latest release otherwise.
+
+## shadcn components
+
+Add the `shadcn` package with `bun add -d shadcn@latest` before you run `init`, and `init` turns shadcn on for you. To turn it on later, run `init` again, or add `"shadcn"` to `registeredPackages` in `.g3n.config.json`:
+
+```json
+{
+  "ui": {
+    "settings": {
+      "registeredPackages": ["shadcn"]
+    }
+  }
+}
+```
+
+shadcn components then show up in `ls` with an `@shadcn/` prefix:
+
+```sh
+bunx @g3nomaly/ui ls --source shadcn
+bunx @g3nomaly/ui add @shadcn/button @shadcn/dialog
+```
+
+Every shadcn file goes to a `shadcn/` folder in your install directory, for example `src/components/ui/shadcn/button.tsx`. The installer also installs the shadcn components it depends on. The registry serves files with imports such as `@/registry/new-york-v4/ui/button`, which only resolve inside the shadcn repository, so the installer rewrites them to the sibling file, `./button`. No path alias is needed.
+
+shadcn components list their npm packages, such as `cn` and `radix-ui`, and the installer checks them like any other component's. Pass `--install` to add them.
+
+The installed `shadcn` package decides the version: each shadcn component records it, and `update` shows the change, such as `@shadcn/button 4.21.1 → 4.22.1`. To move to newer shadcn components, upgrade the package with `bun add -d shadcn@latest`, then run `update`. The shadcn registry only serves its latest files, so an older version cannot be installed again. Your git history keeps the files you had.
+
+Keep formatters and lint fixers away from the `shadcn/` folder and the rest of your install directory. A reformatted file counts as a local change, and `update` then leaves it alone.
+
+## Keep components up to date
+
+```sh
+bunx @g3nomaly/ui update                 # every installed component
+bunx @g3nomaly/ui update button          # one component
+bunx @g3nomaly/ui update --dry-run       # shows what would change
+bunx @g3nomaly/ui remove cardheader
+bunx @g3nomaly/ui ls --installed
+```
+
+`update` reinstalls each component from the source it came from and shows the version change, such as `button 0.1.0 → 0.2.0`. A component that gained a dependency since you installed it gets that dependency installed too. `--dry-run` names it instead. When you have changed an installed file, `update` asks whether to restore the source version, fork the component under a new key that updates leave alone, or skip it and ask again next time. Pass `-f` to restore without asking. `add -f` does the same for files `add` would overwrite.
+
+`remove` offers to remove the installed components that depend on the one you remove. It asks before deleting a file you changed, unless you pass `-f`.
+
+If the manifest is lost or out of date, `manifest` scans the install directory and records every component it finds there that a source offers:
+
+```sh
+bunx @g3nomaly/ui manifest
+```
+
+## Other sources
+
+```sh
+bunx @g3nomaly/ui source add owner/repo                  # a GitHub repository
+bunx @g3nomaly/ui source add https://git.example.com/ui.git --ref v1
+bunx @g3nomaly/ui source add npm:some-components         # an npm package in your package.json
+bunx @g3nomaly/ui source add ./my-components --name mine # a local folder
+bunx @g3nomaly/ui source ls
+bunx @g3nomaly/ui add card@mine                          # a component from one source
+bunx @g3nomaly/ui source remove mine
+```
+
+The built-in `g3n-ui` source cannot be removed. `source remove` also refuses a source that installed components came from, unless you pass `-f`.
+
+Every registered source is stored in `.g3n/ui.json`, so it stays registered for everyone who clones the project. Which kind to use:
+
+| Kind | Register | Version | For |
+|---|---|---|---|
+| npm | `bun add -d <pkg>`, then `source add npm:<pkg>` | `package.json` and `bun.lock`, like any dependency. `update` reads the installed copy | Teams. The package can come from npm, from git (`bun add -d github:me/my-ui#v1.2.0`) or from a folder (`bun add -d file:../my-ui`) |
+| git | `source add owner/repo`, optionally `--ref <tag>` | The branch or tag, cloned on each command | Sources not installed as a package |
+| local | `source add ../my-ui` | Whatever the folder holds | Working on a source next to an app. The path is stored relative to the project, so teammates need the same folder layout |
+
+An npm source must be in your `package.json` before you register it. When `package.json` lists it but `node_modules` does not hold it, commands stop and ask you to run `bun install`. They never download a different version. Unscoped package names need the `npm:` prefix. Scoped names such as `@me/my-ui` work without it.
+
+## Write your own source
+
+```sh
+bunx @g3nomaly/ui source init my-ui      # a package.json, a build script and one example component
+cd my-ui && bun install && bun run build
+```
+
+The comments in the example component explain how a source works: the meta file, how files land in an app, relative imports, files that stay in the package (`install: "package"`, reached through the `exports` field), depending on shadcn components and npm packages, theme colours, versions and publishing. Start in `src/components/example/example.meta.ts`. [`@g3nomaly/g3n-ui`](https://www.npmjs.com/package/@g3nomaly/g3n-ui) is built the same way.
+
+A built source holds `dist/components.json` next to its files in `dist/components/<group>/`. `writeComponentsJson` from `@g3nomaly/ui/registry` writes it from the `.meta.ts` files, and `PackagedComponent` from `@g3nomaly/ui/types` types them.
+
+## Development
+
+Run `bun install` at the repository root first, then every command from this directory.
+
+```sh
+bun run ui -- ls         # the CLI from source
+bun run typecheck
+bun run lint
+bun test tests/unit
+bun run build            # the CLI and its types into dist/
+```
+
+`@g3nomaly/ui` depends on [`@g3nomaly/core`](https://www.npmjs.com/package/@g3nomaly/core), which holds the install logic it shares with [`@g3nomaly/skills`](https://www.npmjs.com/package/@g3nomaly/skills) and [`@g3nomaly/mods`](https://www.npmjs.com/package/@g3nomaly/mods).
+
+## License
+
+Elastic License 2.0. The full text is in the `LICENSE` file of this package.

package/dist/cli/adapter.d.ts

@@ -3,6 +3,7 @@ import type { G3nConfig } from "@g3nomaly/core/config";
 import type { InstallCommandContext, ManifestTarget, SourceCommandContext } from "@g3nomaly/core/cli";
 import type { SourceRegistry } from "@g3nomaly/core/installer";
 import type { RegisteredSource, SourceRecord } from "@g3nomaly/core/sources";
+import type { FetchedComponentFields } from "../registry/adapters/shadcn.adapter";
 import type { ComponentFileFlags } from "../registry/readSource";
 import type { ComponentMeta, ComponentRegistry } from "../registry/types";
 /**
@@ -16,7 +17,7 @@ export interface ProjectDeps {
     builtins?: SourceRecord;
 }
 /**
- * @brief A project opened for a g3nui command: its root, config, the one install target and the built-in sources.
+ * @brief A project opened for a g3n-ui command: its root, config, the one install target and the built-in sources.
  *
  * @property projectRoot - Absolute project root.
  * @property config - Loaded g3n config.
@@ -29,12 +30,19 @@ export interface UiProject {
     target: ManifestTarget;
     builtins: SourceRecord;
 }
-/** What the core install commands print, check and fetch for components. */
+/** What the core commands print and check for components. */
 export declare const UI_CONTEXT: InstallCommandContext<ComponentMeta>;
 /**
- * @brief Anchors the command to the git project, loads its config, migrates a
- * manifest from before the shared shape, and opens the manifest; exits when
- * outside a repo or when the manifest cannot be read.
+ * @brief What the core install commands print, check and fetch for components: shadcn components are
+ * fetched from the shadcn registry, every other component is copied out of its source.
+ *
+ * @param fetchedByKey - Filled with the npm packages and theme tokens of each shadcn component fetched, by component key.
+ * @returns The install context.
+ */
+export declare function uiInstallContext(fetchedByKey: Map<string, FetchedComponentFields>): InstallCommandContext<ComponentMeta>;
+/**
+ * @brief Anchors the command to the git project, loads its config and opens the
+ * manifest; exits when outside a repo or when the manifest cannot be read.
  *
  * @param deps - Test injection.
  * @returns The opened project.
@@ -67,7 +75,7 @@ export declare function fileFlags(project: UiProject, options?: {
 }): ComponentFileFlags;
 /**
  * @brief Reads the components of the project's sources, plus shadcn's when it is in
- * `g3nui.settings.registeredPackages`, and prints what could not be read;
+ * `ui.settings.registeredPackages`, and prints what could not be read;
  * the caller disposes the result.
  *
  * @param project - The opened project.

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

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/cli/adapter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAEtG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAI7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG1E;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,kBAAkB,CAAC,EAAE,OAAO,kBAAkB,CAAC;IAC/C,QAAQ,CAAC,EAAY,YAAY,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAO,SAAS,CAAC;IACvB,MAAM,EAAO,cAAc,CAAC;IAC5B,QAAQ,EAAK,YAAY,CAAC;CAC3B;AAED,4EAA4E;AAC5E,eAAO,MAAM,UAAU,EAAE,qBAAqB,CAAC,aAAa,CAK3D,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,SAAS,CAAC,CAiB9E;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,GAAG,gBAAgB,EAAE,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,GAAG,iBAAiB,CAEzE;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,kBAAkB,CAKnH;AAED;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAkBhJ;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,GAAG,oBAAoB,CAAC,aAAa,CAAC,CAEvF"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/cli/adapter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAEtG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE7E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAGlF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG1E;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,kBAAkB,CAAC,EAAE,OAAO,kBAAkB,CAAC;IAC/C,QAAQ,CAAC,EAAY,YAAY,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAO,SAAS,CAAC;IACvB,MAAM,EAAO,cAAc,CAAC;IAC5B,QAAQ,EAAK,YAAY,CAAC;CAC3B;AAED,6DAA6D;AAC7D,eAAO,MAAM,UAAU,EAAE,qBAAqB,CAAC,aAAa,CAI3D,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,GAAG,qBAAqB,CAAC,aAAa,CAAC,CAExH;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,SAAS,CAAC,CAc9E;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,GAAG,gBAAgB,EAAE,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,GAAG,iBAAiB,CAEzE;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,kBAAkB,CAKnH;AAED;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAkBhJ;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,GAAG,oBAAoB,CAAC,aAAa,CAAC,CAEvF"}

package/dist/cli/adapter.js

@@ -1,25 +1,33 @@
 // packages/ui/src/cli/adapter.ts
 import path from "node:path";
 import { loadConfig, resolveProjectRoot } from "@g3nomaly/core/config";
-import { c, lineError, lineInfo, narrowSources, orExit, reportSourceRegistry } from "@g3nomaly/core/cli";
+import { lineError, narrowSources, orExit, reportSourceRegistry } from "@g3nomaly/core/cli";
 import { entrySource, installedEntries, loadInstallManifest, loadSourceRegistry, manifestSources } from "@g3nomaly/core/installer";
 import { createRegistryStore, register } from "@g3nomaly/core/registry";
 import { readShadcnEntries, shadcnFileSource } from "../registry/adapters/shadcn.adapter";
-import { SHADCN_SOURCE, migrateLegacyManifest, uiManifestPath } from "../registry/manifest";
+import { SHADCN_SOURCE, uiManifestPath } from "../registry/manifest";
 import { readComponentSource } from "../registry/readSource";
 import { ComponentMetaSchema } from "../registry/types";
 import { BUILTIN_SOURCES } from "../sources/builtins";
-/** What the core install commands print, check and fetch for components. */
+/** What the core commands print and check for components. */
 export const UI_CONTEXT = {
-    bin: "g3nui",
+    bin: "g3n-ui",
     noun: "component",
     entrySchema: ComponentMetaSchema,
-    fileSource: (registry) => shadcnFileSource(entrySource(registry)),
 };
 /**
- * @brief Anchors the command to the git project, loads its config, migrates a
- * manifest from before the shared shape, and opens the manifest; exits when
- * outside a repo or when the manifest cannot be read.
+ * @brief What the core install commands print, check and fetch for components: shadcn components are
+ * fetched from the shadcn registry, every other component is copied out of its source.
+ *
+ * @param fetchedByKey - Filled with the npm packages and theme tokens of each shadcn component fetched, by component key.
+ * @returns The install context.
+ */
+export function uiInstallContext(fetchedByKey) {
+    return { ...UI_CONTEXT, fileSource: (registry) => shadcnFileSource(entrySource(registry), fetchedByKey) };
+}
+/**
+ * @brief Anchors the command to the git project, loads its config and opens the
+ * manifest; exits when outside a repo or when the manifest cannot be read.
  *
  * @param deps - Test injection.
  * @returns The opened project.
@@ -27,18 +35,15 @@ export const UI_CONTEXT = {
 export async function openUiProject(deps = {}) {
     const projectRoot = (deps.resolveProjectRoot ?? resolveProjectRoot)();
     if (projectRoot === null) {
-        console.error(lineError("No g3n project found: run `g3nui init` inside a git repository."));
+        console.error(lineError("No g3n project found: run `g3n-ui init` inside a git repository."));
         process.exit(1);
     }
     const config = await loadConfig(projectRoot);
-    const migrated = await migrateLegacyManifest(projectRoot);
-    if (migrated !== null)
-        console.log(lineInfo(`Migrated ${c.file(path.relative(projectRoot, migrated))} to the shared manifest shape`));
     const manifest = orExit(() => loadInstallManifest(uiManifestPath(projectRoot), ComponentMetaSchema));
     return {
         projectRoot,
         config,
-        target: { label: "", installDir: path.join(projectRoot, config.g3nui.settings.componentsDir), store: manifest.store, manifest },
+        target: { label: "", installDir: path.join(projectRoot, config.ui.settings.componentsDir), store: manifest.store, manifest },
         builtins: deps.builtins ?? BUILTIN_SOURCES,
     };
 }
@@ -69,13 +74,13 @@ export function installedComponents(project) {
  */
 export function fileFlags(project, options = {}) {
     return {
-        includeDebug: options.debug ?? project.config.g3nui.settings.includeDebugFiles,
-        includeMeta: options.meta ?? project.config.g3nui.settings.includeMetaFiles,
+        includeDebug: options.debug ?? project.config.ui.settings.includeDebugFiles,
+        includeMeta: options.meta ?? project.config.ui.settings.includeMetaFiles,
     };
 }
 /**
  * @brief Reads the components of the project's sources, plus shadcn's when it is in
- * `g3nui.settings.registeredPackages`, and prints what could not be read;
+ * `ui.settings.registeredPackages`, and prints what could not be read;
  * the caller disposes the result.
  *
  * @param project - The opened project.
@@ -84,9 +89,9 @@ export function fileFlags(project, options = {}) {
  * @returns The components per source; dispose it once read.
  */
 export async function openComponentRegistry(project, flags, only) {
-    const packages = project.config.g3nui.settings.registeredPackages;
+    const packages = project.config.ui.settings.registeredPackages;
     const shadcnOn = packages.includes(SHADCN_SOURCE);
-    const named = narrowSources([...uiSources(project), ...(shadcnOn ? [{ name: SHADCN_SOURCE }] : [])], only, "g3nui").map((s) => s.name);
+    const named = narrowSources([...uiSources(project), ...(shadcnOn ? [{ name: SHADCN_SOURCE }] : [])], only, "g3n-ui").map((s) => s.name);
     const sources = uiSources(project).filter((s) => named.includes(s.name));
     const registry = await loadSourceRegistry(sources, project.projectRoot, readComponentSource(flags));
     if (shadcnOn && named.includes(SHADCN_SOURCE)) {

package/dist/cli/adapter.js.map

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

package/dist/cli/afterInstall.d.ts

@@ -0,0 +1,26 @@
+import type { AfterTarget } from "@g3nomaly/core/cli";
+import type { FetchedComponentFields } from "../registry/adapters/shadcn.adapter";
+import type { UiProject } from "./adapter";
+/**
+ * @brief What runs after components are installed or updated, beside the files.
+ *
+ * @property install - Add missing npm packages with `bun add` instead of only reporting them.
+ * @property includeUnsafe - Also copy the files that stay in the package, such as stores, as unsafe copies.
+ */
+export interface AfterInstallOptions {
+    install: boolean;
+    includeUnsafe: boolean;
+}
+/**
+ * @brief Hook for `add` and `update` that runs once a manifest is saved: records the fields of the
+ * shadcn components just fetched, then, for every component just installed or updated, checks its npm
+ * packages against the app's `package.json`, adds its theme tokens to the app's stylesheet, and with
+ * `includeUnsafe` copies the files it keeps in its package.
+ *
+ * @param project - The opened project, whose settings name the stylesheet.
+ * @param fetchedByKey - Fields per shadcn component key, filled while the files are fetched.
+ * @param options - Install and include-unsafe flags.
+ * @returns The hook to pass to `addFromSources` or `updateFromSources`.
+ */
+export declare function afterComponentInstall(project: UiProject, fetchedByKey: ReadonlyMap<string, FetchedComponentFields>, options: AfterInstallOptions): AfterTarget;
+//# sourceMappingURL=afterInstall.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"afterInstall.d.ts","sourceRoot":"","sources":["../../src/cli/afterInstall.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,oBAAoB,CAAC;AAGtE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAGlF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAwB3C;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAQ,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,sBAAsB,CAAC,EAAE,OAAO,EAAE,mBAAmB,GAAG,WAAW,CAc9J"}

package/dist/cli/afterInstall.js

@@ -0,0 +1,54 @@
+import { installedEntries, saveInstallManifest } from "@g3nomaly/core/installer";
+import { register } from "@g3nomaly/core/registry";
+import { ComponentMetaSchema } from "../registry/types";
+import { reportNpmDependencies } from "./npmDependencies";
+import { copyPackageFiles } from "./packageFiles";
+import { applyThemeTokens } from "./themeTokens";
+/**
+ * @brief Writes what was fetched with shadcn components, their npm packages and theme tokens, into
+ * their manifest entries, since the shadcn index lacks both and the entries were recorded without them.
+ *
+ * @param target - Target whose manifest holds the entries.
+ * @param fetchedByKey - Fields per shadcn component key, as fetched during the install.
+ */
+function recordFetchedFields(target, fetchedByKey) {
+    const installed = installedEntries(target.manifest, ComponentMetaSchema);
+    let changed = false;
+    for (const [key, fields] of fetchedByKey) {
+        const entry = installed[key];
+        if (entry === undefined)
+            continue;
+        register(target.manifest.store, key, { ...entry, ...fields });
+        changed = true;
+    }
+    if (changed)
+        saveInstallManifest(target.manifest, ComponentMetaSchema);
+}
+/**
+ * @brief Hook for `add` and `update` that runs once a manifest is saved: records the fields of the
+ * shadcn components just fetched, then, for every component just installed or updated, checks its npm
+ * packages against the app's `package.json`, adds its theme tokens to the app's stylesheet, and with
+ * `includeUnsafe` copies the files it keeps in its package.
+ *
+ * @param project - The opened project, whose settings name the stylesheet.
+ * @param fetchedByKey - Fields per shadcn component key, filled while the files are fetched.
+ * @param options - Install and include-unsafe flags.
+ * @returns The hook to pass to `addFromSources` or `updateFromSources`.
+ */
+export function afterComponentInstall(project, fetchedByKey, options) {
+    return async (target, keys) => {
+        recordFetchedFields(target, fetchedByKey);
+        const installed = installedEntries(target.manifest, ComponentMetaSchema);
+        const touched = {};
+        for (const key of keys) {
+            const entry = installed[key];
+            if (entry !== undefined)
+                touched[key] = entry;
+        }
+        if (options.includeUnsafe)
+            copyPackageFiles(project, target, touched);
+        await reportNpmDependencies(project.projectRoot, touched, options.install);
+        applyThemeTokens(project.projectRoot, project.config.ui.settings.cssFile, touched);
+    };
+}
+//# sourceMappingURL=afterInstall.js.map

package/dist/cli/afterInstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"afterInstall.js","sourceRoot":"","sources":["../../src/cli/afterInstall.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD;;;;;;GAMG;AACH,SAAS,mBAAmB,CAAC,MAAsB,EAAE,YAAyD;IAC5G,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;IACzE,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QAC9D,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;IACD,IAAI,OAAO;QAAE,mBAAmB,CAAC,MAAM,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;AACzE,CAAC;AAaD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAkB,EAAE,YAAyD,EAAE,OAA4B;IAC/I,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;QAC5B,mBAAmB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC1C,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;QACzE,MAAM,OAAO,GAAkC,EAAE,CAAC;QAClD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAChD,CAAC;QAED,IAAI,OAAO,CAAC,aAAa;YAAE,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACtE,MAAM,qBAAqB,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAC3E,gBAAgB,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACrF,CAAC,CAAC;AACJ,CAAC"}

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

@@ -5,19 +5,25 @@ import type { ProjectDeps } from "../adapter";
  *
  * @property debug - Install `.debug.ts` files; the project setting when absent.
  * @property meta - Install `.meta.ts` files; the project setting when absent.
+ * @property install - Add the npm packages the components need with `bun add`, instead of only reporting them.
+ * @property includeUnsafe - Also copy the files the components keep in their package, such as stores, as unsafe copies they do not import.
  */
 export interface AddOptions extends InstallOptions {
     debug?: boolean;
     meta?: boolean;
+    install?: boolean;
+    includeUnsafe?: boolean;
 }
 /**
  * @brief Installs components or whole groups from the registered sources, each with
  * the components it depends on, keeping locally modified files. A name more
  * than one source offers is picked as `<name>@<source>`; with no names the
- * user picks from what the sources offer.
+ * user picks from what the sources offer. npm packages the components need and
+ * the app lacks are reported afterwards, or added with `install`, and their
+ * theme tokens are added to the app's stylesheet.
  *
  * @param names - Component keys or groups to install, e.g. `button`; empty to pick from the sources.
- * @param options - Force, debug and meta flags.
+ * @param options - Force, debug, meta, install and include-unsafe flags.
  * @param deps - Test injection.
  */
 export declare function addCommand(names: string[], options?: AddOptions, deps?: ProjectDeps): Promise<void>;

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

@@ -1 +1 @@
-{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/add.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAG,OAAO,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,UAAe,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQjH"}
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/add.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C;;;;;;;GAOG;AACH,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD,KAAK,CAAC,EAAU,OAAO,CAAC;IACxB,IAAI,CAAC,EAAW,OAAO,CAAC;IACxB,OAAO,CAAC,EAAQ,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,UAAe,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUjH"}

package/dist/cli/commands/add.js

@@ -1,21 +1,26 @@
 // packages/ui/src/cli/commands/add.ts
 import { addFromSources } from "@g3nomaly/core/cli";
-import { UI_CONTEXT, fileFlags, openComponentRegistry, openUiProject } from "../adapter";
+import { fileFlags, openComponentRegistry, openUiProject, uiInstallContext } from "../adapter";
+import { afterComponentInstall } from "../afterInstall";
 /**
  * @brief Installs components or whole groups from the registered sources, each with
  * the components it depends on, keeping locally modified files. A name more
  * than one source offers is picked as `<name>@<source>`; with no names the
- * user picks from what the sources offer.
+ * user picks from what the sources offer. npm packages the components need and
+ * the app lacks are reported afterwards, or added with `install`, and their
+ * theme tokens are added to the app's stylesheet.
  *
  * @param names - Component keys or groups to install, e.g. `button`; empty to pick from the sources.
- * @param options - Force, debug and meta flags.
+ * @param options - Force, debug, meta, install and include-unsafe flags.
  * @param deps - Test injection.
  */
 export async function addCommand(names, options = {}, deps = {}) {
     const project = await openUiProject(deps);
     const registry = await openComponentRegistry(project, fileFlags(project, options));
+    const fetchedByKey = new Map();
     try {
-        await addFromSources([project.target], names, registry, options, UI_CONTEXT);
+        const check = afterComponentInstall(project, fetchedByKey, { install: options.install === true, includeUnsafe: options.includeUnsafe === true });
+        await addFromSources([project.target], names, registry, options, uiInstallContext(fetchedByKey), check);
     }
     finally {
         registry.dispose();

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

@@ -1 +1 @@
-{"version":3,"file":"add.js","sourceRoot":"","sources":["../../../src/cli/commands/add.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAczF;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAe,EAAE,OAAO,GAAe,EAAE,EAAE,IAAI,GAAgB,EAAE;IAChG,MAAM,OAAO,GAAI,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACnF,IAAI,CAAC;QACH,MAAM,cAAc,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAC/E,CAAC;YAAS,CAAC;QACT,QAAQ,CAAC,OAAO,EAAE,CAAC;IACrB,CAAC;AACH,CAAC"}
+{"version":3,"file":"add.js","sourceRoot":"","sources":["../../../src/cli/commands/add.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE/F,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAiBxD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAe,EAAE,OAAO,GAAe,EAAE,EAAE,IAAI,GAAgB,EAAE;IAChG,MAAM,OAAO,GAAI,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACnF,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkC,CAAC;IAC/D,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,qBAAqB,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,KAAK,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC,CAAC;QACjJ,MAAM,cAAc,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,CAAC;IAC1G,CAAC;YAAS,CAAC;QACT,QAAQ,CAAC,OAAO,EAAE,CAAC;IACrB,CAAC;AACH,CAAC"}

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

@@ -10,6 +10,7 @@ export { lsCommand } from "./ls";
 export type { LsOptions } from "./ls";
 export { sourceAddCommand, sourceLsCommand, sourceRemoveCommand } from "./source";
 export type { SourceAddOptions } from "./source";
+export { sourceInitCommand } from "./sourceInit";
 export { manifestCommand } from "./manifest";
 export type { ManifestDeps } from "./manifest";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,YAAY,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACjC,YAAY,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAClF,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,YAAY,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACjC,YAAY,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAClF,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/cli/commands/index.js

@@ -5,5 +5,6 @@ export { removeCommand } from "./remove";
 export { updateCommand } from "./update";
 export { lsCommand } from "./ls";
 export { sourceAddCommand, sourceLsCommand, sourceRemoveCommand } from "./source";
+export { sourceInitCommand } from "./sourceInit";
 export { manifestCommand } from "./manifest";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEnD,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEnC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAElF,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEnD,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEnC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAElF,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

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

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import type { G3nuiSettings } from "@g3nomaly/core/config";
+import type { UiSettings } from "@g3nomaly/core/config";
 import type { Dialogue, DialogueAnswers } from "@g3nomaly/core/cli";
 import type { ProjectDeps } from "../adapter";
 /**
@@ -18,27 +18,38 @@ declare const UiInitAnswersSchema: z.ZodObject<{
     componentsDir: z.ZodString;
     includeDebugFiles: z.ZodBoolean;
     includeMetaFiles: z.ZodBoolean;
+    cssFile: z.ZodOptional<z.ZodString>;
+    useShadcn: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 /**
- * @brief Answers of the init dialogue, parsed into the g3nui settings.
+ * @brief Answers of the init dialogue, parsed into the ui settings.
  *
  * @property componentsDir - Install directory, relative to the project root, e.g. `src/components`.
  * @property includeDebugFiles - Whether `.debug.ts` files are installed with components.
  * @property includeMetaFiles - Whether `.meta.ts` files are installed with components.
+ * @property cssFile - Global stylesheet theme tokens go into, relative to the project root; absent for none.
+ * @property useShadcn - Whether shadcn components are offered; asked only when `package.json` lists shadcn,
+ * absent to leave the setting as it is.
  */
 export type UiInitAnswers = z.infer<typeof UiInitAnswersSchema>;
 /**
  * @brief Input of the init dialogue: the settings its steps start from.
  *
- * @property settings - Current g3nui settings, the initial value of each step.
+ * @property settings - Current ui settings, the initial value of each step.
+ * @property shadcnInstalled - Whether the project's `package.json` lists the `shadcn` package.
+ * @property detectedCssFile - Global stylesheet found in the project, offered when none is set.
  */
 interface UiInitInput extends Record<string, unknown> {
-    settings: G3nuiSettings;
+    settings: UiSettings;
+    shadcnInstalled: boolean;
+    detectedCssFile?: string;
 }
 export declare const orphanDialogue: Dialogue;
 export declare const initDialogue: Dialogue<UiInitInput>;
 /**
- * @brief Initializes the g3nui config in this project.
+ * @brief Initializes the ui config in this project. The global stylesheet is detected and offered.
+ * When the project's `package.json` lists shadcn, shadcn components are offered too: after asking, or
+ * without asking when the install dir is preset.
  *
  * @param options - Force flag, install dir and preset answers.
  * @param deps - Test injection.

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

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAI3D,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAO,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED,QAAA,MAAM,mBAAmB;;;;iBAIvB,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;;GAIG;AACH,UAAU,WAAY,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnD,QAAQ,EAAE,aAAa,CAAC;CACzB;AAYD,eAAO,MAAM,cAAc,EAAE,QAQ5B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,WAAW,CAqB9C,CAAC;AAuCF;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,OAAO,GAAE,WAAgB,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyElG"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAKxD,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAIpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAO,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED,QAAA,MAAM,mBAAmB;;;;;;iBAMvB,CAAC;AAEH;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;;;;GAMG;AACH,UAAU,WAAY,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnD,QAAQ,EAAU,UAAU,CAAC;IAC7B,eAAe,EAAG,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAYD,eAAO,MAAM,cAAc,EAAE,QAQ5B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,WAAW,CAkC9C,CAAC;AAuDF;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,OAAO,GAAE,WAAgB,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoFlG"}