@g3nomaly/ui 0.3.3 → 0.3.5

package/README.md

@@ -1,26 +1,27 @@
 # @g3nomaly/ui
 
-`g3nui` copies React components into your project as source files, the way shadcn does. You own the copied files and can edit them. The g3n components ship with this package and are always available. The CLI can also install shadcn components, and you can register other sources: a git repository, an npm package or a local folder.
+`@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. `g3nui` anchors every command to the repository root.
-- React. Each g3n component is a `.tsx` file that imports its own `.css` file, so your bundler must handle CSS imports.
+- 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 `g3nui` reads the component list from `ui.shadcn.com`
+- network access, since the installer reads the component list from `ui.shadcn.com`
 
-No `components.json` is needed. `g3nui` keeps its own config.
+No `components.json` is needed. The installer keeps its own config.
 
 ## Install components
 
-Run these from the root of your project:
+Run these from the root of your project. Adding the installer first pins its version in `bun.lock`, so everyone on the team runs the same one:
 
 ```sh
+bun add -d @g3nomaly/ui
 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
@@ -28,30 +29,27 @@ 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, and whether to copy the `.debug.ts` and `.meta.ts` files that come with each component. Pass `--install-dir <path>` to skip the questions, or `-f` to reconfigure without being asked first.
+`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`. 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.
+`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.
 
-`g3nui` records what it installed in `.g3n/.g3nui-manifest.json`. Commit it with `.g3n.config.json` so your team gets the same components.
+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>`. The source lists every package those files import as a peer, so they use your app's React and not a second copy. When you install such a source from a folder with `bun add file:<path>`, the installer swaps the link for a packed copy on every `add` and `update`, since a linked folder brings its own `node_modules`. `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.
 
-## The g3n components
+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.
 
-| Key | Group | What it is | Needs |
-|---|---|---|---|
-| `button` | `input` | A button with `primary`, `secondary` and `ghost` variants | |
-| `card` | `basic` | A card container | |
-| `cardheader` | `basic` | The header section of a card | `card` |
-| `cardfooter` | `basic` | The footer section of a card | `card` |
+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. A package a component imports at runtime but your `package.json` lists only under `devDependencies` is reported too: move it to `dependencies` yourself, since the installer keeps the range you gave it.
+
+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 CSS of every component sits under the `.g3nui` class, so it does not leak into the rest of your styles.
+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
 
