@lincyaw/skills 1.0.0-rc.39 → 1.0.0-rc.40

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lincyaw/skills",
3
- "version": "1.0.0-rc.39",
3
+ "version": "1.0.0-rc.40",
4
4
  "description": "Presmium's bundled authoring, animation, presentation and plugin-development skills for coding agents",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {
@@ -36,7 +36,7 @@
36
36
  ],
37
37
  "dependencies": {
38
38
  "jiti": "^2.7.0",
39
- "@lincyaw/kernel": "1.0.0-rc.39"
39
+ "@lincyaw/kernel": "1.0.0-rc.40"
40
40
  },
41
41
  "presmium": {
42
42
  "skills": [
package/skills/index.json CHANGED
@@ -12,8 +12,8 @@
12
12
  "references/publishing.md",
13
13
  "references/writing.md"
14
14
  ],
15
- "version": "1.0.0-rc.39",
16
- "hash": "b91dfb9757d8789661d7b3137a6bfe2a8cb31c2e5dfc7ef60be3bde08b4f3788"
15
+ "version": "1.0.0-rc.40",
16
+ "hash": "477a4bd735059c583d91d0002281458e9c5876e9b61bd2787c61c98a9d71404a"
17
17
  },
18
18
  {
19
19
  "name": "presmium-animate",
@@ -545,7 +545,7 @@
545
545
  "references/team.md",
546
546
  "references/timeline.md"
547
547
  ],
548
- "version": "1.0.0-rc.39",
548
+ "version": "1.0.0-rc.40",
549
549
  "hash": "76dc5b50143b8134b36c010e5416033652071373500f214f4e7b1792af8a0c4a"
550
550
  },
551
551
  {
@@ -556,7 +556,7 @@
556
556
  "references/plugin.md",
557
557
  "references/testing.md"
558
558
  ],
559
- "version": "1.0.0-rc.39",
560
- "hash": "dc7affcbc93157f7595991a5a34810d733ac2060eecb408da2fba0e7ab3ea1c2"
559
+ "version": "1.0.0-rc.40",
560
+ "hash": "af8f48dbe9dbc5bd772fa3d6172ae9c9b96626fec2cd7933b4e08f7c5f154b75"
561
561
  }
562
562
  ]
@@ -4,6 +4,15 @@ How to write the narration (a spoken script for the presentation, not the readin
4
4
 
5
5
  `lecture.json` is the only content authority. Narrations contain typed text, pronunciation and cue nodes; steps name narration IDs. Read the installed kernel contract for exact fields. Captions, spoken text and alignments derive from the same narration structure. A transcript becomes authored text only through an explicit adopt action. Read a Whisper transcript before adopting it: `.en` models translate non-English speech into English; it invents "Thank you." over silence, so drop words that start inside a final silence (`silencedetect=noise=-35dB:d=0.6`); more than 20% `♪` or `�` tokens means it failed; Chinese can come back as one "word" per sentence, sometimes in Traditional characters for Simplified speech, so split it into phrases and spread the time by character count.
6
6
 
7
+ ## Watch a published lecture
8
+
9
+ A `?view=lecture` link with one track opens its player directly. Before Play, the player buffers the selected audio
10
+ and prepares its picture, including the scene and its images. Playback warms about 30 seconds ahead, selecting at
11
+ most four audio files for preload, and starts when the current clip has about two seconds buffered (or the rest of
12
+ a shorter clip) and the picture is ready. Loading or buffering holds the audio, picture and timeline together;
13
+ seeking prepares the target position through the same path. Check actual audible media, a later step and replay
14
+ after going back, rather than treating a moving time display as proof of sound.
15
+
7
16
  ## Open the saved version in the studio
8
17
 
9
18
  Use the document toolbar's presentation preview action after the authoring save is acknowledged. Preparation compiles the exact confirmed document and stays in the editor until compilation succeeds. Continue editing to cancel that transition; a late response must not take the author away from new input or another document. A compilation error leaves the document and draft intact with a readable failure.
@@ -301,6 +301,7 @@ export default function PmPoll({ question, choices }: {
301
301
  | `useStepScope()`, `useBlockStepRange()` | `scope.step(k)` is the absolute step of internal step k; `useStepState(useBlockStepRange())` is active while the block (within its parents) is shown: stop media and background work outside it |
302
302
  | `useStepTime({ until? })` | Milliseconds since the component's step began; `Infinity` when settled (stepped back, document view, reduced motion, after `until`, a slide that is not the current one). The lecture replay and video export drive it. Pause your animation library's timeline and seek to this time; never play by the page clock |
303
303
  | `useService(STEP_CLOCK)?.wait(promise)` | Register async preparation of a picture (loading a module, WebGL); the video export waits for it before each frame |
304
+ | `useService(STEP_CLOCK)?.registerPreparation?.(slide, prepare)` | Register bounded look-ahead preparation for a slide; return the unsubscribe function from the component's effect. `prepare(slides)` warms those pictures and waits for their registered work. Do not play media or advance a step while warming it. |
304
305
  | `usePrefersReducedMotion()` | When true, show the final state directly |
305
306
  | `useActions(elementRef, { name: (seeking) => ... }, { clear })` | Named actions: call the returned `run(name)` from buttons. A recorded lecture replays them, and the narration's ``{cue to=<block>}`click <name>` `` runs them; on a jump the host calls `clear` and replays in order. The look must be a function of the actions so far |
306
307
  | `useCursor()`, `useViewRole()`, `usePresentationMode()` | `{ slide, step }`; `'audience' \| 'presenter' \| 'reader'`; `'slides' \| 'document'`. The current step (`useHost().useStep()`, `useHost()` being the object behind these functions) is `Infinity` in the fully expanded document view: a component with internal steps may then give readers its own stepper; the look is a function of (section step, local step) |