@lincyaw/skills 1.0.0-rc.2 → 1.0.0-rc.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lincyaw/skills",
-  "version": "1.0.0-rc.2",
+  "version": "1.0.0-rc.4",
   "description": "Presmium's bundled authoring, animation, presentation and plugin-development skills for coding agents",
   "license": "Apache-2.0",
   "repository": {
@@ -36,7 +36,7 @@
   ],
   "dependencies": {
     "jiti": "^2.7.0",
-    "@lincyaw/kernel": "1.0.0-rc.2"
+    "@lincyaw/kernel": "1.0.0-rc.4"
   },
   "presmium": {
     "skills": [

package/skills/index.json

@@ -10,8 +10,8 @@
       "references/publishing.md",
       "references/writing.md"
     ],
-    "version": "1.0.0-rc.2",
-    "hash": "2e27ca4a0f11c77ec4e66f82b28f3d2b27258f975bf1ab08b9491e1e741aa747"
+    "version": "1.0.0-rc.4",
+    "hash": "3f841d69e55215c71ce44c08a8d5637ed5b6a94be165f9a75283c7df08dbac0c"
   },
   {
     "name": "presmium-animate",
@@ -535,7 +535,7 @@
       "references/storyboards.md",
       "references/timeline.md"
     ],
-    "version": "1.0.0-rc.2",
+    "version": "1.0.0-rc.4",
     "hash": "9e3a9ca95da8c619742adbcfee68112d426a48b442fd375b367e5e5fb3cf5a21"
   },
   {
@@ -547,7 +547,7 @@
       "references/delivery.md",
       "references/lecture.md"
     ],
-    "version": "1.0.0-rc.2",
+    "version": "1.0.0-rc.4",
     "hash": "04a41943c1bb3ef1a13bf9847946b27b16535dd78358e606de2d999730217560"
   },
   {
@@ -558,7 +558,7 @@
       "references/plugin.md",
       "references/testing.md"
     ],
-    "version": "1.0.0-rc.2",
+    "version": "1.0.0-rc.4",
     "hash": "9b3cab9683b45f11c631a19f916639ffb4c0f74c054c14baee24aa5655a35de4"
   }
 ]

package/skills/presmium-author/references/publishing.md

@@ -46,8 +46,27 @@ In the workspace configuration, `site.theme` selects `course`, `docs` or `showca
 | `contentWidth` | `comfortable`, `wide` |
 | `logo`, `logoAlt` | The logo location and alternative text |
 
+For a look of its own, `site.theme` names a theme directory (`./theme`) or an installed theme package instead of a built-in id. The directory holds `theme.json`:
+
+```json
+{
+  "schemaVersion": 1,
+  "name": "pixel",
+  "extends": "docs",
+  "params": { "typography": "sans" },
+  "tokens": { "font-sans": "'IBM Plex Sans', system-ui, sans-serif", "color-bg": "#f6f6f1", "color-accent": "#2546b8", "radius-control": "0" },
+  "dark": { "color-bg": "#121216", "color-accent": "#8ea6ff" },
+  "fonts": ["https://fonts.googleapis.com/css2?family=Silkscreen&display=swap"],
+  "styles": ["./pixel.css"]
+}
+```
+
+`extends` picks the built-in layouts (default `docs`); `params` are defaults under the site's own `site.params`. `tokens` set design tokens by their name without `--pm-` (the build rejects unknown names); colors and shadows there are the light appearance's, and `dark` sets the dark ones, falling back to the built-in dark values. `fonts` are `https:` stylesheet URLs; `styles` are CSS files in the theme directory, which may use relative `url()`s to the directory's fonts and images. Every page carries `data-pm-site-theme-name="<name>"`, so a stylesheet scopes its rules with `[data-pm-site-theme-name='pixel']`. An HTML template homepage receives the stylesheets in the site data (`site.theme.stylesheets`) to link them itself. A theme package sets `presmium.theme` in its `package.json` to the directory with `theme.json`, or keeps `theme.json` at its root.
+
 Keep each teaching document's page layout in `metadata.renderers.web.layout`: `article` (default), `landing` (all sections combined into one full-width HTML page without sidebars or page navigation), or `wide` (wider content without the right outline). Each translation uses its own layout, defaulting to `article` when omitted; it does not inherit the original's layout. A standalone document can select `theme` and `params` in its own `metadata.renderers.web`; do not use document themes to override the shared shell of a workspace site. A string `site.landing` adds a full-document root page without changing the original document's pagination; a document's own `layout: landing` changes that pagination. Independent site page content stays separate. Templates do not alter authored block/step identities, narration or production settings.
 
+A workspace build also builds the presentation of every document whose `metadata.renderers` lists `slides` or `lecture`: `<dir>/slides/` and `<dir>/lecture/` beside its pages. A template homepage can play a narrated document in an iframe at `<dir>/slides/?view=present&track=script&autoplay`, starting at a step with `section=<id>&step=<n>`.
+
 After changing website settings in `presmium.workspace.yaml`, restart `pnpm serve` for preview or run `pnpm build` again for the output. Existing serve sessions do not reload the workspace's website configuration.
 
 `pnpm build` in the generated site writes `dist/web/`. Its `.github/workflows/pages.yml` reads GitHub Pages' base path, builds and deploys that directory after the repository's Pages source is set to GitHub Actions. Other hosts can serve the same static output. Check the real deployed root and an inner-page direct link, plus search and media; a successful local build does not verify the deployment path.