@lema-ufpb/ds-sync 1.0.0 → 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +100 -100
- package/dist/cli.js +8 -8
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,103 +1,103 @@
|
|
|
1
1
|
# @lema-ufpb/ds-sync
|
|
2
2
|
|
|
3
|
-
CLI
|
|
3
|
+
CLI for managing [LEMA Design System](https://ds.lema.ufpb.br) components in consumer projects.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
Replaces `npx shadcn@latest add` in UFPB projects with auth, lockfile, drift detection, and CI.
|
|
6
6
|
|
|
7
|
-
##
|
|
7
|
+
## Installation
|
|
8
8
|
|
|
9
9
|
```bash
|
|
10
10
|
npm install -D @lema-ufpb/ds-sync
|
|
11
11
|
```
|
|
12
12
|
|
|
13
|
-
Configure
|
|
13
|
+
Configure in `.env.local`:
|
|
14
14
|
|
|
15
15
|
```env
|
|
16
|
-
LEMA_DS_TOKEN=<
|
|
16
|
+
LEMA_DS_TOKEN=<your-token>
|
|
17
17
|
LEMA_DS_REGISTRY=https://ds.lema.ufpb.br
|
|
18
18
|
```
|
|
19
19
|
|
|
20
|
-
> Token
|
|
20
|
+
> Token provided by LEMA's NOC. Default registry points to production.
|
|
21
21
|
|
|
22
|
-
##
|
|
22
|
+
## Commands
|
|
23
23
|
|
|
24
24
|
```bash
|
|
25
|
-
npx
|
|
26
|
-
npx
|
|
27
|
-
npx
|
|
28
|
-
npx
|
|
29
|
-
npx
|
|
30
|
-
npx
|
|
31
|
-
npx
|
|
32
|
-
npx
|
|
33
|
-
npx
|
|
34
|
-
npx
|
|
35
|
-
npx
|
|
36
|
-
npx
|
|
37
|
-
npx
|
|
38
|
-
npx
|
|
25
|
+
npx ds list # List available
|
|
26
|
+
npx ds list --installed # Only installed
|
|
27
|
+
npx ds add dashbox bar-chart # Install (resolves registryDeps)
|
|
28
|
+
npx ds add --all # Install everything
|
|
29
|
+
npx ds update dashbox # Update component(s)
|
|
30
|
+
npx ds update --all # Update everything
|
|
31
|
+
npx ds verify # Check local drift vs lock
|
|
32
|
+
npx ds info dashbox # Component details
|
|
33
|
+
npx ds whoami # Validate token
|
|
34
|
+
npx ds diff dashbox # Diff local vs remote
|
|
35
|
+
npx ds diff --all # Diff all
|
|
36
|
+
npx ds sync # Sync (interactive)
|
|
37
|
+
npx ds sync --all --yes # CI mode
|
|
38
|
+
npx ds sync-tokens # Force refetch CSS tokens
|
|
39
39
|
```
|
|
40
40
|
|
|
41
|
-
###
|
|
42
|
-
|
|
43
|
-
| Flag |
|
|
44
|
-
| ----------------------------- |
|
|
45
|
-
| `--registry <url>` | URL
|
|
46
|
-
| `--token <token>` |
|
|
47
|
-
| `--cwd <path>` |
|
|
48
|
-
| `--lock <path>` |
|
|
49
|
-
| `--pm <npm\|pnpm\|yarn\|bun>` |
|
|
50
|
-
| `--no-install` |
|
|
51
|
-
| `-y, --yes` |
|
|
52
|
-
| `--silent` |
|
|
53
|
-
| `--verbose` |
|
|
54
|
-
| `--json` |
|
|
41
|
+
### Global flags
|
|
42
|
+
|
|
43
|
+
| Flag | Description |
|
|
44
|
+
| ----------------------------- | ----------------------------- |
|
|
45
|
+
| `--registry <url>` | Registry URL |
|
|
46
|
+
| `--token <token>` | Auth token |
|
|
47
|
+
| `--cwd <path>` | Project directory |
|
|
48
|
+
| `--lock <path>` | Lockfile path |
|
|
49
|
+
| `--pm <npm\|pnpm\|yarn\|bun>` | Force package manager |
|
|
50
|
+
| `--no-install` | Skip npm install |
|
|
51
|
+
| `-y, --yes` | Skip confirmations |
|
|
52
|
+
| `--silent` | Errors only |
|
|
53
|
+
| `--verbose` | Detailed log |
|
|
54
|
+
| `--json` | JSON output (machine-readable)|
|
|
55
55
|
|
|
56
56
|
## JSON output
|
|
57
57
|
|
|
58
58
|
```bash
|
|
59
|
-
npx
|
|
59
|
+
npx ds add dashbox --json
|
|
60
60
|
# {"command":"add","success":true,"components":["dashbox"],...}
|
|
61
61
|
|
|
62
|
-
npx
|
|
62
|
+
npx ds verify --json
|
|
63
63
|
# {"command":"verify","ok":true,"drifted":[]}
|
|
64
64
|
|
|
65
|
-
npx
|
|
65
|
+
npx ds whoami --json
|
|
66
66
|
# {"command":"whoami","authenticated":true,"registry":"LEMA-UFPB Design System",...}
|
|
67
67
|
```
|
|
68
68
|
|
|
69
69
|
## Exit codes
|
|
70
70
|
|
|
71
|
-
| Code |
|
|
71
|
+
| Code | Meaning |
|
|
72
72
|
| ---- | ----------------------------- |
|
|
73
|
-
| 0 |
|
|
74
|
-
| 1 |
|
|
75
|
-
| 2 | Auth (token
|
|
73
|
+
| 0 | Success |
|
|
74
|
+
| 1 | Generic error |
|
|
75
|
+
| 2 | Auth (invalid/missing token) |
|
|
76
76
|
| 3 | Config (`components.json`) |
|
|
77
|
-
| 4 | Drift
|
|
77
|
+
| 4 | Drift detected |
|
|
78
78
|
| 5 | Registry/network |
|
|
79
79
|
|
|
80
80
|
## Lockfile
|
|
81
81
|
|
|
82
|
-
`
|
|
82
|
+
`ds.lock` is generated automatically and **must be committed** — it is the source of truth for reproducibility and drift detection.
|
|
83
83
|
|
|
84
|
-
##
|
|
84
|
+
## Development
|
|
85
85
|
|
|
86
86
|
```bash
|
|
87
|
-
make install #
|
|
88
|
-
make dev #
|
|
89
|
-
make build #
|
|
90
|
-
make test #
|
|
91
|
-
make lint #
|
|
92
|
-
make format #
|
|
93
|
-
make typecheck #
|
|
94
|
-
make pack #
|
|
95
|
-
make clean #
|
|
96
|
-
make fresh #
|
|
97
|
-
make help #
|
|
87
|
+
make install # Install deps
|
|
88
|
+
make dev # Watch mode
|
|
89
|
+
make build # Production build
|
|
90
|
+
make test # Run tests
|
|
91
|
+
make lint # ESLint
|
|
92
|
+
make format # Prettier
|
|
93
|
+
make typecheck # TypeScript
|
|
94
|
+
make pack # Generate tarball for local install
|
|
95
|
+
make clean # Clean artifacts
|
|
96
|
+
make fresh # Clean + install + build
|
|
97
|
+
make help # List all targets
|
|
98
98
|
```
|
|
99
99
|
|
|
100
|
-
##
|
|
100
|
+
## Architecture
|
|
101
101
|
|
|
102
102
|
```
|
|
103
103
|
src/
|
|
@@ -107,29 +107,29 @@ src/
|
|
|
107
107
|
└── lib/ # errors, ui
|
|
108
108
|
```
|
|
109
109
|
|
|
110
|
-
|
|
110
|
+
Dependencies: `commander`, `picocolors`, `@clack/prompts`. Bundle < 35KB.
|
|
111
111
|
|
|
112
112
|
## Release & Deploy
|
|
113
113
|
|
|
114
|
-
|
|
114
|
+
The project uses a **GitFlow** workflow with automatic versioning via [release-please](https://github.com/googleapis/release-please) and continuous deployment to GitHub Packages.
|
|
115
115
|
|
|
116
116
|
### Branches
|
|
117
117
|
|
|
118
|
-
| Branch |
|
|
119
|
-
| :-------- |
|
|
120
|
-
| `develop` |
|
|
121
|
-
| `main` |
|
|
118
|
+
| Branch | Purpose |
|
|
119
|
+
| :-------- | :------------------------------------------------------------------- |
|
|
120
|
+
| `develop` | Integration branch — every feature/fix PR goes here |
|
|
121
|
+
| `main` | Release branch — receives merge from `develop` when ready to ship |
|
|
122
122
|
|
|
123
|
-
###
|
|
123
|
+
### Full workflow (commit to deploy)
|
|
124
124
|
|
|
125
125
|
```text
|
|
126
126
|
feature/* ──PR──▶ develop ──PR──▶ main ──┐
|
|
127
|
-
│ (release-please
|
|
127
|
+
│ (release-please watches)
|
|
128
128
|
▼
|
|
129
|
-
chore(release): vX.Y.Z (PR
|
|
129
|
+
chore(release): vX.Y.Z (PR opened by bot)
|
|
130
130
|
│
|
|
131
131
|
▼ merge
|
|
132
|
-
tag vX.Y.Z + GitHub Release
|
|
132
|
+
tag vX.Y.Z + GitHub Release created
|
|
133
133
|
│
|
|
134
134
|
▼ (release.published)
|
|
135
135
|
CD: npm build → npm publish (GitHub Packages)
|
|
@@ -137,58 +137,58 @@ feature/* ──PR──▶ develop ──PR──▶ main ──┐
|
|
|
137
137
|
|
|
138
138
|
### CI (`.github/workflows/ci.yml`)
|
|
139
139
|
|
|
140
|
-
|
|
140
|
+
Triggers **only on PRs against `develop`** — the only stage where new code is introduced. PRs `develop → main` and release-please PRs **do not run CI**. **Sequential** pipeline with fail-fast (3 chained jobs) on a self-hosted runner:
|
|
141
141
|
|
|
142
142
|
`lint → test → build`
|
|
143
143
|
|
|
144
|
-
1.
|
|
145
|
-
2.
|
|
146
|
-
3.
|
|
144
|
+
1. **Lint**: `npm run format:check`, `npm run lint` and `npm run typecheck`
|
|
145
|
+
2. **Test**: `npm test` using Vitest
|
|
146
|
+
3. **Build**: `npm run build` (tsup) and strict bundle size check (< 200KB)
|
|
147
147
|
|
|
148
|
-
>
|
|
148
|
+
> **Branch protection is mandatory** on `develop` and `main`. CI only attests quality if direct pushes are blocked.
|
|
149
149
|
|
|
150
|
-
### Release
|
|
150
|
+
### Automated Release (`.github/workflows/release-please.yml`)
|
|
151
151
|
|
|
152
|
-
|
|
153
|
-
1.
|
|
154
|
-
2.
|
|
155
|
-
3.
|
|
152
|
+
Triggers on **push to `main`**. The release-please bot:
|
|
153
|
+
1. Reads commits since the last tag and calculates the next version (Conventional Commits)
|
|
154
|
+
2. Opens/updates a `chore(release): vX.Y.Z` PR containing updates to `package.json`, `.release-please-manifest.json` and `CHANGELOG.md`
|
|
155
|
+
3. When the PR is merged → creates the `vX.Y.Z` tag + GitHub Release automatically
|
|
156
156
|
|
|
157
157
|
### CD (`.github/workflows/cd.yml`)
|
|
158
158
|
|
|
159
|
-
|
|
160
|
-
|
|
159
|
+
Triggers on **`release: published`**.
|
|
160
|
+
The workflow checks out the release tag, builds the CLI (`npm run build`), and publishes to **GitHub Packages** (`npm publish`) under the `@lema-ufpb/ds-sync` scope.
|
|
161
161
|
|
|
162
|
-
>
|
|
162
|
+
> **Quality guarantee**: the tag is only born from a release-please PR merged into `main`. CI has already validated all code in `develop`. CD trusts this upstream validation.
|
|
163
163
|
|
|
164
|
-
### Recovery
|
|
164
|
+
### Recovery when CD fails
|
|
165
165
|
|
|
166
|
-
|
|
166
|
+
Default path (90% of cases): **roll-forward** (new fix in develop → merge to main → new tag and release).
|
|
167
167
|
|
|
168
|
-
>
|
|
168
|
+
> **Note**: `npm publish` is more permanent than Docker images. Published packages cannot be easily deleted after 72h, requiring `npm deprecate`.
|
|
169
169
|
|
|
170
|
-
|
|
170
|
+
For complex scenarios (tag created but publish failed, package published with critical bug, release-please calculating wrong version, release-please CI blocked), refer to the **[`.github/RELEASE_RUNBOOK.md`](.github/RELEASE_RUNBOOK.md)**. The runbook details all strategies and exact commands for each scenario.
|
|
171
171
|
|
|
172
|
-
##
|
|
172
|
+
## Contributing
|
|
173
173
|
|
|
174
|
-
### Conventional Commits (
|
|
174
|
+
### Conventional Commits (required)
|
|
175
175
|
|
|
176
|
-
|
|
176
|
+
For release-please to correctly calculate the next version and generate `CHANGELOG.md`, **all commits must follow the [Conventional Commits](https://www.conventionalcommits.org) standard**:
|
|
177
177
|
|
|
178
|
-
|
|
|
178
|
+
| Prefix | Bump (pre-1.0) | Appears in CHANGELOG |
|
|
179
179
|
| :--------------------------------------- | :------------------------------ | :------------------- |
|
|
180
|
-
| `feat:` | minor (`0.X.0`) |
|
|
181
|
-
| `fix:` | patch (`0.0.X`) |
|
|
182
|
-
| `perf:` | patch |
|
|
183
|
-
| `refactor:` | patch |
|
|
184
|
-
| `docs:` | patch |
|
|
185
|
-
| `revert:` | patch |
|
|
186
|
-
| `feat!:` / `BREAKING CHANGE:` | minor (pre-1.0
|
|
187
|
-
| `chore:` `style:` `test:` `build:` `ci:` | — (
|
|
180
|
+
| `feat:` | minor (`0.X.0`) | Features |
|
|
181
|
+
| `fix:` | patch (`0.0.X`) | Bug Fixes |
|
|
182
|
+
| `perf:` | patch | Performance |
|
|
183
|
+
| `refactor:` | patch | Refactor |
|
|
184
|
+
| `docs:` | patch | Documentation |
|
|
185
|
+
| `revert:` | patch | Reverts |
|
|
186
|
+
| `feat!:` / `BREAKING CHANGE:` | minor (pre-1.0 doesn't jump to 1.0) | Breaking |
|
|
187
|
+
| `chore:` `style:` `test:` `build:` `ci:` | — (no bump) | hidden |
|
|
188
188
|
|
|
189
189
|
### Pull Request
|
|
190
190
|
|
|
191
|
-
1.
|
|
192
|
-
2. Push
|
|
193
|
-
3.
|
|
194
|
-
4.
|
|
191
|
+
1. Create a branch from `develop`: `git checkout -b feature/my-feature`
|
|
192
|
+
2. Push and open a PR against `develop` — CI will trigger automatically
|
|
193
|
+
3. After merge into `develop`, promote to `main` by opening another PR
|
|
194
|
+
4. release-please bot will manage the release from `main`
|
package/dist/cli.js
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
var
|
|
3
|
-
`)){let r=
|
|
4
|
-
`,"utf-8")}function
|
|
5
|
-
`);return
|
|
2
|
+
var oe=Object.defineProperty;var xt=(t,n)=>()=>(t&&(n=t(t=0)),n);var Lt=(t,n)=>{for(var e in n)oe(t,e,{get:n[e],enumerable:!0})};var h,tt,A,B,yt,pt,u,$=xt(()=>{"use strict";h=class extends Error{constructor(e,o,i){super(o);this.code=e;this.hint=i;this.name="LemaError"}code;hint},tt=class extends h{constructor(n,e,o){super(n,e,o),this.name="AuthError"}},A=class extends h{constructor(n,e,o){super(n,e,o),this.name="ConfigError"}},B=class extends h{constructor(n,e,o){super(n,e,o),this.name="RegistryError"}},yt=class extends h{constructor(n,e,o){super(n,e,o),this.name="WriteError"}},pt=class extends h{constructor(n,e,o){super(n,e,o),this.name="ResolveError"}},u={SUCCESS:0,ERROR:1,AUTH:2,CONFIG:3,DRIFT:4,REGISTRY:5}});var Pt={};Lt(Pt,{loadConfig:()=>j,loadEnv:()=>I,parseEnvLine:()=>Ft,resolveTargetPath:()=>ft});import{readFileSync as se,existsSync as ie}from"fs";import{readFile as re}from"fs/promises";import{resolve as wt}from"path";function Ft(t){let n=t.trim();if(!n||n.startsWith("#"))return null;let e=n.indexOf("=");if(e===-1)return null;let o=n.slice(0,e).trim(),i=n.slice(e+1).trim();return(i.startsWith('"')&&i.endsWith('"')||i.startsWith("'")&&i.endsWith("'"))&&(i=i.slice(1,-1)),!o||!i?null:[o,i]}function I(t){let n=process.env.LEMA_DS_TOKEN??"",e=process.env.LEMA_DS_REGISTRY??ae,o=[".env.local",".env"].map(i=>wt(t,i));for(let i of o){if(!ie(i))continue;let s=se(i,"utf-8");for(let a of s.split(`
|
|
3
|
+
`)){let r=Ft(a);if(!r)continue;let[l,p]=r;l==="LEMA_DS_TOKEN"&&!n&&(n=p),l==="LEMA_DS_REGISTRY"&&!e&&(e=p)}}return{token:n,registry:e}}function kt(t,n){return t?t.replace(/^\.\//,"").replace(/^@\//,""):n}async function j(t){let n=wt(t,"components.json"),e;try{let s=await re(n,"utf-8");e=JSON.parse(s)}catch{throw new A("E_CONFIG_NO_COMPONENTS_JSON",`components.json not found or invalid at ${n}`,"Run npx shadcn@latest init to generate components.json in your project.")}let o={ui:kt(e.aliases?.ui,"components/ui"),components:kt(e.aliases?.components,"components"),lib:kt(e.aliases?.lib,"lib"),hooks:kt(e.aliases?.hooks,"hooks")},i=e.tailwind?.css?wt(t,e.tailwind.css):null;return{componentsJson:e,aliases:o,tailwindCssPath:i,cwd:t}}function ft(t,n,e){if(e.startsWith("/"))throw new A("E_CONFIG_INVALID_TARGET",`Absolute target path not allowed: ${e}`,"Use relative paths starting with components/, lib/ or hooks/.");let o;if(e.startsWith("components/ui/")){let i=e.slice(14);o=`${t.ui}/${i}`}else if(e.startsWith("components/")){let i=e.slice(11);o=`${t.components}/${i}`}else if(e.startsWith("lib/")){let i=e.slice(4);o=`${t.lib}/${i}`}else if(e.startsWith("hooks/")){let i=e.slice(6);o=`${t.hooks}/${i}`}else o=e;return wt(n,o)}var ae,U=xt(()=>{"use strict";$();ae="https://ds.lema.ufpb.br"});var Vt={};Lt(Vt,{detectPackageManager:()=>Wt,getInstallArgs:()=>Gt,installPackages:()=>X});import{existsSync as gt}from"fs";import{resolve as dt}from"path";import{execSync as Ce}from"child_process";function Wt(t){if(gt(dt(t,"pnpm-lock.yaml")))return"pnpm";if(gt(dt(t,"yarn.lock")))return"yarn";if(gt(dt(t,"bun.lockb"))||gt(dt(t,"bun.lock")))return"bun";if(gt(dt(t,"package-lock.json")))return"npm";let n=process.env.npm_config_user_agent??"";return n.includes("pnpm")?"pnpm":n.includes("yarn")?"yarn":n.includes("bun")?"bun":"npm"}function Gt(t,n){switch(t){case"npm":return["install",...n,"--save-dev"];case"pnpm":return["add",...n,"--save-dev"];case"yarn":return["add",...n,"--dev"];case"bun":return["add",...n,"--dev"]}}async function X(t,n,e){let o=e??Wt(t),i=Gt(o,n);try{Ce(`${o} ${i.join(" ")}`,{cwd:t,stdio:"ignore",timeout:12e4})}catch{throw new h("E_PM_INSTALL",`Failed to install packages with ${o}`,`Run manually: ${o} ${i.join(" ")}`)}}var ut=xt(()=>{"use strict";$()});import{Command as ze}from"commander";import Ot from"picocolors";import*as Y from"@clack/prompts";var it="info",It=!1;function _t(t){it=t}function Nt(t){It=t}function C(){return It}function N(){return it==="silent"}function S(t){It&&console.log(JSON.stringify(t,null,2))}function c(t){it!=="silent"&&console.log(t)}function T(t){it!=="silent"&&console.error(Ot.yellow(`\u26A0 ${t}`))}function R(t){it!=="silent"&&console.error(Ot.red(`\u2716 ${t}`))}function O(t){it!=="silent"&&console.log(Ot.green(`\u2714 ${t}`))}function E(t,n){let e=Y.spinner();return e.start(t),n().finally(()=>e.stop(""))}function z(t){return Y.confirm({message:t})}function Dt(t,n){return Y.select({message:t,options:n})}function D(t){it!=="silent"&&Y.outro(t)}U();import{existsSync as Tt}from"fs";import{resolve as ce}from"path";import{execSync as le}from"child_process";$();async function et(t,n){let e=ce(t,"components.json");if(Tt(e))return;if(n){if(At(t),!Tt(e))throw new A("E_CONFIG_NO_COMPONENTS_JSON","components.json still not found after npx shadcn@latest init","Run npx shadcn@latest init manually in your project.");return}if(C()||N())throw new A("E_CONFIG_NO_COMPONENTS_JSON","components.json not found","Run npx shadcn@latest init first, then try again.");if(!await z("components.json not found. Run npx shadcn@latest init to create it?"))throw new A("E_CONFIG_NO_COMPONENTS_JSON","components.json is required to run this command","Run npx shadcn@latest init first, then try again.");At(t)}function At(t){le("npx shadcn@latest init --defaults",{cwd:t,stdio:"inherit",timeout:12e4})}var me={ui:"components/ui",components:"components",lib:"lib",hooks:"hooks"};function q(t,n){let e=[];for(let[i,s]of Object.entries(me)){let a=n[i];a!==s&&e.push({from:`@/${s}/`,to:`@/${a}/`})}if(e.length===0)return t;e.sort((i,s)=>s.from.length-i.from.length);let o=t;for(let{from:i,to:s}of e)o=o.replaceAll(i,s);return o}function Q(t,n){let e=new Map;for(let i of n)for(let s of i.files??[]){if(!s.path||!s.target||!s.path.startsWith("components/ds/"))continue;let a=`@/${s.path.replace(/\.tsx$/,"")}`,r=`@/${s.target.replace(/\.tsx$/,"")}`;a!==r&&e.set(a,r)}let o=t;for(let[i,s]of e)o=o.replaceAll(i,s);return o=o.replaceAll("@/components/custom/","@/components/ds/"),o}$();var jt=3,Ut=250,pe=3e4;async function St(t,n,e=1){let o=new AbortController,i=setTimeout(()=>o.abort(),pe);try{let s={"User-Agent":"@lema-ufpb/ds-sync/0.3.0"};n&&(s.Authorization=`Bearer ${n}`);let a=await fetch(t,{headers:s,signal:o.signal});if(a.status===401)throw new tt("E_AUTH_401",`Token rejected by registry at ${t}`,"Check LEMA_DS_TOKEN in your .env.local file. Test with: ds whoami");if(a.status===404)throw new B("E_REGISTRY_NOT_FOUND",`Resource not found: ${t}`,"Use ds list to see available components.");if(a.status>=500&&e<jt){let r=Ut*Math.pow(2,e-1);return await new Promise(l=>setTimeout(l,r)),St(t,n,e+1)}if(!a.ok)throw new B("E_REGISTRY_NETWORK",`Registry returned ${a.status} for ${t}`,"Check connectivity and proxy settings.");return a}catch(s){if(s instanceof tt||s instanceof B)throw s;if(e<jt){let a=Ut*Math.pow(2,e-1);return await new Promise(r=>setTimeout(r,a)),St(t,n,e+1)}throw new B("E_REGISTRY_NETWORK",`Network error accessing ${t}: ${s instanceof Error?s.message:String(s)}`,"Check connectivity, proxy, and registry availability.")}finally{clearTimeout(i)}}async function J(t,n){let e=`${t}/r/registry.json`,i=await(await St(e,n)).json();if(!i||typeof i!="object"||!("name"in i)||!("items"in i))throw new B("E_REGISTRY_INVALID",`Malformed registry manifest at ${e}`,"Report to the registry maintainer.");let s=i;return{name:String(s.name),version:String(s.version??"0.0.0"),homepage:s.homepage?String(s.homepage):void 0,items:s.items??[]}}async function F(t,n,e){let o=`${t}/r/${e}.json`,s=await(await St(o,n)).json();if(!s||typeof s!="object"||!("name"in s))throw new B("E_REGISTRY_INVALID",`Malformed registry item for "${e}" at ${o}`,"Report to the registry maintainer.");return s}$();async function Ct(t,n){let e=new Set,o=new Set,i=[],s=new Set;async function a(r,l){if(e.has(r))return;if(o.has(r)){let g=[...l,r].join(" \u2192 ");throw new pt("E_RESOLVE_CYCLE",`Cycle detected in registryDependencies: ${g}`,"Report to the registry maintainer.")}o.add(r);let p=[...l,r],f;try{f=await n(r)}catch(g){throw o.delete(r),g instanceof h?g:new pt("E_RESOLVE_UNKNOWN",`Item "${r}" not found in registry`,g instanceof Error?g.message:String(g))}if(f.dependencies)for(let g of f.dependencies)s.add(g);if(f.registryDependencies)for(let g of f.registryDependencies)await a(g,p);o.delete(r),e.add(r),i.push(f)}for(let r of t)await a(r,[]);return{items:i,allNpmDeps:s}}$();U();import{writeFile as fe,rename as ge,unlink as de}from"fs/promises";import{existsSync as yn}from"fs";import{dirname as ue}from"path";import{randomUUID as he}from"crypto";async function nt(t,n){let e=[],o=[];try{for(let i of n){let s=ft(t.aliases,t.cwd,i.target),a=ue(s),{mkdir:r}=await import("fs/promises");await r(a,{recursive:!0});let l=`${s}.lema-tmp-${he().slice(0,8)}`;await fe(l,i.content,"utf-8"),e.push({tmp:l,real:s}),o.push({target:i.target,resolvedPath:s})}for(let{tmp:i,real:s}of e)await ge(i,s);return o}catch(i){for(let{tmp:s}of e)try{await de(s)}catch{}throw new yt("E_WRITE_FILE",`Error writing files: ${i instanceof Error?i.message:String(i)}`,"Check write permissions in the project directory.")}}$();import{readFile as ye,writeFile as ke}from"fs/promises";import{existsSync as we}from"fs";import{resolve as Rt}from"path";function Jt(t){return{$schema:"https://ds.lema.ufpb.br/schemas/lock-v1.json",lockfileVersion:1,registry:{url:t,name:"",version:"0.0.0",fetchedAt:new Date().toISOString()},components:{},tokens:null}}async function _(t,n){let e=n?Rt(t,n):Rt(t,"ds.lock");if(!we(e))return null;try{let o=await ye(e,"utf-8"),i=JSON.parse(o);return i.lockfileVersion?i:null}catch{throw new A("E_LOCK_INVALID",`Corrupted lockfile at ${e}`,"Backup the file and run ds add --all to recreate it.")}}async function ot(t,n,e){let o=e?Rt(t,e):Rt(t,"ds.lock");await ke(o,JSON.stringify(n,null,2)+`
|
|
4
|
+
`,"utf-8")}function ct(t,n,e,o,i,s){t.components[e]={registryVersion:n,installedAt:new Date().toISOString(),files:o,dependencies:i,registryDependencies:s}}function lt(t,n,e,o){t.registry.url=n,t.registry.name=e,t.registry.version=o,t.registry.fetchedAt=new Date().toISOString()}import{createHash as Se}from"crypto";function W(t){let n=t.replace(/\r\n/g,`
|
|
5
|
+
`);return Se("sha256").update(n,"utf-8").digest("hex")}async function Et(t){let e=await(await import("fs/promises")).readFile(t,"utf-8");return W(e)}ut();$();import{readFile as Re,writeFile as Ee}from"fs/promises";var Mt=/\/\*\s*lema-ds:tokens:start[^*]*\*\/[\s\S]*?\/\*\s*lema-ds:tokens:end\s*\*\//;function ve(t,n,e){let o=`/* lema-ds:tokens:start v${e} */
|
|
6
6
|
/* AUTO-GENERATED by @lema-ufpb/ds-sync. Do not edit manually. */
|
|
7
7
|
${n.trim()}
|
|
8
|
-
/* lema-ds:tokens:end */`;return
|
|
8
|
+
/* lema-ds:tokens:end */`;return Mt.test(t)?t.replace(Mt,o):t.trimEnd()+`
|
|
9
9
|
|
|
10
10
|
`+o+`
|
|
11
|
-
`}async function
|
|
12
|
-
Components to install:`);for(let
|
|
13
|
-
npm dependencies: ${f.join(", ")}`),!await K("Proceed?")){c("Operation cancelled.");return}}let L=k.items.flatMap(p=>(p.files??[]).filter(g=>g.content).map(g=>({target:g.target??g.path,content:z(g.content,l.aliases)}))),T=await(r?tt(l,L):E("Writing files...",()=>tt(l,L)));if(!r)for(let p of T)b(`Written: ${p.resolvedPath}`);let q=await O(e,a)??At(i);rt(q,i,d.name,d.version);for(let p of k.items){let g=(p.files??[]).map(w=>({target:w.target??w.path,sha256:j(w.content?z(w.content,l.aliases):"")}));it(q,d.version,p.name,g,p.dependencies,p.registryDependencies)}await et(e,q,a),!n.noInstall&&f.length>0&&(r?await B(e,f):await E(`Installing dependencies (${f.length} packages)...`,async()=>{let{detectPackageManager:p}=await Promise.resolve().then(()=>(ft(),Ut)),g=n.pm??p(e);await B(e,f,g)}));let Q=!1;if(!k.items.some(p=>p.type==="registry:style")){let p=await _(i,s,"tokens").catch(()=>null),g=l.tailwindCssPath,w=p?.files?.[0]?.content;g&&w&&(r?await G(g,w,d.version):(await E("Patching CSS tokens...",()=>G(g,w,d.version)),b("CSS tokens updated.")),Q=!0)}if(r){S({command:"add",success:!0,components:k.items.map(p=>p.name),files:T.map(p=>({target:p.target,path:p.resolvedPath})),npmDependencies:f,registryVersion:d.version,tokensUpdated:Q});return}I(`Added ${k.items.length} component(s).`)}P();v();function Wt(t){t.command("list").description("List available components in the registry").option("--installed","Show only installed components").option("--registry <url>","Registry URL").option("--token <token>","Auth token").option("--cwd <path>","Project directory").option("--lock <path>","Lockfile path").option("--verbose","Verbose output").option("--silent","Errors only").option("--json","JSON output").action(async n=>{try{await Ee(n),process.exit(h.SUCCESS)}catch(e){C()&&S({command:"list",success:!1,error:e instanceof y?{code:e.code,message:e.message,hint:e.hint}:String(e)}),e instanceof y&&(N(`[${e.code}] ${e.message}`),process.exit(h.REGISTRY)),N(String(e)),process.exit(h.ERROR)}})}async function Ee(t){let n=t.cwd??process.cwd(),e=$(n),o=t.token??e.token,s=t.registry??e.registry,i=t.lock;x()||console.log();let a=await E("Fetching registry...",()=>A(s,o));if(C()){if(t.installed){let l=await O(n,i);S({command:"list",mode:"installed",components:l?.components??{}})}else S({command:"list",mode:"available",...a});return}let r=a.version&&a.version!=="0.0.0"?` ${a.version}`:"";if(c(`lema-ds v1.0.0 \u2014 Registry: ${a.name}${r}`),a.homepage&&c(`Homepage: ${a.homepage}`),c(""),t.installed){let l=await O(n,i);if(!l||Object.keys(l.components).length===0){N("No components installed.");return}c("Installed components:");for(let[d,u]of Object.entries(l.components)){let m=u.files.map(k=>k.target).join(", ");c(` \u2022 ${d}`),c(` Version: ${u.registryVersion}`),c(` Files: ${m}`)}}else{c(`Available components (${a.items.length}):`);for(let l of a.items)c(` \u2022 ${l.name}`)}I(`${t.installed?"Installed":"Available"}: ${t.installed?Object.keys((await O(n,i))?.components??{}).length:a.items.length}`)}P();ft();v();function Vt(t){t.command("update").description("Update installed components").argument("[components...]","Component name(s)").option("--all","Update all components").option("--force","Force update even if same version").option("-y, --yes","Skip confirmation prompts").option("--no-install","Skip npm dependency installation").option("--registry <url>","Registry URL").option("--token <token>","Auth token").option("--cwd <path>","Project directory").option("--lock <path>","Lockfile path").option("--pm <name>","Package manager").option("--verbose","Verbose output").option("--silent","Errors only").option("--json","JSON output").action(async(n,e)=>{try{await ve(n,e),process.exit(h.SUCCESS)}catch(o){C()&&S({command:"update",success:!1,error:o instanceof y?{code:o.code,message:o.message,hint:o.hint}:String(o)}),o instanceof y&&(R(`[${o.code}] ${o.message}`),o.hint&&c(` \u2192 ${o.hint}`),process.exit(h.ERROR)),R(String(o)),process.exit(h.ERROR)}})}async function ve(t,n){let e=n.cwd??process.cwd(),o=$(e),s=n.token??o.token,i=n.registry??o.registry,a=n.lock,r=C();!x()&&!r&&console.log(),await Z(e,n.yes);let l=await O(e,a);if(!l||Object.keys(l.components).length===0){if(r){S({command:"update",success:!1,error:"no_components_installed"});return}N("No components installed. Run lema-ds add first.");return}let d=await F(e),u=await(r?A(i,s):E("Fetching registry...",()=>A(i,s)));if(u.version===l.registry.version&&!n.force){if(r){S({command:"update",success:!0,components:[],files:[],npmDependencies:[],registryVersion:u.version,tokensUpdated:!1,message:"already_up_to_date"});return}b("Registry is already up to date (no changes).");return}let m;if(n.all)m=Object.keys(l.components);else if(t.length>0){let p=t.filter(g=>!l.components[g]);if(p.length>0)throw new y("E_RESOLVE_UNKNOWN",`Component(s) not installed: ${p.join(", ")}`,"Use lema-ds list --installed to see installed components.");m=t}else m=Object.keys(l.components);let k=await kt(m,async p=>_(i,s,p));if(!n.yes&&!r&&!await K(`Update ${k.items.length} component(s) to version ${u.version}?`)){c("Operation cancelled.");return}let f=k.items.flatMap(p=>(p.files??[]).filter(g=>g.content).map(g=>({target:g.target??g.path,content:z(g.content,d.aliases)}))),L=await(r?tt(d,f):E("Updating files...",()=>tt(d,f)));rt(l,i,u.name,u.version);for(let p of k.items){let g=(p.files??[]).map(w=>({target:w.target??w.path,sha256:j(w.content?z(w.content,d.aliases):"")}));it(l,u.version,p.name,g,p.dependencies,p.registryDependencies)}await et(e,l,a),r||b(`Updated ${L.length} file(s).`);let T=[...k.allNpmDeps];!n.noInstall&&T.length>0&&(r?await B(e,T):await E("Installing dependencies...",()=>B(e,T)));let st=!1,q=await _(i,s,"tokens").catch(()=>null),Q=d.tailwindCssPath,nt=q?.files?.[0]?.content;if(Q&&nt&&(r?await G(Q,nt,u.version):await E("Patching CSS tokens...",()=>G(Q,nt,u.version)),st=!0),r){S({command:"update",success:!0,components:k.items.map(p=>p.name),files:L.map(p=>({target:p.target,path:p.resolvedPath})),npmDependencies:T,registryVersion:u.version,tokensUpdated:st});return}I(`Updated ${k.items.length} component(s).`)}P();v();import be from"picocolors";function Mt(t){t.command("verify").description("Verify installed component integrity (local vs lock drift check)").option("--cwd <path>","Project directory").option("--lock <path>","Lockfile path").option("--verbose","Verbose output").option("--silent","Errors only").option("--json","JSON output").action(async n=>{try{let e=await $e(n);process.exit(e?h.SUCCESS:h.DRIFT)}catch(e){e instanceof y&&(R(`[${e.code}] ${e.message}`),process.exit(h.ERROR)),R(String(e)),process.exit(h.ERROR)}})}async function $e(t){let n=t.cwd??process.cwd(),e=t.lock;x()||console.log();let o=await O(n,e);if(!o)return N("No lockfile found. Run lema-ds add first."),!0;let s=await F(n),i=[];for(let[a,r]of Object.entries(o.components))for(let l of r.files){let d=(await Promise.resolve().then(()=>(P(),Lt))).resolveTargetPath(s.aliases,n,l.target),u=await St(d).catch(()=>null);u?u!==l.sha256&&i.push({name:a,target:l.target,expected:l.sha256,actual:u}):i.push({name:a,target:l.target,expected:l.sha256,actual:"FILE_MISSING"})}if(C())return S({command:"verify",ok:i.length===0,drifted:i}),i.length===0;if(i.length===0)return b("All components are intact. No drift detected."),!0;R(`Drift detected in ${i.length} file(s):`);for(let a of i)c(` ${be.red("!")} ${a.name}: ${a.target}`),c(` Expected: ${a.expected.slice(0,12)}...`),c(` Actual: ${a.actual==="FILE_MISSING"?"FILE MISSING":`${a.actual.slice(0,12)}...`}`);return c(""),N("Run lema-ds diff to see detailed changes."),!1}P();v();import at from"picocolors";function Ht(t){t.command("info").description("Show detailed information about a component").argument("<component>","Component name").option("--registry <url>","Registry URL").option("--token <token>","Auth token").option("--cwd <path>","Project directory").option("--verbose","Verbose output").option("--silent","Errors only").option("--json","JSON output").action(async(n,e)=>{try{await Oe(n,e),process.exit(h.SUCCESS)}catch(o){C()&&S({command:"info",success:!1,error:o instanceof y?{code:o.code,message:o.message,hint:o.hint}:String(o)}),o instanceof y&&(R(`[${o.code}] ${o.message}`),o.hint&&c(` \u2192 ${o.hint}`),process.exit(h.REGISTRY)),R(String(o)),process.exit(h.ERROR)}})}async function Oe(t,n){let e=n.cwd??process.cwd(),o=$(e),s=n.token??o.token,i=n.registry??o.registry,a=await E(`Fetching ${t}...`,()=>_(i,s,t));if(C()){S({command:"info",...a});return}if(c(""),c(`${at.bold(a.name)}${a.title?` \u2014 ${a.title}`:""}`),a.description&&c(` ${at.dim(a.description)}`),c(""),c(`${at.dim("Type:")} ${a.type}`),c(""),a.dependencies&&a.dependencies.length>0){c(`${at.dim("npm dependencies:")}`);for(let r of a.dependencies)c(` \u2022 ${r}`);c("")}if(a.registryDependencies&&a.registryDependencies.length>0){c(`${at.dim("Registry dependencies:")}`);for(let r of a.registryDependencies)c(` \u2022 ${r}`);c("")}c(`${at.dim("Files:")}`);for(let r of a.files??[])c(` \u2022 ${r.path} (${r.type})`);I(`info: ${a.name}`)}P();v();import Kt from"picocolors";function Yt(t){t.command("whoami").description("Validate auth token against the registry").option("--registry <url>","Registry URL").option("--token <token>","Auth token").option("--cwd <path>","Project directory").option("--verbose","Verbose output").option("--silent","Errors only").option("--json","JSON output").action(async n=>{try{await xe(n),process.exit(h.SUCCESS)}catch(e){C()&&S({command:"whoami",authenticated:!1,error:e instanceof y?{code:e.code,message:e.message,hint:e.hint}:String(e)}),e instanceof X&&(R(`[${e.code}] ${e.message}`),e.hint&&c(` \u2192 ${e.hint}`),process.exit(h.AUTH)),e instanceof y&&(R(`[${e.code}] ${e.message}`),process.exit(h.ERROR)),R(String(e)),process.exit(h.ERROR)}})}async function xe(t){let n=t.cwd??process.cwd(),e=$(n),o=t.token??e.token,s=t.registry??e.registry;if(!o)throw new X("E_AUTH_MISSING","Auth token not found","Set LEMA_DS_TOKEN in your .env.local file.");let i=await E("Validating token...",()=>A(s,o));if(C()){S({command:"whoami",authenticated:!0,registry:i.name,version:i.version});return}c(""),c(`${Kt.green("\u2714")} Token is valid!`),c(` Registry: ${i.name} ${i.version}`),c(` URL: ${s}`);let a=o.length>8?`${o.slice(0,4)}${"\u2022".repeat(o.length-8)}${o.slice(-4)}`:"\u2022\u2022\u2022\u2022\u2022\u2022\u2022\u2022";c(` Token: ${Kt.dim(a)}`),I("Authenticated")}P();import J from"picocolors";import{execSync as Ie}from"child_process";import{existsSync as _e,writeFileSync as Le,unlinkSync as Ne}from"fs";import{readFile as De}from"fs/promises";import{tmpdir as Fe}from"os";import{randomUUID as Pe}from"crypto";import{resolve as Ae}from"path";P();async function Ct(t,n,e,o){let s=[];for(let i of e.files){let a=lt(t.aliases,t.cwd,i.target),r=_e(a)?await St(a).catch(()=>null):null,d=o?.files?.find(f=>(f.target??f.path)===i.target)?.content??null,u=d?j(d):null,m;r?u===null?m=r===i.sha256?"up-to-date":"drift-only":r===i.sha256&&u===i.sha256?m="up-to-date":r===i.sha256&&u!==i.sha256?m="clean-update":r!==i.sha256&&u===i.sha256?m="drift-only":m="conflict":m="missing";let k=null;if(m==="conflict"||m==="drift-only")try{k=await De(a,"utf-8")}catch{k=null}s.push({target:i.target,resolvedPath:a,status:m,localHash:r,lockHash:i.sha256,remoteHash:u,localContent:k,remoteContent:d})}return{name:e.registryVersion,files:s}}function Rt(t){let n={components:t,upToDate:0,cleanUpdates:0,drifts:0,conflicts:0,missing:0};for(let e of t)for(let o of e.files)o.status==="up-to-date"?n.upToDate++:o.status==="clean-update"?n.cleanUpdates++:o.status==="drift-only"?n.drifts++:o.status==="conflict"?n.conflicts++:o.status==="missing"&&n.missing++;return n}function zt(t,n,e){let o=Ae(Fe(),`lema-ds-${e}-${Pe().slice(0,8)}`);Le(o,n,"utf-8");try{return Ie(`git diff --no-index -- "${t}" "${o}"`,{encoding:"utf-8",stdio:["ignore","pipe","pipe"],timeout:15e3})}catch(s){return s.stdout?s.stdout:s.stderr?s.stderr:`[diff failed: ${s.message}]`}finally{try{Ne(o)}catch{}}}function gt(t,n){return zt(t,n,"remote")}function Bt(t,n,e){return zt(t,n,e)}v();function qt(t){t.command("diff").description("Show differences between local files and the registry").argument("[components...]","Component name(s)").option("--all","Show diff for all installed components").option("--registry <url>","Registry URL").option("--token <token>","Auth token").option("--cwd <path>","Project directory").option("--lock <path>","Lockfile path").option("--verbose","Verbose output").option("--silent","Errors only").option("--json","JSON output").action(async(n,e)=>{try{await Te(n,e),process.exit(h.SUCCESS)}catch(o){o instanceof y&&(R(`[${o.code}] ${o.message}`),o.hint&&c(` \u2192 ${o.hint}`),process.exit(h.ERROR)),R(String(o)),process.exit(h.ERROR)}})}async function Te(t,n){let e=n.cwd??process.cwd(),o=$(e),s=n.token??o.token,i=n.registry??o.registry,a=n.lock;x()||console.log();let r=await O(e,a);if(!r||Object.keys(r.components).length===0){N("No components installed. Run lema-ds add first.");return}let l=await F(e),d;if(n.all)d=Object.keys(r.components);else if(t.length>0){let k=t.filter(f=>!r.components[f]);if(k.length>0)throw new y("E_RESOLVE_UNKNOWN",`Component(s) not installed: ${k.join(", ")}`,"Use lema-ds list --installed to see installed components.");d=t}else d=Object.keys(r.components);let u=[];for(let k of d){let f=r.components[k],L=await _(i,s,k).catch(()=>null),T=await Ct(l,r,f,L);u.push({...T,name:k})}let m=Rt(u);if(C()){S({summary:m,components:u});return}if(m.upToDate===m.upToDate+m.cleanUpdates+m.drifts+m.conflicts+m.missing){b("All components are up to date. No differences found.");return}for(let k of u)for(let f of k.files)f.status!=="up-to-date"&&(c(""),c(J.bold(`\u{1F4C4} ${f.target}`)),c(` Status: ${je(f.status)}`),f.status==="drift-only"&&f.localContent&&(c(" Local changes (not reflected in lock):"),c(Bt(f.resolvedPath,f.localContent,"local"))),f.status==="conflict"&&f.remoteContent&&(c(" Conflict between local and remote versions:"),c(gt(f.resolvedPath,f.remoteContent))),f.status==="clean-update"&&f.remoteContent&&(c(" Remote version available (safe to apply):"),c(gt(f.resolvedPath,f.remoteContent))),f.status==="missing"&&c(` Expected file not found at: ${f.resolvedPath}`));c(""),c(Ue(m)),I("diff complete")}function je(t){return{"up-to-date":J.green("\u2713 up to date"),"clean-update":J.blue("\u21BB safe update"),"drift-only":J.yellow("\u26A1 locally edited"),conflict:J.red("\u2717 conflict"),missing:J.red("\u2717 file missing")}[t]??t}function Ue(t){let n=[];return t.upToDate>0&&n.push(J.green(`${t.upToDate} up to date`)),t.cleanUpdates>0&&n.push(J.blue(`${t.cleanUpdates} safe update(s)`)),t.drifts>0&&n.push(J.yellow(`${t.drifts} drift(s)`)),t.conflicts>0&&n.push(J.red(`${t.conflicts} conflict(s)`)),t.missing>0&&n.push(J.red(`${t.missing} missing`)),n.join(" | ")}P();import W from"picocolors";ft();v();function Qt(t){t.command("sync").description("Synchronize installed components with the registry (interactive)").argument("[components...]","Component name(s)").option("--all","Synchronize all components").option("-y, --yes","Auto-apply safe changes (no prompts)").option("--no-install","Skip npm dependency installation").option("--registry <url>","Registry URL").option("--token <token>","Auth token").option("--cwd <path>","Project directory").option("--lock <path>","Lockfile path").option("--pm <name>","Package manager").option("--verbose","Verbose output").option("--silent","Errors only").option("--json","JSON output").action(async(n,e)=>{try{await Je(n,e),process.exit(h.SUCCESS)}catch(o){o instanceof y&&(R(`[${o.code}] ${o.message}`),o.hint&&c(` \u2192 ${o.hint}`),process.exit(h.ERROR)),R(String(o)),process.exit(h.ERROR)}})}async function Je(t,n){let e=n.cwd??process.cwd(),o=$(e),s=n.token??o.token,i=n.registry??o.registry,a=n.lock,r=C();!x()&&!r&&console.log(),await Z(e,n.yes);let l=await O(e,a);if(!l||Object.keys(l.components).length===0){if(r){S({command:"sync",success:!1,message:"no_components_installed"});return}N("No components installed. Run lema-ds add first.");return}let d=await F(e),u=await(r?A(i,s):E("Fetching registry...",()=>A(i,s)));u.version===l.registry.version&&!r&&b("Registry is up to date. Checking for local drift...");let m;if(n.all)m=Object.keys(l.components);else if(t.length>0){let g=t.filter(w=>!l.components[w]);if(g.length>0)throw new y("E_RESOLVE_UNKNOWN",`Component(s) not installed: ${g.join(", ")}`,"Use lema-ds list --installed to see installed components.");m=t}else m=Object.keys(l.components);let k=await Ge(m,d,l,i,s),f=Rt(k);if(r){S({command:"sync",summary:f,components:k});return}if(f.upToDate===f.upToDate+f.cleanUpdates+f.drifts+f.conflicts+f.missing&&f.cleanUpdates+f.drifts+f.conflicts===0){b("Everything is in sync. No changes detected.");return}c(""),c(W.bold("Change summary:")),c(Ve(f)),c("");let L=[],T=[],st=new Set;for(let g of k)for(let w of g.files){if(w.status==="up-to-date")continue;let V;if(n.yes?V=w.status==="conflict"?"skip":"take":V=await We(g.name,w),V==="abort"){c("Operation aborted by user.");return}if(V==="skip"){c(` ${W.dim("\u2192 skipping")} ${w.target}`);continue}if(V==="keep"){c(` ${W.dim("\u2192 keeping local")} ${w.target}`);continue}V==="take"&&w.remoteContent&&(L.push({target:w.target,content:z(w.remoteContent,d.aliases)}),b(`${W.green("\u2192")} ${w.target}`))}if(L.length===0){c("No changes to apply.");return}if(!n.yes&&!await K(`Apply ${L.length} change(s)?`)){c("Operation cancelled.");return}await E("Applying changes...",()=>tt(d,L));for(let g of k){let w=await _(i,s,g.name).catch(()=>null);if(!w)continue;let V=(w.files??[]).filter(M=>L.some(Zt=>Zt.target===(M.target??M.path))).map(M=>({target:M.target??M.path,sha256:j(M.content?z(M.content,d.aliases):"")}));if(V.length>0&&(T.push({name:g.name,files:V,dependencies:w.dependencies,registryDependencies:w.registryDependencies}),w.dependencies))for(let M of w.dependencies)st.add(M)}rt(l,i,u.name,u.version);for(let g of T)it(l,u.version,g.name,g.files,g.dependencies,g.registryDependencies);await et(e,l,a);let q=[...st];!n.noInstall&&q.length>0&&await E("Installing dependencies...",()=>B(e,q));let Q=await _(i,s,"tokens").catch(()=>null),nt=d.tailwindCssPath,p=Q?.files?.[0]?.content;nt&&p&&await E("Patching CSS tokens...",()=>G(nt,p,u.version)),I(`${L.length} file(s) synchronized.`)}async function Ge(t,n,e,o,s){let i=[];for(let a of t){let r=e.components[a],l=await _(o,s,a).catch(()=>null),d=await Ct(n,e,r,l);i.push({...d,name:a})}return i}async function We(t,n){c(""),c(W.bold(`Conflict in ${t} \u2014 ${n.target}`));let e=[{label:"Keep local",value:"keep"},{label:"Overwrite with remote",value:"take"},{label:"Skip this file",value:"skip"},{label:"Abort everything",value:"abort"}];n.remoteContent&&await K("View diff before deciding?")&&(c(""),c(gt(n.resolvedPath,n.remoteContent)));let o=await It(`What to do with ${n.target}?`,e);return typeof o!="string"?"skip":o}function Ve(t){let n=[];return t.upToDate>0&&n.push(W.green(`${t.upToDate} up to date`)),t.cleanUpdates>0&&n.push(W.blue(`${t.cleanUpdates} safe update(s)`)),t.drifts>0&&n.push(W.yellow(`${t.drifts} drift(s)`)),t.conflicts>0&&n.push(W.red(`${t.conflicts} conflict(s)`)),t.missing>0&&n.push(W.red(`${t.missing} missing`)),n.join(" | ")}P();v();function Xt(t){t.command("sync-tokens").description("Force refetch and patch CSS tokens").option("--registry <url>","Registry URL").option("--token <token>","Auth token").option("--cwd <path>","Project directory").option("--lock <path>","Lockfile path").option("--verbose","Verbose output").option("--silent","Errors only").option("--json","JSON output").action(async n=>{try{await Me(n),process.exit(h.SUCCESS)}catch(e){C()&&S({command:"sync-tokens",success:!1,error:e instanceof y?{code:e.code,message:e.message,hint:e.hint}:String(e)}),e instanceof y&&(R(`[${e.code}] ${e.message}`),e.hint&&c(` \u2192 ${e.hint}`),process.exit(h.ERROR)),R(String(e)),process.exit(h.ERROR)}})}async function Me(t){let n=t.cwd??process.cwd(),e=$(n),o=t.token??e.token,s=t.registry??e.registry,i=t.lock,a=C();!x()&&!a&&console.log(),await Z(n);let r=await F(n);if(!r.tailwindCssPath)throw new y("E_CONFIG_NO_TAILWIND_CSS","tailwind.css not declared in components.json","Add tailwind.css to your components.json.");let d=(await E("Fetching tokens from registry...",()=>_(s,o,"tokens"))).files?.[0]?.content;if(!d)throw new y("E_REGISTRY_INVALID","Tokens item does not contain CSS content","Report to the registry maintainer.");let u=r.tailwindCssPath;await E("Patching globals.css...",()=>G(u,d,"0.0.0"));let m=await O(n,i);if(m&&(m.tokens={registryVersion:m.registry.version,installedAt:new Date().toISOString(),sha256:j(d)},await et(n,m,i)),a){S({command:"sync-tokens",success:!0,sha256:j(d),path:r.tailwindCssPath});return}b(`CSS tokens updated at ${r.tailwindCssPath}`),I("sync-tokens complete")}var U=new He;U.name("lema-ds").description("CLI to manage LEMA Design System components").version("1.0.0").hook("preAction",t=>{let n=t.optsWithGlobals();n.silent?$t("silent"):n.verbose&&$t("verbose"),n.json&&xt(!0)});U.option("--verbose","Verbose output").option("--silent","Errors only").option("--json","JSON output");Gt(U);Wt(U);Vt(U);Mt(U);Ht(U);Yt(U);qt(U);Qt(U);Xt(U);U.parse(process.argv);
|
|
11
|
+
`}async function M(t,n,e){let o;try{o=await Re(t,"utf-8")}catch{throw new A("E_CONFIG_NO_TAILWIND_CSS",`CSS file declared in tailwind.css not found: ${t}`,"Verify the path in components.json \u2192 tailwind.css is correct.")}let i=ve(o,n,e);await Ee(t,i,"utf-8")}$();function Ht(t){t.command("add").description("Install one or more components from the LEMA Design System").argument("[components...]","Component name(s) to install").option("--all","Install all registry components").option("-y, --yes","Skip confirmation prompts").option("--no-install","Skip npm dependency installation").option("--registry <url>","Registry URL").option("--token <token>","Auth token").option("--cwd <path>","Project directory").option("--lock <path>","Lockfile path").option("--pm <name>","Package manager").option("--verbose","Verbose output").option("--silent","Errors only").option("--json","JSON output").action(async(n,e)=>{try{await be(n,e),process.exit(u.SUCCESS)}catch(o){if(C()&&S({command:"add",success:!1,error:o instanceof h?{code:o.code,message:o.message,hint:o.hint}:String(o)}),o instanceof h){R(`[${o.code}] ${o.message}`),o.hint&&c(` \u2192 ${o.hint}`);let i={E_AUTH_MISSING:u.AUTH,E_AUTH_401:u.AUTH,E_CONFIG_NO_COMPONENTS_JSON:u.CONFIG,E_CONFIG_NO_ALIAS:u.CONFIG,E_CONFIG_NO_TAILWIND_CSS:u.CONFIG};process.exit(i[o.code]??u.ERROR)}R(String(o)),process.exit(u.ERROR)}})}async function be(t,n){let e=n.cwd??process.cwd(),o=I(e),i=n.token??o.token,s=n.registry??o.registry,a=n.lock,r=C();!N()&&!r&&console.log(),await et(e,n.yes);let l=await j(e),p=await(r?J(s,i):E("Fetching registry...",()=>J(s,i))),f=p.items.map(m=>m.name),g;if(n.all){let m=await _(e,a),w=new Set(Object.keys(m?.components??{}));if(g=f.filter(k=>!w.has(k)),g.length===0){if(r){S({command:"add",success:!0,components:[],files:[],npmDependencies:[],registryVersion:p.version,tokensUpdated:!1,message:"all_already_installed"});return}O("All components already installed.");return}}else{if(t.length===0)throw new h("E_USAGE","Specify one or more component names or use --all","Example: ds add dashbox bar-chart");{let m=t.filter(w=>!f.includes(w));if(m.length>0)throw new h("E_RESOLVE_UNKNOWN",`Component(s) not found: ${m.join(", ")}`,"Use ds list to see available components.");g=t}}r||c(`Resolving dependencies for ${g.length} component(s)...`);let d=await Ct(g,async m=>F(s,i,m)),y=[...d.allNpmDeps];if(!n.yes&&!r){c(`
|
|
12
|
+
Components to install:`);for(let w of d.items)c(` \u2022 ${w.name}${w.title?` (${w.title})`:""}`);if(y.length>0&&c(`
|
|
13
|
+
npm dependencies: ${y.join(", ")}`),!await z("Proceed?")){c("Operation cancelled.");return}}let v=d.items.flatMap(m=>(m.files??[]).filter(w=>!!w.content).map(w=>{let k=q(w.content,l.aliases);return k=Q(k,d.items),{target:w.target??w.path,content:k}})),L=await(r?nt(l,v):E("Writing files...",()=>nt(l,v)));if(!r)for(let m of L)O(`Written: ${m.resolvedPath}`);let Z=await _(e,a)??Jt(s);lt(Z,s,p.name,p.version);for(let m of d.items){let w=(m.files??[]).map(k=>{let b=k.content??"",x=q(b,l.aliases);return x=Q(x,d.items),{target:k.target??k.path,sha256:W(x)}});ct(Z,p.version,m.name,w,m.dependencies,m.registryDependencies)}await ot(e,Z,a),!n.noInstall&&y.length>0&&(r?await X(e,y):await E(`Installing dependencies (${y.length} packages)...`,async()=>{let{detectPackageManager:m}=await Promise.resolve().then(()=>(ut(),Vt)),w=n.pm??m(e);await X(e,y,w)}));let K=!1;if(!d.items.some(m=>m.type==="registry:style")){let m=await F(s,i,"tokens").catch(()=>null),w=l.tailwindCssPath,k=m?.files?.[0]?.content;w&&k&&(r?await M(w,k,p.version):(await E("Patching CSS tokens...",()=>M(w,k,p.version)),O("CSS tokens updated.")),K=!0)}if(r){S({command:"add",success:!0,components:d.items.map(m=>m.name),files:L.map(m=>({target:m.target,path:m.resolvedPath})),npmDependencies:y,registryVersion:p.version,tokensUpdated:K});return}D(`Added ${d.items.length} component(s).`)}U();$();function Kt(t){t.command("list").description("List available components in the registry").option("--installed","Show only installed components").option("--registry <url>","Registry URL").option("--token <token>","Auth token").option("--cwd <path>","Project directory").option("--lock <path>","Lockfile path").option("--verbose","Verbose output").option("--silent","Errors only").option("--json","JSON output").action(async n=>{try{await $e(n),process.exit(u.SUCCESS)}catch(e){C()&&S({command:"list",success:!1,error:e instanceof h?{code:e.code,message:e.message,hint:e.hint}:String(e)}),e instanceof h&&(T(`[${e.code}] ${e.message}`),process.exit(u.REGISTRY)),T(String(e)),process.exit(u.ERROR)}})}async function $e(t){let n=t.cwd??process.cwd(),e=I(n),o=t.token??e.token,i=t.registry??e.registry,s=t.lock;N()||console.log();let a=await E("Fetching registry...",()=>J(i,o));if(C()){if(t.installed){let l=await _(n,s);S({command:"list",mode:"installed",components:l?.components??{}})}else S({command:"list",mode:"available",...a});return}let r=a.version&&a.version!=="0.0.0"?` ${a.version}`:"";if(c(`ds v1.2.0 \u2014 Registry: ${a.name}${r}`),a.homepage&&c(`Homepage: ${a.homepage}`),c(""),t.installed){let l=await _(n,s);if(!l||Object.keys(l.components).length===0){T("No components installed.");return}c("Installed components:");for(let[p,f]of Object.entries(l.components)){let g=f.files.map(d=>d.target).join(", ");c(` \u2022 ${p}`),c(` Version: ${f.registryVersion}`),c(` Files: ${g}`)}}else{c(`Available components (${a.items.length}):`);for(let l of a.items)c(` \u2022 ${l.name}`)}D(`${t.installed?"Installed":"Available"}: ${t.installed?Object.keys((await _(n,s))?.components??{}).length:a.items.length}`)}U();ut();$();function Yt(t){t.command("update").description("Update installed components").argument("[components...]","Component name(s)").option("--all","Update all components").option("--force","Force update even if same version").option("-y, --yes","Skip confirmation prompts").option("--no-install","Skip npm dependency installation").option("--registry <url>","Registry URL").option("--token <token>","Auth token").option("--cwd <path>","Project directory").option("--lock <path>","Lockfile path").option("--pm <name>","Package manager").option("--verbose","Verbose output").option("--silent","Errors only").option("--json","JSON output").action(async(n,e)=>{try{await xe(n,e),process.exit(u.SUCCESS)}catch(o){C()&&S({command:"update",success:!1,error:o instanceof h?{code:o.code,message:o.message,hint:o.hint}:String(o)}),o instanceof h&&(R(`[${o.code}] ${o.message}`),o.hint&&c(` \u2192 ${o.hint}`),process.exit(u.ERROR)),R(String(o)),process.exit(u.ERROR)}})}async function xe(t,n){let e=n.cwd??process.cwd(),o=I(e),i=n.token??o.token,s=n.registry??o.registry,a=n.lock,r=C();!N()&&!r&&console.log(),await et(e,n.yes);let l=await _(e,a);if(!l||Object.keys(l.components).length===0){if(r){S({command:"update",success:!1,error:"no_components_installed"});return}T("No components installed. Run ds add first.");return}let p=await j(e),f=await(r?J(s,i):E("Fetching registry...",()=>J(s,i)));if(f.version===l.registry.version&&!n.force){if(r){S({command:"update",success:!0,components:[],files:[],npmDependencies:[],registryVersion:f.version,tokensUpdated:!1,message:"already_up_to_date"});return}O("Registry is already up to date (no changes).");return}let g;if(n.all)g=Object.keys(l.components);else if(t.length>0){let m=t.filter(w=>!l.components[w]);if(m.length>0)throw new h("E_RESOLVE_UNKNOWN",`Component(s) not installed: ${m.join(", ")}`,"Use ds list --installed to see installed components.");g=t}else g=Object.keys(l.components);let d=await Ct(g,async m=>F(s,i,m));if(!n.yes&&!r&&!await z(`Update ${d.items.length} component(s) to version ${f.version}?`)){c("Operation cancelled.");return}let y=d.items.flatMap(m=>(m.files??[]).filter(w=>!!w.content).map(w=>{let k=q(w.content,p.aliases);return k=Q(k,d.items),{target:w.target??w.path,content:k}})),v=await(r?nt(p,y):E("Updating files...",()=>nt(p,y)));lt(l,s,f.name,f.version);for(let m of d.items){let w=(m.files??[]).map(k=>{let b=k.content??"",x=q(b,p.aliases);return x=Q(x,d.items),{target:k.target??k.path,sha256:W(x)}});ct(l,f.version,m.name,w,m.dependencies,m.registryDependencies)}await ot(e,l,a),r||O(`Updated ${v.length} file(s).`);let L=[...d.allNpmDeps];!n.noInstall&&L.length>0&&(r?await X(e,L):await E("Installing dependencies...",()=>X(e,L)));let rt=!1,Z=await F(s,i,"tokens").catch(()=>null),K=p.tailwindCssPath,at=Z?.files?.[0]?.content;if(K&&at&&(r?await M(K,at,f.version):await E("Patching CSS tokens...",()=>M(K,at,f.version)),rt=!0),r){S({command:"update",success:!0,components:d.items.map(m=>m.name),files:v.map(m=>({target:m.target,path:m.resolvedPath})),npmDependencies:L,registryVersion:f.version,tokensUpdated:rt});return}D(`Updated ${d.items.length} component(s).`)}U();$();import Oe from"picocolors";function zt(t){t.command("verify").description("Verify installed component integrity (local vs lock drift check)").option("--cwd <path>","Project directory").option("--lock <path>","Lockfile path").option("--verbose","Verbose output").option("--silent","Errors only").option("--json","JSON output").action(async n=>{try{let e=await Ie(n);process.exit(e?u.SUCCESS:u.DRIFT)}catch(e){e instanceof h&&(R(`[${e.code}] ${e.message}`),process.exit(u.ERROR)),R(String(e)),process.exit(u.ERROR)}})}async function Ie(t){let n=t.cwd??process.cwd(),e=t.lock;N()||console.log();let o=await _(n,e);if(!o)return T("No lockfile found. Run ds add first."),!0;let i=await j(n),s=[];for(let[a,r]of Object.entries(o.components))for(let l of r.files){let p=(await Promise.resolve().then(()=>(U(),Pt))).resolveTargetPath(i.aliases,n,l.target),f=await Et(p).catch(()=>null);f?f!==l.sha256&&s.push({name:a,target:l.target,expected:l.sha256,actual:f}):s.push({name:a,target:l.target,expected:l.sha256,actual:"FILE_MISSING"})}if(C())return S({command:"verify",ok:s.length===0,drifted:s}),s.length===0;if(s.length===0)return O("All components are intact. No drift detected."),!0;R(`Drift detected in ${s.length} file(s):`);for(let a of s)c(` ${Oe.red("!")} ${a.name}: ${a.target}`),c(` Expected: ${a.expected.slice(0,12)}...`),c(` Actual: ${a.actual==="FILE_MISSING"?"FILE MISSING":`${a.actual.slice(0,12)}...`}`);return c(""),T("Run ds diff to see detailed changes."),!1}U();$();import mt from"picocolors";function Bt(t){t.command("info").description("Show detailed information about a component").argument("<component>","Component name").option("--registry <url>","Registry URL").option("--token <token>","Auth token").option("--cwd <path>","Project directory").option("--verbose","Verbose output").option("--silent","Errors only").option("--json","JSON output").action(async(n,e)=>{try{await _e(n,e),process.exit(u.SUCCESS)}catch(o){C()&&S({command:"info",success:!1,error:o instanceof h?{code:o.code,message:o.message,hint:o.hint}:String(o)}),o instanceof h&&(R(`[${o.code}] ${o.message}`),o.hint&&c(` \u2192 ${o.hint}`),process.exit(u.REGISTRY)),R(String(o)),process.exit(u.ERROR)}})}async function _e(t,n){let e=n.cwd??process.cwd(),o=I(e),i=n.token??o.token,s=n.registry??o.registry,a=await E(`Fetching ${t}...`,()=>F(s,i,t));if(C()){S({command:"info",...a});return}if(c(""),c(`${mt.bold(a.name)}${a.title?` \u2014 ${a.title}`:""}`),a.description&&c(` ${mt.dim(a.description)}`),c(""),c(`${mt.dim("Type:")} ${a.type}`),c(""),a.dependencies&&a.dependencies.length>0){c(`${mt.dim("npm dependencies:")}`);for(let r of a.dependencies)c(` \u2022 ${r}`);c("")}if(a.registryDependencies&&a.registryDependencies.length>0){c(`${mt.dim("Registry dependencies:")}`);for(let r of a.registryDependencies)c(` \u2022 ${r}`);c("")}c(`${mt.dim("Files:")}`);for(let r of a.files??[])c(` \u2022 ${r.path} (${r.type})`);D(`info: ${a.name}`)}U();$();import qt from"picocolors";function Qt(t){t.command("whoami").description("Validate auth token against the registry").option("--registry <url>","Registry URL").option("--token <token>","Auth token").option("--cwd <path>","Project directory").option("--verbose","Verbose output").option("--silent","Errors only").option("--json","JSON output").action(async n=>{try{await Le(n),process.exit(u.SUCCESS)}catch(e){C()&&S({command:"whoami",authenticated:!1,error:e instanceof h?{code:e.code,message:e.message,hint:e.hint}:String(e)}),e instanceof tt&&(R(`[${e.code}] ${e.message}`),e.hint&&c(` \u2192 ${e.hint}`),process.exit(u.AUTH)),e instanceof h&&(R(`[${e.code}] ${e.message}`),process.exit(u.ERROR)),R(String(e)),process.exit(u.ERROR)}})}async function Le(t){let n=t.cwd??process.cwd(),e=I(n),o=t.token??e.token,i=t.registry??e.registry;if(!o)throw new tt("E_AUTH_MISSING","Auth token not found","Set LEMA_DS_TOKEN in your .env.local file.");let s=await E("Validating token...",()=>J(i,o));if(C()){S({command:"whoami",authenticated:!0,registry:s.name,version:s.version});return}c(""),c(`${qt.green("\u2714")} Token is valid!`),c(` Registry: ${s.name} ${s.version}`),c(` URL: ${i}`);let a=o.length>8?`${o.slice(0,4)}${"\u2022".repeat(o.length-8)}${o.slice(-4)}`:"\u2022\u2022\u2022\u2022\u2022\u2022\u2022\u2022";c(` Token: ${qt.dim(a)}`),D("Authenticated")}U();import V from"picocolors";import{execSync as Ne}from"child_process";import{existsSync as De,writeFileSync as Fe,unlinkSync as Pe}from"fs";import{readFile as Te}from"fs/promises";import{tmpdir as Ae}from"os";import{randomUUID as je}from"crypto";import{resolve as Ue}from"path";U();async function vt(t,n,e,o){let i=[];for(let s of e.files){let a=ft(t.aliases,t.cwd,s.target),r=De(a)?await Et(a).catch(()=>null):null,l=o?.files?.find(v=>(v.target??v.path)===s.target||v.path===s.target),p=l?.content??null,f=p?W(p):null,g=l&&(l.target??l.path)!==s.target?l.target??l.path:void 0,d;r?f===null?d=r===s.sha256?"up-to-date":"drift-only":r===s.sha256&&f===s.sha256?d="up-to-date":r===s.sha256&&f!==s.sha256?d="clean-update":r!==s.sha256&&f===s.sha256?d="drift-only":d="conflict":d="missing";let y=null;if(d==="conflict"||d==="drift-only")try{y=await Te(a,"utf-8")}catch{y=null}i.push({target:s.target,resolvedPath:a,status:d,localHash:r,lockHash:s.sha256,remoteHash:f,localContent:y,remoteContent:p,remoteTarget:g})}return{name:e.registryVersion,files:i}}function bt(t){let n={components:t,upToDate:0,cleanUpdates:0,drifts:0,conflicts:0,missing:0};for(let e of t)for(let o of e.files)o.status==="up-to-date"?n.upToDate++:o.status==="clean-update"?n.cleanUpdates++:o.status==="drift-only"?n.drifts++:o.status==="conflict"?n.conflicts++:o.status==="missing"&&n.missing++;return n}function Xt(t,n,e){let o=Ue(Ae(),`ds-${e}-${je().slice(0,8)}`);Fe(o,n,"utf-8");try{return Ne(`git diff --no-index -- "${t}" "${o}"`,{encoding:"utf-8",stdio:["ignore","pipe","pipe"],timeout:15e3})}catch(i){return i.stdout?i.stdout:i.stderr?i.stderr:`[diff failed: ${i.message}]`}finally{try{Pe(o)}catch{}}}function ht(t,n){return Xt(t,n,"remote")}function Zt(t,n,e){return Xt(t,n,e)}$();function te(t){t.command("diff").description("Show differences between local files and the registry").argument("[components...]","Component name(s)").option("--all","Show diff for all installed components").option("--registry <url>","Registry URL").option("--token <token>","Auth token").option("--cwd <path>","Project directory").option("--lock <path>","Lockfile path").option("--verbose","Verbose output").option("--silent","Errors only").option("--json","JSON output").action(async(n,e)=>{try{await Je(n,e),process.exit(u.SUCCESS)}catch(o){o instanceof h&&(R(`[${o.code}] ${o.message}`),o.hint&&c(` \u2192 ${o.hint}`),process.exit(u.ERROR)),R(String(o)),process.exit(u.ERROR)}})}async function Je(t,n){let e=n.cwd??process.cwd(),o=I(e),i=n.token??o.token,s=n.registry??o.registry,a=n.lock;N()||console.log();let r=await _(e,a);if(!r||Object.keys(r.components).length===0){T("No components installed. Run ds add first.");return}let l=await j(e),p;if(n.all)p=Object.keys(r.components);else if(t.length>0){let d=t.filter(y=>!r.components[y]);if(d.length>0)throw new h("E_RESOLVE_UNKNOWN",`Component(s) not installed: ${d.join(", ")}`,"Use ds list --installed to see installed components.");p=t}else p=Object.keys(r.components);let f=[];for(let d of p){let y=r.components[d],v=await F(s,i,d).catch(()=>null),L=await vt(l,r,y,v);f.push({...L,name:d})}let g=bt(f);if(C()){S({summary:g,components:f});return}if(g.upToDate===g.upToDate+g.cleanUpdates+g.drifts+g.conflicts+g.missing){O("All components are up to date. No differences found.");return}for(let d of f)for(let y of d.files)y.status!=="up-to-date"&&(c(""),c(V.bold(`\u{1F4C4} ${y.target}`)),c(` Status: ${We(y.status)}`),y.status==="drift-only"&&y.localContent&&(c(" Local changes (not reflected in lock):"),c(Zt(y.resolvedPath,y.localContent,"local"))),y.status==="conflict"&&y.remoteContent&&(c(" Conflict between local and remote versions:"),c(ht(y.resolvedPath,y.remoteContent))),y.status==="clean-update"&&y.remoteContent&&(c(" Remote version available (safe to apply):"),c(ht(y.resolvedPath,y.remoteContent))),y.status==="missing"&&c(` Expected file not found at: ${y.resolvedPath}`));c(""),c(Ge(g)),D("diff complete")}function We(t){return{"up-to-date":V.green("\u2713 up to date"),"clean-update":V.blue("\u21BB safe update"),"drift-only":V.yellow("\u26A1 locally edited"),conflict:V.red("\u2717 conflict"),missing:V.red("\u2717 file missing")}[t]??t}function Ge(t){let n=[];return t.upToDate>0&&n.push(V.green(`${t.upToDate} up to date`)),t.cleanUpdates>0&&n.push(V.blue(`${t.cleanUpdates} safe update(s)`)),t.drifts>0&&n.push(V.yellow(`${t.drifts} drift(s)`)),t.conflicts>0&&n.push(V.red(`${t.conflicts} conflict(s)`)),t.missing>0&&n.push(V.red(`${t.missing} missing`)),n.join(" | ")}U();import H from"picocolors";ut();$();function ee(t){t.command("sync").description("Synchronize installed components with the registry (interactive)").argument("[components...]","Component name(s)").option("--all","Synchronize all components").option("-y, --yes","Auto-apply safe changes (no prompts)").option("--no-install","Skip npm dependency installation").option("--registry <url>","Registry URL").option("--token <token>","Auth token").option("--cwd <path>","Project directory").option("--lock <path>","Lockfile path").option("--pm <name>","Package manager").option("--verbose","Verbose output").option("--silent","Errors only").option("--json","JSON output").action(async(n,e)=>{try{await Ve(n,e),process.exit(u.SUCCESS)}catch(o){o instanceof h&&(R(`[${o.code}] ${o.message}`),o.hint&&c(` \u2192 ${o.hint}`),process.exit(u.ERROR)),R(String(o)),process.exit(u.ERROR)}})}async function Ve(t,n){let e=n.cwd??process.cwd(),o=I(e),i=n.token??o.token,s=n.registry??o.registry,a=n.lock,r=C();!N()&&!r&&console.log(),await et(e,n.yes);let l=await _(e,a);if(!l||Object.keys(l.components).length===0){if(r){S({command:"sync",success:!1,message:"no_components_installed"});return}T("No components installed. Run ds add first.");return}let p=await j(e),f=await(r?J(s,i):E("Fetching registry...",()=>J(s,i)));f.version===l.registry.version&&!r&&O("Registry is up to date. Checking for local drift...");let g;if(n.all)g=Object.keys(l.components);else if(t.length>0){let k=t.filter(b=>!l.components[b]);if(k.length>0)throw new h("E_RESOLVE_UNKNOWN",`Component(s) not installed: ${k.join(", ")}`,"Use ds list --installed to see installed components.");g=t}else g=Object.keys(l.components);let{diffs:d,remoteItems:y}=await Me(g,p,l,s,i),v=bt(d);if(r){S({command:"sync",summary:v,components:d});return}if(v.upToDate===v.upToDate+v.cleanUpdates+v.drifts+v.conflicts+v.missing&&v.cleanUpdates+v.drifts+v.conflicts===0){O("Everything is in sync. No changes detected.");return}c(""),c(H.bold("Change summary:")),c(Ke(v)),c("");let L=[],rt=[],Z=new Set;for(let k of d)for(let b of k.files){if(b.status==="up-to-date")continue;let x;if(n.yes?x=b.status==="conflict"?"skip":"take":x=await He(k.name,b),x==="abort"){c("Operation aborted by user.");return}if(x==="skip"){c(` ${H.dim("\u2192 skipping")} ${b.target}`);continue}if(x==="keep"){c(` ${H.dim("\u2192 keeping local")} ${b.target}`);continue}if(x==="take"&&b.remoteContent){let P=b.remoteTarget??b.target,st=q(b.remoteContent,p.aliases);st=Q(st,y),L.push({target:P,content:st}),O(`${H.green("\u2192")} ${P}`)}}if(L.length===0){c("No changes to apply.");return}if(!n.yes&&!await z(`Apply ${L.length} change(s)?`)){c("Operation cancelled.");return}await E("Applying changes...",()=>nt(p,L));for(let k of d){let b=y.find(P=>P.name===k.name);if(!b)continue;let x=(b.files??[]).filter(P=>L.some(st=>st.target===(P.target??P.path))).map(P=>{let st=P.content??"",$t=q(st,p.aliases);return $t=Q($t,y),{target:P.target??P.path,sha256:W($t)}});if(x.length>0&&(rt.push({name:k.name,files:x,dependencies:b.dependencies,registryDependencies:b.registryDependencies}),b.dependencies))for(let P of b.dependencies)Z.add(P)}lt(l,s,f.name,f.version);for(let k of rt)ct(l,f.version,k.name,k.files,k.dependencies,k.registryDependencies);await ot(e,l,a);let K=[...Z];!n.noInstall&&K.length>0&&await E("Installing dependencies...",()=>X(e,K));let at=await F(s,i,"tokens").catch(()=>null),m=p.tailwindCssPath,w=at?.files?.[0]?.content;m&&w&&await E("Patching CSS tokens...",()=>M(m,w,f.version)),D(`${L.length} file(s) synchronized.`)}async function Me(t,n,e,o,i){let s=[],a=[];for(let r of t){let l=e.components[r],p=await F(o,i,r).catch(()=>null);p&&a.push(p);let f=await vt(n,e,l,p);s.push({...f,name:r})}return{diffs:s,remoteItems:a}}async function He(t,n){c(""),c(H.bold(`Conflict in ${t} \u2014 ${n.target}`));let e=[{label:"Keep local",value:"keep"},{label:"Overwrite with remote",value:"take"},{label:"Skip this file",value:"skip"},{label:"Abort everything",value:"abort"}];n.remoteContent&&await z("View diff before deciding?")&&(c(""),c(ht(n.resolvedPath,n.remoteContent)));let o=await Dt(`What to do with ${n.target}?`,e);return typeof o!="string"?"skip":o}function Ke(t){let n=[];return t.upToDate>0&&n.push(H.green(`${t.upToDate} up to date`)),t.cleanUpdates>0&&n.push(H.blue(`${t.cleanUpdates} safe update(s)`)),t.drifts>0&&n.push(H.yellow(`${t.drifts} drift(s)`)),t.conflicts>0&&n.push(H.red(`${t.conflicts} conflict(s)`)),t.missing>0&&n.push(H.red(`${t.missing} missing`)),n.join(" | ")}U();$();function ne(t){t.command("sync-tokens").description("Force refetch and patch CSS tokens").option("--registry <url>","Registry URL").option("--token <token>","Auth token").option("--cwd <path>","Project directory").option("--lock <path>","Lockfile path").option("--verbose","Verbose output").option("--silent","Errors only").option("--json","JSON output").action(async n=>{try{await Ye(n),process.exit(u.SUCCESS)}catch(e){C()&&S({command:"sync-tokens",success:!1,error:e instanceof h?{code:e.code,message:e.message,hint:e.hint}:String(e)}),e instanceof h&&(R(`[${e.code}] ${e.message}`),e.hint&&c(` \u2192 ${e.hint}`),process.exit(u.ERROR)),R(String(e)),process.exit(u.ERROR)}})}async function Ye(t){let n=t.cwd??process.cwd(),e=I(n),o=t.token??e.token,i=t.registry??e.registry,s=t.lock,a=C();!N()&&!a&&console.log(),await et(n);let r=await j(n);if(!r.tailwindCssPath)throw new h("E_CONFIG_NO_TAILWIND_CSS","tailwind.css not declared in components.json","Add tailwind.css to your components.json.");let p=(await E("Fetching tokens from registry...",()=>F(i,o,"tokens"))).files?.[0]?.content;if(!p)throw new h("E_REGISTRY_INVALID","Tokens item does not contain CSS content","Report to the registry maintainer.");let f=r.tailwindCssPath;await E("Patching globals.css...",()=>M(f,p,"0.0.0"));let g=await _(n,s);if(g&&(g.tokens={registryVersion:g.registry.version,installedAt:new Date().toISOString(),sha256:W(p)},await ot(n,g,s)),a){S({command:"sync-tokens",success:!0,sha256:W(p),path:r.tailwindCssPath});return}O(`CSS tokens updated at ${r.tailwindCssPath}`),D("sync-tokens complete")}var G=new ze;G.name("ds").description("CLI to manage LEMA Design System components").version("1.2.0").hook("preAction",t=>{let n=t.optsWithGlobals();n.silent?_t("silent"):n.verbose&&_t("verbose"),n.json&&Nt(!0)});G.option("--verbose","Verbose output").option("--silent","Errors only").option("--json","JSON output");Ht(G);Kt(G);Yt(G);zt(G);Bt(G);Qt(G);te(G);ee(G);ne(G);G.parse(process.argv);
|
package/package.json
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@lema-ufpb/ds-sync",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.2.0",
|
|
4
4
|
"description": "CLI to manage LEMA Design System components in consuming projects",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
7
|
-
"
|
|
7
|
+
"ds": "./dist/cli.js"
|
|
8
8
|
},
|
|
9
9
|
"files": [
|
|
10
10
|
"dist"
|