npm - trdr-ds-install - Versions diffs - 1.9.0 → 2.0.0 - Mend

trdr-ds-install 1.9.0 → 2.0.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.

Files changed (44) hide show

package/plugins/trdr-design-system/skills/trdr-ds/templates/ds-analysis.md ADDED Viewed

@@ -0,0 +1,88 @@
+# Template: DS_ANALYSIS.md
+> Write this file at the project root after Phase 1 analysis.
+> Replace all `[bracketed]` values with actual data from the analysis.
+```markdown
+# TRDR DS — Analysis
+Generated: [ISO datetime]
+Skill version: [X.Y.Z]
+## Project
+Framework: [next.js|react|vue|html]
+Language: [ts|js]
+Styling: [css-modules|tailwind|plain-css|css-in-js|mui]
+Global CSS file: [path]
+Styles dir: [detected-styles-dir]
+[If stylingMode === 'mui':]
+MUI version: [muiVersion]
+Theme file: [themeFilePath]
+Has ThemeProvider: [yes/no]
+MUI CSS Variables mode: [yes/no]
+Files with sx props: [count]
+Files with styled(Mui*): [count]
+## Violations Summary
+Total violations: [total_violations]
+Total files with violations: [total_files_with_violations]
+### By Category
+| Cat | Type | Count | Files |
+|-----|------|-------|-------|
+| A | Hardcoded colors | N | file1.css, file2.jsx |
+| B | Hardcoded font-family | N | ... |
+| C | Hardcoded px spacing | N | ... |
+| D | Primitive token use | N | ... |
+| E | Missing tokens.css | N | ... |
+| F | Hardcoded rgba | N | ... |
+| G | Custom gradients | N | ... |
+| H | Hardcoded font-size | N | ... |
+| I | Inline styles | N | ... |
+| J | SVG icons inline | N | ... |
+| K | Logo incorrect/missing | N | ... |
+[If MUI:]
+| L | MUI theme hardcoded | N | theme.ts |
+| M | MUI sx hardcoded | N | ... |
+| N | styled(Mui*) hardcoded | N | ... |
+### By File
+[For each file with violations:]
+#### [file path]
+- A: [value] (line [N]), [value] (line [N])
+- C: [value] (line [N])
+[list all violations with line numbers]
+## Component Replacement Candidates
+### Simple swaps
+| Component | DS Variant | File | Existing Content |
+|-----------|-----------|------|------------------|
+### Complex-preservable
+| Component | File | Handlers/Props Preserved |
+|-----------|------|--------------------------|
+### Manual review required
+| Component | File | Reason |
+|-----------|------|--------|
+### Stubs (not yet implemented)
+[For each stub:]
+- [slug]: [file:line] — stub (figmaId: [id])
+### Dependency Graph
+| Compound Component | Dependencies (install first) |
+|--------------------|----------------------------|
+## Logo Audit
+[For each file:] - [path] — [CORRECT/WRONG/UNKNOWN]
+## Execution Plan
+Batch size: [N] (default 5)
+[Group files by folder, max batch_size per batch:]
+### Batch 1 — [folder/] ([N] files)
+- [file1]
+- [file2]
+### Batch 2 — [folder/] ([N] files)
+- ...
+```

package/plugins/trdr-design-system/skills/trdr-ds/templates/ds-migration.md ADDED Viewed

@@ -0,0 +1,59 @@
+# Template: DS_MIGRATION.md
+> Generate at project root during Sub-fase D (Step 7).
+> Replace all `[bracketed]` values.
+```markdown
+# TRDR Design System — Migration Log
+Applied: [date]
+Catalog: TRDR DS v[catalog-version] ([implemented]/[total] components, generated [generatedAt])
+Hub: https://trdr.mrocontent.com.br
+## What was applied
+- [path]/tokens.css — TRDR CSS custom properties (snapshot v[version])
+- [path]/components.css — [implemented] component utility class blocks + typography
+- CLAUDE.md — design system rules for Claude Code
+- [N] violations fixed in [M] files
+- [global-css] updated with @import
+- [S] stub components flagged in MISSING_COMPONENTS.md (if any)
+- Migrated in [N] batches across 4 sub-phases — see DS_PROGRESS.md
+## Files modified
+[List each file and what changed]
+## Violations fixed
+[List by category with file:line references]
+## Manual steps required
+- [ ] **Fonts**: Ensure JetBrains Mono, Inter, and Roboto Mono are loaded
+  - Next.js: use next/font/google in layout.tsx
+  - Others: add Google Fonts <link> in HTML head
+- [ ] **Dark/light mode**: tokens.css uses [data-theme="light"] for overrides — add data-theme="light" to <html> to activate light mode
+- [ ] **Trading UI**: If this project has price/position displays, verify context.trading.* tokens
+- [ ] **Stubs**: Review MISSING_COMPONENTS.md
+- [ ] **Skipped files**: [list any excluded files]
+[If MUI, add:]
+- [ ] **MUI CSS Variables mode**: If MUI >= 6, add cssVariables: true to createTheme()
+- [ ] **MUI palette auto-generation**: Verify primary.light/dark/contrastText are all explicit
+- [ ] **MUI theme composition**: If using deepmerge, verify DS tokens preserved
+- [ ] **MUI component slots**: Complex components (DataGrid, DatePicker) have slots not covered by styleOverrides
+- [ ] **sx props audit**: grep for sx={{.*#[0-9A-Fa-f] to verify no hardcoded hex remains
+## Missing DS tokens (flagged)
+| Pattern | File | Suggestion |
+|---------|------|-----------|
+## Stub components encountered
+[List each stub slug + figmaId]
+## Manual component review
+[Entries added during Sub-fase C Pass 3]
+## Design System Reference
+- Hub: https://trdr.mrocontent.com.br
+- JSON catalog: https://trdr.mrocontent.com.br/components.json
+- Tokens: https://trdr.mrocontent.com.br/tokens/semanticos
+- Components: https://trdr.mrocontent.com.br/componentes
+- Rules: https://trdr.mrocontent.com.br/para-ia
+```

