4. Product and platform
Esta página está em inglês; a tradução está a caminho.
| ID | Requirement | P | Type | Ver. | M |
|---|---|---|---|---|---|
| PLT-1 | The extension shall open .design files in a custom editor. CustomEditorProvider (binary-capable, own document) for *.design; double-clicking a file in the Explorer opens the canvas. |
Must | functional | test | 0.1 |
| PLT-2 | A .design file shall hold one design document. Pages, nodes, components, styles, variables, prototype flows, comments and history in one UTF-8 JSON file. Images and fonts the file uses are stored next to it in <name>.design.assets/, addressed by content hash (FMT-001 §8). |
Must | constraint | inspection | 0.1 |
| PLT-3 | The file shall use the tree plus write-append list design of .pb 2.0. Events appended one per line with a leading comma; consolidation folds them into the tree. Envelope, tolerance and identifier rules as in FMT-001. |
Must | constraint | test | 0.1 |
| PLT-4 | The format shall be versioned and published as a JSON Schema. designVersion, $schema URL, migrations for older versions; unknown fields kept, unknown ops skipped with a warning. |
Must | interface | test | 0.1 |
| PLT-5 | Every change shall go through the VS Code document. Undo/redo, save, revert, hot exit, backup and the dirty marker behave as in any editor. A compound change (paste, AI proposal, batch) is one undo step. | Must | functional | test | 0.1 |
| PLT-6 | The user shall be able to open the file as JSON text. “Open as Text” and “Open as Design” in the editor title and Explorer context menu. | Should | functional | demonstration | 0.1 |
| PLT-7 | New designs shall start from templates. “New Design” offers: blank, mobile app (390×844), web (1440×1024), desktop app, design system starter (variables, text styles, base components); written to a chosen folder and opened. Also ud new. |
Must | functional | test | 0.1 |
| PLT-8 | Changes by another process shall merge into the open editor. CLI runs without the bridge, AI runs, git checkouts: new events apply live; the user’s unsaved edits are kept and rebased on top. | Must | functional | test | 0.1 |
| PLT-9 | The extension shall run on VS Code Desktop 1.108+ and compatible forks. Windows, macOS, Linux; no native modules. | Must | constraint | inspection | 0.1 |
| PLT-10 | The editor could run in the web extension host. vscode.dev and github.dev, without the CLI and AI features. | Could | constraint | demonstration | backlog |
| PLT-11 | A development server shall run the editor in a browser. npm run dev serves the same webview against the same controller, for fast iteration and screenshot tests, as Software Board does. |
Should | constraint | demonstration | 0.1 |