@immediately-run/grove 0.1.3 → 0.1.4

package/llms.txt

@@ -1,6 +1,6 @@
 # @immediately-run/grove — the viewer kit for directory-as-content wikis
 
-> The Grove viewer: a kit of React components, layouts and themes for building immediately.run wikis. Composable as a fork, a dispatch target, or a pinned library. (v0.1.3)
+> The Grove viewer: a kit of React components, layouts and themes for building immediately.run wikis. Composable as a fork, a dispatch target, or a pinned library. (v0.1.4)
 
 Grove is NOT a wiki engine: routing, MDX compilation, the frontmatter index, link
 spaces and heading anchors live in the sandbox + `@immediately-run/sdk`. What this

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@immediately-run/grove",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "type": "module",
   "main": "src/main.tsx",
   "immediately.run": {
@@ -25,13 +25,13 @@
   "scripts": {
     "dev": "vite",
     "build": "tsc -b && vite build",
-    "lint": "eslint .",
+    "lint": "eslint . --max-warnings 0",
     "test": "vitest run",
     "preview": "vite preview",
     "verify": "npm run check:llms && npm run check:engine-api:selftest && npm run check:engine-api && npm run check:manifest && npm run check:deps && npm run check:published && npm run check:theme-contrast && npm run check:theme-token-only && npm run lint && npm run build && npm run test",
     "check:theme-contrast": "node scripts/check-theme-contrast.mjs --self-test && node scripts/check-theme-contrast.mjs",
     "check:theme-token-only": "node scripts/check-theme-token-only.mjs --self-test && node scripts/check-theme-token-only.mjs",
-    "check:manifest": "node scripts/check-manifest.mjs",
+    "check:manifest": "node scripts/check-manifest.mjs --self-test && node scripts/check-manifest.mjs",
     "check:deps": "node scripts/check-app-dependencies.mjs --self-test && node scripts/check-app-dependencies.mjs",
     "check:published": "node scripts/check-published-parity.mjs --self-test && node scripts/check-published-parity.mjs --offline-ok",
     "check:engine-api": "node scripts/check-engine-api.mjs",

package/viewer-manifest.schema.json

@@ -58,6 +58,36 @@
         "passThrough": { "type": "boolean", "description": "Whether unknown keys are allowed (they are carried, unread). False makes the vocabulary closed." }
       }
     },
+    "themes": {
+      "type": "object",
+      "description": "The theme catalogue (R3-310, bucket-independent): every shipped look, keyed by its `theme:` id. The gallery enumerates THIS, so adding a theme adds a row with no edit to any entry.",
+      "additionalProperties": {
+        "type": "object",
+        "required": ["label", "preferred", "ships", "summary"],
+        "additionalProperties": false,
+        "properties": {
+          "label": { "type": "string", "description": "The reader-facing name in the theme menu." },
+          "preferred": { "enum": ["light", "dark"], "description": "The polarity the theme opens in when the reader and host have both said nothing." },
+          "ships": { "type": "boolean", "description": "Whether the theme is selectable today." },
+          "summary": { "type": "string" }
+        }
+      }
+    },
+    "pageVariants": {
+      "type": "object",
+      "description": "The page-variant catalogue (R3-309, bucket B): a frontmatter key on one entry — the page, not the chrome. Behaviour lives in CSS selected by the emitted data attribute; an undeclared value falls back rather than rendering unstyled.",
+      "additionalProperties": {
+        "type": "object",
+        "required": ["key", "value", "ships", "summary"],
+        "additionalProperties": false,
+        "properties": {
+          "key": { "type": "string", "description": "The frontmatter key (`layout`, `frame`)." },
+          "value": { "type": "string", "description": "The value that selects this variant." },
+          "ships": { "type": "boolean", "description": "Whether the variant has shipped CSS today." },
+          "summary": { "type": "string" }
+        }
+      }
+    },
     "layouts": {
       "type": "object",
       "description": "The layout-starters catalogue (R3-309, bucket A): `_layout.mdx` starters under `content/_layouts/` a contributor or agent copies from. Keyed by starter id (= filename); `layoutRole` is the declared kind the entry and the file must agree on — the field existed in the sample layouts for a year with nothing reading it, and the catalogue is what gives it a job.",