@vsceasy/cli 0.1.8 → 0.1.10

package/CHANGELOG.md

@@ -5,6 +5,10 @@ All notable changes follow [Keep a Changelog](https://keepachangelog.com/en/1.1.
 ## [Unreleased]
 
 ### Added
+- **Model relations — `ref(Model)` fields with populated CRUD dropdowns.** Symfony-`make:entity`-style relations.
+  - `vsceasy model add --fields "…,category:ref(Category)"` emits a `categoryId` foreign key plus a `<Name>Relations` metadata block. `ref(Category, label=name)` picks the dropdown label field. The referenced model must exist (errors otherwise, naming what to create); the interactive loop lists relatable models.
+  - `crud add` reads the relation metadata and generates a populated `<select>`: an `options()` RPC handler on the form panel loads the related rows, and the form webview renders a dropdown of them and stores the chosen id. Non-relational CRUD output is unchanged.
+  - ManyToOne only (FK on this model) — no join table or cascade. See the [Relations guide](https://vsceasy.dev/guides/relations/).
 - **Reactivity — keep a webview in sync with data.** A visual element can now track a source and update the instant it changes, no manual refresh.
   - ORM entities fire change events on every mutation; subscribe with `watchEntity(Todos, () => emit('todos:changed'))` from your generated `db.ts`.
   - `defineStore(initial)` — a framework-agnostic observable value (`get`/`set`/`update`/`subscribe`) for non-ORM state. Scaffold one with **`vsceasy store add --name X --type number|string|boolean|json`**.

package/README.md

@@ -8,6 +8,14 @@
 
 <p align="center"><em>Pronounced <strong>"vee-see-easy"</strong> in English (<code>VSC</code> + <code>easy</code>) — or <strong>"visici"</strong> for Spanish speakers.</em></p>
 
+<p align="center">
+  <video src="https://github.com/jairoFernandez/vsceasy/releases/download/promo-assets/vsceasy-promo.mp4" width="720" controls></video>
+</p>
+
+<p align="center">
+  <a href="https://github.com/jairoFernandez/vsceasy/releases/download/promo-assets/vsceasy-promo.mp4">▶ Watch the 30-second promo</a>
+</p>
+
 > Status: v0.1 — React UI. Typed RPC bridge + file-based registry + scaffolding for panels, commands, menus, tree views, subpanels, status bars.
 
 ## Install
@@ -40,11 +48,36 @@ bunx @vsceasy/cli create \
   --displayName "My Extension" \
   --description "Does cool things" \
   --publisher my-publisher \
+  --type ui \
   --ui react \
   --git \
   --install
 ```
 
+### Extension types
+
+`create` asks what kind of extension you're building (`--type`):
+
+| Type | What you get |
+|------|--------------|
+| `ui` *(default)* | React webview + typed RPC bridge. `--preset full` adds a sample panel; `--preset minimal` is empty. |
+| `language` | Language support — TextMate grammar, `language-configuration.json`, snippets, and an opt-in file-icon theme. No React. |
+| `empty` | Bare extension (`activate`/`deactivate` only). No UI, no language. |
+
+```bash
+bunx @vsceasy/cli create --name toml --type language --extensions .toml
+```
+
+### Non-generated contributions: `contributes.extra.json`
+
+`scripts/gen.ts` regenerates the parts of `package.json#contributes` it owns
+(commands, keybindings, views) on every build. Anything it doesn't generate —
+`languages`, `grammars`, `snippets`, `themes`, `iconThemes`, `walkthroughs` —
+goes in a `contributes.extra.json` file at the project root and is deep-merged
+into `package.json` on `bun run gen`. The keys gen owns always win; everything
+else from `contributes.extra.json` is preserved. The `language` scaffold ships a
+populated `contributes.extra.json` wiring up its grammar, snippets and icons.
+
 ## What you get
 
 ```
@@ -335,8 +368,15 @@ vsceasy helper add --kind config          # workspace.getConfiguration — typed
 vsceasy helper add --kind state           # workspace + global mementos
 vsceasy helper add --kind notifications   # toast + confirm + withProgress
 vsceasy helper add --kind cache           # in-memory TTL + LRU + wrap()
+vsceasy helper add --kind colorize        # scoped editor.tokenColorCustomizations
 # For ORM use the dedicated commands: `vsceasy db init` + `vsceasy model add`
 ```
+
+The `colorize` helper writes theme-independent token colors scoped to a single
+TextMate scope (e.g. a language's `source.x`), so only that language is
+recolored — other languages keep the user's theme. `create --type language`
+wires it automatically (auto-apply on activate behind a `<prefix>.colorize`
+opt-out setting + `Apply/Remove Colors` commands).
 For `secrets` and `state`, wire on activate:
 ```ts
 import { initSecrets } from './helpers/secrets';