@lincyaw/skills 1.0.0-rc.27 → 1.0.0-rc.29

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.27",
3
+ "version": "1.0.0-rc.29",
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.27"
39
+ "@lincyaw/kernel": "1.0.0-rc.29"
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.27",
16
- "hash": "a9a7cc79898219319a15a2f27aed28554be5f8537501e267cd82f98ca4a40bcc"
15
+ "version": "1.0.0-rc.29",
16
+ "hash": "22950e7d9094fbb2499247b6a22004241f9c27b254581b875e8ddd9f338df3ce"
17
17
  },
18
18
  {
19
19
  "name": "presmium-animate",
@@ -538,7 +538,7 @@
538
538
  "references/team.md",
539
539
  "references/timeline.md"
540
540
  ],
541
- "version": "1.0.0-rc.27",
541
+ "version": "1.0.0-rc.29",
542
542
  "hash": "ed13f5d387791909866a521e58e7a8695cd94f8d7de96a22af006f398beff94a"
543
543
  },
544
544
  {
@@ -549,7 +549,7 @@
549
549
  "references/plugin.md",
550
550
  "references/testing.md"
551
551
  ],
552
- "version": "1.0.0-rc.27",
552
+ "version": "1.0.0-rc.29",
553
553
  "hash": "9b3cab9683b45f11c631a19f916639ffb4c0f74c054c14baee24aa5655a35de4"
554
554
  }
555
555
  ]
@@ -1,6 +1,8 @@
1
1
  # Editing with the studio and an agent
2
2
 
3
- Install Presmium once with `pnpm add -g @lincyaw/presmium`; Studio is included. Run `presmium studio <workspace-or-document>`; open the complete address it prints. Editing and preview need no model. The document editor uses one native BlockNote editing surface across the whole document, including cross-block selection and native history/comments.
3
+ Install Presmium once with `pnpm add -g @lincyaw/presmium`; Studio is included. Run `presmium studio <workspace-or-document>`; open the complete address it prints. Editing and preview need no model. The document editor uses one native BlockNote editing surface across the whole document, including cross-block selection and native history/comments. An animation or chart preview's toolbar has Comment on step for the whole content block or one step.
4
+
5
+ In Studio, AI source edits use a private candidate workspace while the author keeps editing. A stale publication returns the current author source to the candidate; read it again and retry the intended change. Required review keeps candidate edits separate until acceptance; rejecting them preserves the author's saved content. Each published writing tool has its own version.
4
6
 
5
7
  Web and agents modify the same `lecture.json`. Read the current document version, submit semantic edits or a full JSON document using the workspace's document transaction API, and retain unsaved input on conflict. `baseDocumentVersion` is the authoring CAS version, not a runtime IR digest.
6
8
 
@@ -10,6 +10,8 @@ Text blocks contain structured `paragraph`, `heading`, `list`, `blockquote`, `co
10
10
 
11
11
  Authored IDs must not equal `page:<Section ID>` for an existing section: that exact ID is reserved for the section title's comment anchor. Referencing it in a comment `blockId` remains valid. Other `page:` IDs are ordinary IDs; do not rename them merely because of the prefix.
12
12
 
13
+ A comment anchor is either a text range (`from`/`to` text points with UTF-16 offsets) or a place `{ blockId, stepId? }` naming a block, optionally at one step of its section. A preview block's toolbar can comment on the whole block or one step; the step must belong to that block's section. If the step disappears the anchor keeps the block, and only a missing block leaves the thread unanchored.
14
+
13
15
  A step belongs to one section and has `visuals` and `narrationIds`; optional `inherits` refers to an earlier authored state. Omitted blocks are invisible. `visuals` explicitly name block visibility, a declared component state and optional state parameters. Arbitrary step selection must reconstruct the same state without playing earlier steps.
14
16
 
15
17
  Narrations are structured `text`, `pronunciation { display, spoken }` and `cue { id, action, target?, parameters? }` nodes. The target uses stable `blockId` and optional component element. Captions, spoken text and cue alignment derive from this one structure.