package/plugins/trdr-design-system/skills/trdr-ds/templates/ds-progress.md ADDED Viewed

@@ -0,0 +1,57 @@
+# Template: DS_PROGRESS.md
+> Write at project root when Phase 2 starts (Step 0).
+> Replace all `[bracketed]` values. This file is the canonical state.
+```markdown
+# TRDR DS Migration — Progress
+Started: [ISO datetime]
+Project: [project name from package.json]
+Batch size: [N]
+Status: IN_PROGRESS
+Backup branch: [branch-name or NONE]
+Original branch: [branch-name]
+Sprint plan: SPRINT_PLAN.md
+Current sprint: 1
+## Sub-fase A: Foundation — PENDING
+- [ ] tokens.css
+- [ ] components.css
+- [ ] CLAUDE.md
+- [ ] @import no CSS global
+## Sub-fase B: Violations — PENDING
+Total de arquivos com violacoes: [total_files_with_violations]
+Total de violacoes: [total_violations]
+Total de lotes: [N]
+[For each batch:]
+### Lote 1 — [folder/] ([N] arquivos) — PENDING
+### Lote 2 — [folder/] ([N] arquivos) — PENDING
+...
+## Sub-fase C: Components — PENDING
+Install order: [topological — atomics first, then compounds]
+[list candidates]
+## Sub-fase D: Final — PENDING
+- [ ] logos incorretos substituidos
+- [ ] DS_MIGRATION.md gerado
+## Padroes Sem Token (revisao manual)
+[empty — filled during execution]
+## Execution Log
+[Each action appends a row here:]
+| Timestamp | Phase | Action | File | Details |
+|-----------|-------|--------|------|---------|
+```
+## Execution Log Rules
+After EVERY file creation or modification, append a row:
+```
+| [ISO datetime] | [sub-phase] | [CREATE/MODIFY/SKIP/FAIL] | [file path] | [details] |
+```
+This log is cumulative — never clear it.

package/plugins/trdr-design-system/skills/trdr-ds/templates/sprint-plan.md ADDED Viewed

@@ -0,0 +1,68 @@
+# Template: SPRINT_PLAN.md
+> Write at project root after DS_ANALYSIS.md (Step 5.6).
+> Replace all `[bracketed]` values.
+```markdown
+# TRDR DS — Sprint Plan
+Generated: [ISO datetime]
+Project: [project name]
+Total sprints: [N]
+Estimated context windows: [N] (one per sprint + one for analysis)
+> Cada sprint e independente. Entre sprints, limpe o contexto (/clear) ou inicie nova conversa.
+> Para continuar: /trdr-ds resume
+---
+## Sprint 1 — Foundation
+**Scope:** Create tokens.css, components.css, CLAUDE.md, @import in global CSS
+[If MUI: + generate/update MUI theme with DS token references]
+**Sub-fase:** A
+**Files to create:** 3 (tokens.css, components.css, CLAUDE.md)
+**Files to modify:** [1 or 2]
+**Status:** PENDING
+---
+## Sprint 2 — Violations: [first-folder/]
+**Scope:** Fix [N] violations in [M] files
+**Sub-fase:** B
+**Files:** [list each file path]
+**Violation count:** [N] (A:[n], B:[n], C:[n], ...)
+**Status:** PENDING
+---
+[... repeat for each folder/batch ...]
+---
+## Sprint [N-1] — Components
+**Scope:** Implement DS components ([S] simple, [P] complex-preservable, [M] manual review)
+[If MUI: Generate MUI theme component styleOverrides, migrate sx prop violations]
+**Candidates:** [total]
+**Sub-fase:** C
+**Install order:** [topological]
+**Status:** PENDING
+---
+## Sprint [N] — Final
+**Scope:** Replace logos, replace SVG icons (size-preserved), generate DS_MIGRATION.md
+**Sub-fase:** D
+**Status:** PENDING
+```
+## Sprint Naming Convention
+- Foundation: `Sprint 1 — Foundation`
+- Violations: `Sprint N — Violations: [folder/]`
+- Split folder: `Sprint Na — Violations: [folder/] (part 1 of 2)`
+- Components: `Sprint N — Components`
+- Final: `Sprint N — Final`
+## Sprint Sizing Rules
+- Max **15 files** per sprint
+- Group by **folder** (natural boundary)
+- If folder >15 files: split into sub-sprints
+- Foundation, Components, Final: each their own sprint