inventive-ui 0.0.10 → 0.0.12

package/README.md

@@ -34,7 +34,7 @@ Inventive UI builds utility CSS at **dev/build time** (Node), then injects it in
 | Webpack | `plugins: [...inventiveUiWebpack()]` + `html-webpack-plugin` in the app |
 | Next.js | `export default withIUI({ ... })` + root `<IUIRegistry>` |
 
-`iui.config.ts` can include an optional compile-first `build` block. **`scanDirs` / `scanPackages` are not required** — Framework defaults to `["src", ".iui"]` and `["@inventive-ui/components"]`.
+`theme.config.ts` can include an optional compile-first `build` block. **`scanDirs` / `scanPackages` are not required** — Framework defaults to `["src", ".iui"]` and `["@inventive-ui/components"]`.
 
 Documented init toggles (`packageSafelist`, `includeShadeMatrix`, theme/palette/arbitrary flags, etc.) are listed in Framework `docs/01-compile-first-guide.md` for the docs site.
 
@@ -51,7 +51,7 @@ Documented init toggles (`packageSafelist`, `includeShadeMatrix`, theme/palette/
 ```bash
 iui login
 iui init                    # interactive — creates configs, installs framework
-iui install components      # install @inventive-ui/components + prepare slots
+iui install components      # install @inventive-ui/components + sync the project registry
 iui install assets          # optional — interactive asset picker
 ```
 
@@ -89,14 +89,14 @@ Every command below is implemented in the CLI today. Run `iui --help` or `iui <c
 | `iui init` | Initialize a new project: register, install framework, write configs | Yes |
 | `iui setup` | Clone-to-green: `.npmrc`, install deps, run doctor | Yes |
 | `iui install framework` | Install or reinstall `@inventive-ui/framework` | Yes |
-| `iui install components` | Install `@inventive-ui/components` and rebuild slot registry | Yes |
+| `iui install components` | Install `@inventive-ui/components` and sync the project registry | Yes |
 | `iui install assets [ids...]` | Install asset packages (interactive picker if no ids) | Yes |
-| `iui list` | Show installed framework, components, assets, and slots | No |
+| `iui list` | Show installed framework, components, and assets | No |
 | `iui list -a` | Show all components available in the registry | No |
 | `iui update` | Check and apply framework, component, asset, and CLI updates | Yes |
 | `iui doctor` | Run project health diagnostics | No |
 | `iui assets list` | Show available and installed asset packages | Yes |
-| `iui assets remove <id>` | Uninstall an asset package and update slot registry | Yes |
+| `iui assets remove <id>` | Uninstall an asset package and update `assets.config.json` | Yes |
 | `iui team list` | List team seat assignments (admin) | Yes |
 | `iui team add [email]` | Add a teammate to team seats (admin) | Yes |
 | `iui team remove [email]` | Remove a teammate from active seats (admin) | Yes |
@@ -106,7 +106,7 @@ Every command below is implemented in the CLI today. Run `iui --help` or `iui <c
 | `iui deploy-token create [name]` | Create a short-lived scoped deploy token | Yes |
 | `iui deploy-token revoke <id>` | Revoke a deploy token immediately | Yes |
 
-**Note:** Inside an initialized project, most commands automatically validate and repair the slot registry before running.
+**Note:** Inside an initialized project, most commands automatically validate and repair the project registry (component manifest, assets config, bootstrap) before running.
 
 ### Global options
 
@@ -175,8 +175,8 @@ Initialize an Inventive UI project in the current directory (or workspace root w
 - Writes project `.npmrc` (scope line only) and updates `.gitignore`
 - Ensures React 19.x or Vite 6.x+ is present (installs if missing)
 - Installs `@inventive-ui/framework` and `@inventive-ui/components`
-- Generates `iui.config.ts` (with compile-first `build` block), `component.config.ts`, `assets.config.json`, and Vite/TS configs as needed
-- Creates `.iui/project.json`, component/package manifests, and the slot registry
+- Generates `theme.config.ts` (with compile-first `build` block), `component.config.ts`, `assets.config.json`, and Vite/TS configs as needed
+- Creates `.iui/project.json`, component/package manifests, and the generated bootstrap
 
 | Option | Description |
 | ------ | ----------- |
@@ -242,11 +242,11 @@ iui -C apps/docs install framework
 
 ### `iui install components`
 
-Install or reinstall `@inventive-ui/components` and rebuild the slot registry.
+Install or reinstall `@inventive-ui/components` and sync the project registry.
 
 **What it does:**
 - Installs the component library package
-- Regenerates `.iui/generated/` slot files and updates manifests
+- Regenerates `.iui/generated/bootstrap.generated.tsx`, updates manifests, and removes stale component-slot output from older CLI versions
 - Syncs `package.json` if `node_modules` is ahead of the declared semver range
 - Skips reinstall if the same version is already installed (unless upgrading via `iui update`)
 
@@ -268,7 +268,7 @@ Install one or more asset packages (icons, illustrations, logos, flags, emoji, l
 **What it does:**
 - Validates license
 - Shows an interactive picker when no package ids are given
-- Installs selected packages and updates `assets.config.json` and the slot registry
+- Installs selected packages and updates `assets.config.json`
 
 | Option | Description |
 | ------ | ----------- |
@@ -300,7 +300,7 @@ iui install assets illustrations flags emoji
 
 ### `iui list`
 
-Show installed framework version, component count, asset packages, and slot registry status for the current project.
+Show installed framework version, component count, and asset packages for the current project.
 
 ```bash
 iui list
@@ -328,7 +328,7 @@ Check for and apply updates to the framework, components, individual components,
 - Reports if a newer CLI version exists (upgrade with `npx inventive-ui@latest`)
 - Checks registry for component, framework, and asset updates
 - Respects license update window (expired licenses see available versions but cannot install)
-- Installs selected updates and rebuilds slot registry
+- Installs selected updates and syncs the project registry
 - Syncs `@inventive-ui/*` entries in `package.json` to `^<installed>` when `node_modules` is ahead
 
 | Option | Description |
@@ -357,13 +357,13 @@ Run a multi-point health check. Read-only by default; exits with code `1` if any
 - Project initialized (`.iui/project.json`)
 - `@inventive-ui/framework` and `@inventive-ui/components` installed
 - React 19.x or Vite 6.x (and matching `react-dom`)
-- **Three-config tiers:** `iui.config.ts` must not import `assets.config.json` or contain asset/component keys; `assets.config.json` schema + `globalIcons`; `component.config.ts` must not contain theme keys
+- **Three-config tiers:** `theme.config.ts` must not import `assets.config.json` or contain asset/component keys; `assets.config.json` schema + `globalIcons`; `component.config.ts` must not contain theme keys
 - Component and asset package counts
-- Slot registry integrity
+- Stale component-slot output from older CLI versions
 - Package compatibility between framework and components
 - Whether installed versions are behind latest (warns to run `iui update`)
 - Syncs `package.json` when `node_modules` is ahead of declared ranges
-- Generated slot file validity
+- Generated bootstrap matches project config paths
 - `component.config.ts` validity (TypeScript check)
 - Compile-first bundler wiring (Vite/Webpack/Next plugin present when tooling detected)
 
@@ -371,8 +371,8 @@ In monorepos, doctors every app with a `.iui/` folder when run from the workspac
 
 | Option | Description |
 | ------ | ----------- |
-| `--fix` | Apply safe fixes (strip assets from `iui.config.ts`, patch build block, repair slots, install TypeScript for config validation) |
-| `--config-only` | Config tiers + slots + compile-first only — no auth/registry. Use in CI and pre-commit hooks |
+| `--fix` | Apply safe fixes (strip assets from `theme.config.ts`, patch build block, regenerate bootstrap and remove stale slot output, install TypeScript for config validation) |
+| `--config-only` | Config tiers + stale slot output + compile-first only — no auth/registry. Use in CI and pre-commit hooks |
 
 ```bash
 iui doctor
@@ -395,7 +395,7 @@ iui assets list
 
 ### `iui assets remove <id>`
 
-Remove an installed asset package, update `assets.config.json`, and prune its slots.
+Remove an installed asset package, and update `assets.config.json`.
 
 ```bash
 iui assets remove illustrations
@@ -556,23 +556,22 @@ After `iui init`, the CLI manages:
 
 | Path | Purpose |
 | ---- | ------- |
-| `iui.config.ts` | `IUIThemeConfig` — theme, states, core, compile-first `build` block (no assets import) |
+| `theme.config.ts` | `IUIThemeConfig` — theme, states, core, compile-first `build` block (no assets import) |
 | `component.config.ts` | `ComponentConfig` (`@inventive-ui/components/config`) — optional per-component defaults |
 | `assets.config.json` | `IUIAssetsConfig` — libraries, `globalIcons`, `@alias` maps, binding/preload |
 | `.iui/project.json` | Project ID, license, repo metadata |
 | `.iui/components.json` | Installed component versions |
 | `.iui/packages.json` | Installed asset package versions |
-| `.iui/slots.json` | Slot registry (components + assets) |
-| `.iui/generated/` | Managed slot helpers from the components **public slot contract** (do not edit) |
-| `.iui/slot-registration-state.json` | Operational checksum/state for no-op validation (ephemeral) |
-| `.iui/slot-registration.lock` | Short-lived lock file during slot reconciliation (ephemeral) |
+| `.iui/generated/bootstrap.generated.tsx` | Managed bootstrap wiring theme + assets + component configs (do not edit) |
+| `.iui/cache/slot-state.json` | Operational checksum/state for no-op validation (ephemeral; historical name) |
+| `.iui/cache/slot.lock` | Short-lived lock file during registry reconciliation (ephemeral) |
 | `.iui/classes.cache.json`, `.iui/build-*`, `public/iui/` | Compile-first build cache artifacts (ephemeral) |
 
 Framework install status comes from `@inventive-ui/framework` in `node_modules`, not from `.iui/` metadata.
 
-Commit `package.json`, one lockfile, `.iui/` metadata and generated slot helpers, config files, and the project `.npmrc` scope line (no tokens). Do not commit ephemeral `.iui` state/lock/build-cache files. See [Team onboarding](docs/TEAM-ONBOARDING.md#what-to-commit-in-a-shared-repo).
+Commit `package.json`, one lockfile, `.iui/` metadata and `.iui/generated/`, config files, and the project `.npmrc` scope line (no tokens). Do not commit ephemeral `.iui` state/lock/build-cache files. See [Team onboarding](docs/TEAM-ONBOARDING.md#what-to-commit-in-a-shared-repo).
 
-For the full integration map (Framework, Components, configs, bundlers), see [Architecture](docs/ARCHITECTURE.md). For ownership rules, validate vs repair, grouped slot codegen driven by `public-slot-contract.json`, and write-amplification KPIs, see [Consumer Codegen & Config Ownership](docs/CONSUMER-CODEGEN.md).
+For the full integration map (Framework, Components, configs, bundlers), see [Architecture](docs/ARCHITECTURE.md). For ownership rules, validate vs repair, stale component-slot cleanup, and write-amplification KPIs, see [Consumer Codegen & Config Ownership](docs/CONSUMER-CODEGEN.md).
 
 ---
 
@@ -637,7 +636,7 @@ npm run start -- <cmd> # run built CLI locally, e.g. npm run start -- doctor
 | Doc | Audience |
 | --- | --- |
 | [ARCHITECTURE.md](docs/ARCHITECTURE.md) | **Start here** — full CLI flow and integration with Framework, Components, configs, bundlers |
-| [CONSUMER-CODEGEN.md](docs/CONSUMER-CODEGEN.md) | File ownership, validate vs repair, slot codegen |
+| [CONSUMER-CODEGEN.md](docs/CONSUMER-CODEGEN.md) | File ownership, validate vs repair, stale slot cleanup |
 | [TEAM-ONBOARDING.md](docs/TEAM-ONBOARDING.md) | Clone-to-green, CI tokens, what to commit |
 | [RFC-002](docs/RFC-002-package-owned-runtime-registry.md) | 2.0 package-owned slot registry direction |
 | [RFC-003](docs/RFC-003-CLI-GATING.md) | CLI gating / release policy |