- Updated scripts & cdn link to
raw.githubusercontent.com/ui8kit/core
- Refactored utility map generation to use config-driven sources in
SCHEMA_CONFIGand emit a deterministic flatmap: string[]inui8kit.map.json:version,generatedAt, and a class array. - Added support for extracting runtime-aware class expansions from
src/lib/utility-props.ts(forflexdirection values and semanticgapaliases) while keeping the map wrapper shape stable.
- Added import style configuration for component installation:
--import-stylecommand option ininit(aliasdefault,packageoptional).- Support for package-style rewrites (
@ui8kit/core) whenimportStyleis set topackage.
- Added automatic dependency metadata flow from registry artifacts into installation paths (npm deps and registry dependencies), including
--alland nested component installs.
- Moved creation of base project directories from
initto bulk install flow inadd --all. initnow focuses on config/core bootstrap and does not pre-create emptyblocks,layouts, orvariantsdirectories.add --allnow ensures all required install directories exist before writing files.
- Prevented unnecessary empty directories from appearing after
initwhen only targeted component installs are required. - Improved
--allinstall consistency by normalizing install directory preparation before component writes.
- Added configurable CDN override strategy for command execution via config and flags (
registryUrl,registryVersion,strictCdn) acrossinit,add,list, anddiff. - Extended CDN diagnostics with
--cdnininfoto expose resolved CDN order, active overrides, and working CDN cache state. - Added registry artifact cleanup command
registry cleanwith--dry-run,--force, and--all. - Added full local-state reset command
resetwith--yes,--dry-run,--force, and optional--with-cache. - Added
get-cdndiagnostics coverage and README documentation updates for cache/version troubleshooting workflows. - Added
ui8kit.map.jsongeneration fromsrc/lib/utility-props.map.tsinto thebuildpipeline. - Added TypeScript AST-based utility-map parsing and transformation tests.
- Reordered default CDN base URLs to prefer
unpkgbeforecdn.jsdelivr.net, then GitHub raw fallback. - Improved registry cache handling in
buildby clearing cache before assembling artifacts. - Updated command docs to describe new cleanup/reset workflows and CDN override examples.
- Fixed scanning of
variants/index.tsre-export style entries using TypeScript AST export validation in the manifest pipeline. - Fixed build collisions for synthetic
indexitems by binding artifacts and synthetic variant entries by component identity (name + type). - Fixed
build/scanconsistency forcomponents/indexandcomponents/variants/indexpreservation in the generated registry index.
- Added
info --jsonoutput mode (src/commands/info.ts,src/index.ts) for machine-readable diagnostics. - Added regression coverage for
scan/buildaround variants index behavior (tests/commands/scan.test.ts,tests/commands/build.test.ts). - Added practical roadmap and quality backlog documentation (
.project/IMPROVEMENT.md,.project/BACKLOG.md,.cursor/plans/refactor_variant_index_flow_ac7a81fe.plan.md). - Added
tests/README.mddocumenting CLI test intent, execution strategy, and command coverage.
- Improved CLI diagnostics path with JSON output and richer command coverage visibility via
infocommand tests (tests/commands/info.test.ts). buildnow resets cache state before processing (clearCache+resetCache) to avoid stale artifacts during rebuilds.buildnow updates variants index artifacts by composite identity (type + name) to prevent collisions across component and variants index entries.scannow uses TypeScript AST validation for exports so re-export-basedvariants/index.tsvariants are detected reliably.
- Fixed missing
registry:variantsindexentry in scanned manifest whensrc/variants/index.tsuses only re-export syntax. - Fixed dependency extraction for synthetic variants index to ignore false-positive local imports and parse external dependencies safely via AST.
- Release status: Ready.
- Build and checks:
npm run build,npm run type-check, andnpm run testpass.
infocommand for environment diagnostics (ui8kit info) including CLI version, runtime, config status, CDN and cache health.- Progressive multi-component install feedback in
add([n/total]progress markers). - Initial Vitest test suite scaffold in
tests/for cache, transform, diff, dependency resolver, package manager, errors, logger, project, add, and init.
- Extracted CLI version helper to
src/utils/cli-version.ts. - Added
vitest/@types/difftooling andtestscripts. adddry-run output now consistently displays file-level context with progress position.
infocommand coverage enables easier support troubleshooting.- Added deterministic project setup checks in tests for
buildInitConfigandfindConfig.
- Global flags:
--cwdand--verboseare now available at CLI root level and apply to all commands. initprompts now only ask for:- global CSS path (
globalCss, defaultsrc/index.css) - component alias (
aliasComponents, default@/components)
- global CSS path (
addnow opens an interactive multiselect when no components are provided.- New P2 commands:
listfor listing registry components (with optional--json)difffor local-vs-registry file comparison and unified diff outputcache clearfor wiping local registry cache
- Added filesystem registry cache at
~/.ui8kit/cache/with default TTL1h - Added import alias transform pipeline during install (
transformImports,transformCleanup) for.ts/.tsxfiles
initnow hardcodestypescript: trueandframework: vite-react.- Logging is standardized through the centralized logger with verbose debug mode.
- Error handling is routed through typed errors and centralized
handleError. README.mdupdated with new prompts and global options behavior.add --dry-runnow prints full install paths, overwrite/create status, dependency checks, and file-level diff preview for existing files.- Registry fetch flow now supports
--no-cacheat root command level for bypassing filesystem cache.
addnow resolves registry dependencies with recursive ordering (registryDependencies) and deduplication.- Global
--cwdnow correctly changes working directory before command action execution. - Command-level runtime flow for
scan/build/addnow respects root-level--cwdconsistently. - P2
diffflow is now available to detect local component updates against registry snapshots.
- Completed remaining P1 CLI improvements and stabilized trial run against
.test-app. - Added a full trial report in
REPORT.mdforinit,add,scan, andbuildcommands.