-shadcn is off until you turn it on. Add `"shadcn"` to `registeredPackages` in `.g3n.config.json`:
+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
 {
-  "g3nui": {
+  "ui": {
     "settings": {
       "registeredPackages": ["shadcn"]
     }
@@ -66,7 +64,13 @@ 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`. `g3nui` writes each file as the shadcn registry serves it and installs the shadcn components it depends on. It does not install npm packages, so add the ones the files import, such as `class-variance-authority` or `radix-ui`, with `bun add`.
+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
 
@@ -78,7 +82,7 @@ bunx @g3nomaly/ui remove cardheader
 bunx @g3nomaly/ui ls --installed
 ```
 
-`update` reinstalls each component from the source it came from. 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.
+`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`.
 
@@ -93,27 +97,46 @@ bunx @g3nomaly/ui manifest
 ```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
+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 `g3nui` source cannot be removed. `source remove` also refuses a source that installed components came from, unless you pass `-f`.
+The built-in `g3n-ui` source cannot be removed. `source remove` also refuses a source that installed components came from, unless you pass `-f`. To point a registered name somewhere else, such as from a local folder to the npm package, pass `-f` to `source add`: `source add npm:my-ui --name mine -f`. Installed components keep their source name, so they update from the new place.
+
+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 <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 github:me/my-ui#v1.2.0`), from your Bun workspace (`"my-ui": "workspace:*"`) or from a folder (`bun add file:../my-ui`). A workspace is the best way to work on a source next to an app |
+| 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 ask you to run `bun install` and leave its components as they are. They never download a different version. A source whose components keep no files in the package is only read by the installer, so `bun add -d` is enough for it. 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 source must hold a built `dist/components.json` next to its files in `dist/components/<group>/`. Each component has a `.meta.ts` file that lists its files and dependencies. `writeComponentsJson` from `@g3nomaly/ui/registry` scans those files and writes `components.json`, and `PackagedComponent` from `@g3nomaly/ui/types` types them.
+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 g3nui -- ls      # the CLI from source
+bun run ui -- ls         # the CLI from source
 bun run typecheck
 bun run lint
 bun test tests/unit
-bun run build            # types, components and dist/components.json into dist/
+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).

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,21 @@ export interface UiProject {
     target: ManifestTarget;
     builtins: SourceRecord;
 }
-/** What the core install commands print, check and fetch for components. */
+/** How the README runs the installer: the project's copy when installed, never a package that merely shares the bin's name. */
+export declare const UI_COMMAND = "bunx @g3nomaly/ui";
+/** 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,15 +77,22 @@ 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.
  *
+ * With `packLocal`, an npm source the app installs from a folder on disk is first installed as a
+ * packed copy, when its components keep files in the package (see `packLocalSources`).
+ *
  * @param project - The opened project.
  * @param flags - Which optional file kinds to read.
- * @param only - Source name to read alone; exits when no such source is registered.
+ * @param options - `only`: source name to read alone, exiting when no such source is registered.
+ * `packLocal`: install or refresh packed copies of local sources first; for commands that install.
  * @returns The components per source; dispose it once read.
  */
-export declare function openComponentRegistry(project: UiProject, flags: ComponentFileFlags, only?: string): Promise<SourceRegistry<ComponentMeta>>;
+export declare function openComponentRegistry(project: UiProject, flags: ComponentFileFlags, options?: {
+    only?: string;
+    packLocal?: boolean;
+}): Promise<SourceRegistry<ComponentMeta>>;
 /**
  * @brief What the core source commands need to know about components in one 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;AAI1E;;;;;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,+HAA+H;AAC/H,eAAO,MAAM,UAAU,sBAAsB,CAAC;AAE9C,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;;;;;;;;;;;;;GAaG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,SAAS,EAClB,KAAK,EAAE,kBAAkB,EACzB,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GACnD,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAmBxC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,GAAG,oBAAoB,CAAC,aAAa,CAAC,CAEvF"}

package/dist/cli/adapter.js

@@ -1,25 +1,36 @@
 // 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. */
+import { packLocalSources } from "./localSources";
+/** How the README runs the installer: the project's copy when installed, never a package that merely shares the bin's name. */
+export const UI_COMMAND = "bunx @g3nomaly/ui";
+/** What the core commands print and check for components. */
 export const UI_CONTEXT = {
-    bin: "g3nui",
+    command: UI_COMMAND,
     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 +38,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 \`${UI_COMMAND} 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,25 +77,31 @@ 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.
  *
+ * With `packLocal`, an npm source the app installs from a folder on disk is first installed as a
+ * packed copy, when its components keep files in the package (see `packLocalSources`).
+ *
  * @param project - The opened project.
  * @param flags - Which optional file kinds to read.
- * @param only - Source name to read alone; exits when no such source is registered.
+ * @param options - `only`: source name to read alone, exiting when no such source is registered.
+ * `packLocal`: install or refresh packed copies of local sources first; for commands that install.
  * @returns The components per source; dispose it once read.
  */
-export async function openComponentRegistry(project, flags, only) {
-    const packages = project.config.g3nui.settings.registeredPackages;
+export async function openComponentRegistry(project, flags, options = {}) {
+    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 }] : [])], options.only, UI_COMMAND).map((s) => s.name);
     const sources = uiSources(project).filter((s) => named.includes(s.name));
+    if (options.packLocal === true)
+        await packLocalSources(project.projectRoot, sources);
     const registry = await loadSourceRegistry(sources, project.projectRoot, readComponentSource(flags));
     if (shadcnOn && named.includes(SHADCN_SOURCE)) {
         const shadcn = await readShadcnEntries();

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 registry = await openComponentRegistry(project, fileFlags(project, options), { packLocal: true });
+    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,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxG,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"}