@getvitops/create 0.3.1 → 0.3.3

package/CHANGELOG.md

@@ -1,5 +1,94 @@
 # @getvitops/create
 
+## 0.3.3
+
+### Patch Changes
+
+- **Fixed: `vitops init` and `vp create` scaffolded configs referencing tokens that no longer
+  exist.** `defaultConfig()` and the EmDash template still pointed at `--color-surface-xl` and
+  `--color-surface-xxl`, aliases from the named-step colour scale removed in 0.6. A scaffolded
+  project therefore got a `card` with no background and an invalid default border colour, with
+  nothing reporting it. Both now use `--surface-bg` / `--surface-bg-muted`. The EmDash template
+  also dropped its `patterns.radii.card` key, which collided with the `card` pattern on
+  `--br-card` — the collision `validate()` has been warning about (the `panel` group already
+  supplies the same radius, so nothing changes visually).
+
+  **Fixed: `.text-reveal` rendered invisible text.** Its gradient consumed
+  `--text-reveal-color-from`/`-to` with no defaults, so unless a consumer set both, the `var()`
+  substitution failed, `background` became invalid at computed-value time, and the accompanying
+  `color: transparent` left the text with no way to render. Both tones now default to the
+  functional text tokens.
+
+  **Fixed: `.bordered` fell back to `currentColor`** via a reference to `--color-surface-xl`,
+  which the generator never emitted. It now resolves `--surface-border`.
+
+  **New: `validate()` warns when a required role is missing.** `colors.roles` is an open map —
+  any name works and generates a full token set — but the shipped component CSS references
+  `brand-primary`, `danger`, `neutral`, `surface`, `ui-primary` and `warning` with no fallback,
+  so omitting one leaves those components uncoloured. This is a warning, not an error; the
+  required list is re-derived from the CSS partials by a test so it cannot drift.
+
+  `vitops docs` and `vitops agents` now surface config warnings (on stderr, so piping `docs` is
+  unaffected). They previously discarded them, unlike `generate` and `validate`.
+
+  Docs corrections, all in the generated bundle:
+  - **Raw scale classes are frozen and do not remap in dark mode** — stated explicitly for the
+    first time, with a migration table to the role equivalents. The dark-mode guarantee only ever
+    applied to functional role tokens, and nothing said so.
+  - **Roles are extensible over a required core** — the schema description and class reference
+    read as a closed enumeration, which is why a consumer forked their own colour layer rather
+    than adding a role.
+  - **The `md:` / `@md:` / `md-` distinction** in the tailwind format: `@md:` uses the framework's
+    breakpoints, `md:` works but uses Tailwind's (which differ — `sm:` is 40rem, `@sm:` is 30rem),
+    and `md-` is silently inert. Plus a note that registering `--container-*` also re-points
+    Tailwind's `max-w-*` scale.
+  - The css and bricks bundles now carry a `/*!` banner pointing at `npx vitops docs classes`
+    (the previous plain comment was stripped by the minifier, so it never reached the file).
+
+  Contrast checking now covers **every** background plane a role emits (`bg`, `bg-muted`, and
+  `bg-bold`), not just `bg` — body text on a `card` was previously unguaranteed.
+
+## 0.3.2
+
+### Patch Changes
+
+- a334049: Make the semantic icon mapping reachable, and fail the build on unresolvable names.
+
+  `generateIconInclude()` — declare the semantic icon names a site needs plus which sets to draw
+  them from, get back the `include` map that keeps the bundle to just those glyphs — already existed
+  but was unreachable: it lived in `@getvitops/core/src/utils/`, which the package doesn't export.
+  It has moved to `@getvitops/utils` (a build-time concern, in the build-time utilities package),
+  which `@getvitops/astro` re-exports wholesale. So from `astro.config.mjs`:
+
+  ```js
+  import { generateIconInclude } from '@getvitops/astro';
+  import icon from 'astro-icon';
+
+  integrations: [
+    icon({
+      include: generateIconInclude({
+        ui: 'fa7-solid',
+        brand: 'simple-icons',
+        semantic: ['menu', 'close', 'search', 'github'],
+      }),
+    }),
+  ];
+  // → { "fa7-solid": ["bars","xmark","magnifying-glass"], "simple-icons": ["github"] }
+  ```
+
+  Swapping `ui` to `'lucide'` yields `{ lucide: ["menu","x","search"] }` from the same declaration —
+  which is the point: the semantic names are what your markup commits to, and the set is a config
+  choice. The output shape is the `include` both `astro-icon` and `astro-iconset` accept, so the
+  mapping doesn't tie you to either.
+
+  **Unresolvable names are now a build error.** Previously they were skipped silently, so swapping
+  sets appeared to succeed and the gaps surfaced as missing glyphs in production. The error names
+  every offender; an unknown set name throws too, listing the known sets.
+
+  Also fixes `@getvitops/create`'s emdash template, which pinned `@getvitops/astro: ^0.4.0` — a range
+  that stopped resolving when astro joined the fixed group at 0.7.0, so scaffolded projects were
+  stuck on the old line.
+
 ## 0.3.1
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getvitops/create",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Project templates for the Vitops design system — scaffold wired-up sites with `vp create @getvitops`.",
   "license": "MIT",
   "files": [

package/templates/emdash/design-system.json

@@ -49,12 +49,12 @@
   "patterns": {
     "defaults": {
       "ds": "none",
-      "b": "1px solid var(--color-surface-xl)",
+      "b": "1px solid var(--surface-bg-muted)",
       "br": "0.375rem",
       "p": "1rem",
       "fs": "1rem"
     },
-    "radii": { "pill": "999px", "circle": "50%", "card": "0.5rem" },
+    "radii": { "pill": "999px", "circle": "50%" },
     "groups": {
       "control": {
         "ds": "var(--ds-default)",
@@ -99,7 +99,7 @@
         "base": {
           "border-radius": "var(--br-card-group)",
           "padding": "1.5rem",
-          "background": "var(--color-surface-xxl)",
+          "background": "var(--surface-bg)",
           "border": "var(--b-card-group)",
           "box-shadow": "var(--ds-card-group)"
         },

package/templates/emdash/package.json

@@ -19,8 +19,8 @@
     "@astrojs/cloudflare": "^14.0.0",
     "@astrojs/react": "^6.0.0",
     "@emdash-cms/cloudflare": "^0.31.0",
-    "@getvitops/astro": "^0.4.0",
-    "@getvitops/emdash": "^0.2.0",
+    "@getvitops/astro": "^0.7.0",
+    "@getvitops/emdash": "^0.2.1",
     "astro": "^7.1.2",
     "emdash": "^0.31.0",
     "react": "^19.2.4",