pi-pocket 0.25.0 → 0.26.0

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.
Files changed (85) hide show
  1. package/AGENTS.md +2 -0
  2. package/README.md +5 -3
  3. package/docs/architecture.md +21 -0
  4. package/docs/design/design-mode.md +108 -0
  5. package/docs/design/notes-a.md +106 -0
  6. package/docs/design/notes-b.md +123 -0
  7. package/docs/design/notes-c.md +92 -0
  8. package/docs/design/notes-d.md +78 -0
  9. package/docs/design/release-notes-design.md +46 -0
  10. package/docs/extensions/browser-modules.md +2 -0
  11. package/docs/extensions/policies/api-stability.md +2 -0
  12. package/docs/extensions/reference/api-versions.md +1 -0
  13. package/docs/extensions/reference/host.md +1 -1
  14. package/docs/extensions/reference/limits.md +4 -0
  15. package/docs/extensions/reference/names.md +2 -2
  16. package/docs/extensions/reference/pocket.md +38 -0
  17. package/docs/features.md +19 -5
  18. package/docs/map.md +75 -54
  19. package/docs/release-notes.md +1 -1
  20. package/docs/self-editing.md +1 -1
  21. package/docs/systemd.md +1 -1
  22. package/npm-shrinkwrap.json +2 -2
  23. package/package.json +1 -1
  24. package/src/launcher/main.ts +20 -9
  25. package/src/server/app.ts +113 -4
  26. package/src/server/background.ts +3 -3
  27. package/src/server/cache-keeper.ts +605 -0
  28. package/src/server/compaction.ts +68 -15
  29. package/src/server/design/bundle.ts +65 -0
  30. package/src/server/design/export.ts +118 -0
  31. package/src/server/design/files.ts +49 -0
  32. package/src/server/design/guide.ts +56 -0
  33. package/src/server/design/index.ts +232 -0
  34. package/src/server/design/pptx.ts +304 -0
  35. package/src/server/design/render.ts +593 -0
  36. package/src/server/design/system.ts +248 -0
  37. package/src/server/docs.ts +55 -0
  38. package/src/server/extensions/artifacts.ts +202 -18
  39. package/src/server/extensions/design/canvas.js +304 -0
  40. package/src/server/extensions/design/comments.js +15 -0
  41. package/src/server/extensions/design/data.js +263 -0
  42. package/src/server/extensions/design/devices.js +70 -0
  43. package/src/server/extensions/design/docks.js +647 -0
  44. package/src/server/extensions/design/edits.js +37 -0
  45. package/src/server/extensions/design/index.js +326 -0
  46. package/src/server/extensions/design/messages.js +92 -0
  47. package/src/server/extensions/design/parts.js +160 -0
  48. package/src/server/extensions/design/state.js +146 -0
  49. package/src/server/extensions/design/style.css +1332 -0
  50. package/src/server/extensions/design/tweaks.js +161 -0
  51. package/src/server/extensions/design/views.js +375 -0
  52. package/src/server/extensions/design/workspace.js +723 -0
  53. package/src/server/extensions/design.ts +620 -0
  54. package/src/server/extensions/plan.ts +11 -9
  55. package/src/server/extensions/prompt.ts +11 -3
  56. package/src/server/extensions/subagents.ts +7 -1
  57. package/src/server/extensions/updates/index.js +16 -6
  58. package/src/server/extensions/updates.ts +2 -2
  59. package/src/server/http/artifact-assets.ts +216 -0
  60. package/src/server/http/artifact-inspect.ts +1281 -0
  61. package/src/server/http/artifacts.ts +89 -14
  62. package/src/server/http/conversation-routes.ts +46 -1
  63. package/src/server/http.ts +12 -4
  64. package/src/server/main.ts +4 -0
  65. package/src/server/npm-install.ts +82 -0
  66. package/src/server/npm-update.ts +100 -0
  67. package/src/server/reload.ts +5 -0
  68. package/src/server/room.ts +2 -0
  69. package/src/server/spend.ts +73 -9
  70. package/src/server/update-state.ts +257 -8
  71. package/src/server/updates.ts +268 -33
  72. package/src/server/zip.ts +163 -0
  73. package/types/pocket.d.ts +32 -0
  74. package/web/activity-fold.js +28 -0
  75. package/web/artifact-bridge.js +506 -82
  76. package/web/extension-ui.js +21 -1
  77. package/web/pip.js +46 -9
  78. package/web/sessions.js +1 -1
  79. package/web/sheets/appearance.js +10 -0
  80. package/web/sheets/viewers.js +26 -1
  81. package/web/style.css +11 -0
  82. package/web/taps.js +26 -0
  83. package/web/theme.js +6 -0
  84. package/web/transcript.js +19 -10
  85. package/src/server/http/public.ts +0 -30
@@ -0,0 +1,304 @@
1
+ /** Image-backed PowerPoint decks with searchable speaker notes; widescreen by default. */
2
+ import { zip } from "../zip.ts";
3
+
4
+ const XML = '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>';
5
+ const P = "http://schemas.openxmlformats.org/presentationml/2006/main";
6
+ const A = "http://schemas.openxmlformats.org/drawingml/2006/main";
7
+ const R = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
8
+ const PACKAGE_R = "http://schemas.openxmlformats.org/package/2006/relationships";
9
+ const CONTENT_TYPES = "http://schemas.openxmlformats.org/package/2006/content-types";
10
+ const MIME = "application/vnd.openxmlformats-officedocument.presentationml.";
11
+ const WIDTH = 12192000;
12
+ const NS = `xmlns:p="${P}" xmlns:a="${A}" xmlns:r="${R}"`;
13
+ const COLOR_MAP =
14
+ 'accent1="accent1" accent2="accent2" accent3="accent3" accent4="accent4" accent5="accent5" accent6="accent6" bg1="lt1" bg2="lt2" folHlink="folHlink" hlink="hlink" tx1="dk1" tx2="dk2"';
15
+
16
+ /** Remove characters XML 1.0 cannot represent, then escape markup. */
17
+ function escapeXml(text: string): string {
18
+ return text
19
+ .replace(/[^\u0009\u000a\u000d\u0020-\ud7ff\ue000-\ufffd\u{10000}-\u{10ffff}]/gu, "")
20
+ .replace(/&/g, "&amp;")
21
+ .replace(/</g, "&lt;")
22
+ .replace(/>/g, "&gt;")
23
+ .replace(/"/g, "&quot;")
24
+ .replace(/'/g, "&apos;");
25
+ }
26
+
27
+ function relationships(items: [id: string, kind: string, target: string][]): string {
28
+ return `<Relationships xmlns="${PACKAGE_R}">${items
29
+ .map(
30
+ ([id, kind, target]) =>
31
+ `<Relationship Id="${id}" Type="${R}/${kind}" Target="${target}"/>`,
32
+ )
33
+ .join("")}</Relationships>`;
34
+ }
35
+
36
+ function shapeTree(shapes = ""): string {
37
+ return `<p:spTree>
38
+ <p:nvGrpSpPr><p:cNvPr id="1" name=""/><p:cNvGrpSpPr/><p:nvPr/></p:nvGrpSpPr>
39
+ <p:grpSpPr><a:xfrm>
40
+ <a:off x="0" y="0"/><a:ext cx="0" cy="0"/>
41
+ <a:chOff x="0" y="0"/><a:chExt cx="0" cy="0"/>
42
+ </a:xfrm></p:grpSpPr>${shapes}
43
+ </p:spTree>`;
44
+ }
45
+
46
+ function notesShapes(text: string): string {
47
+ const paragraphs = text
48
+ .split(/\r\n|\r|\n/)
49
+ .map(
50
+ (line) => `<a:p><a:r><a:rPr lang="en-US"/>
51
+ <a:t xml:space="preserve">${escapeXml(line)}</a:t>
52
+ </a:r><a:endParaRPr lang="en-US"/></a:p>`,
53
+ )
54
+ .join("");
55
+
56
+ return shapeTree(`<p:sp>
57
+ <p:nvSpPr><p:cNvPr id="2" name="Slide Image"/>
58
+ <p:cNvSpPr><a:spLocks noGrp="1" noRot="1" noChangeAspect="1"/></p:cNvSpPr>
59
+ <p:nvPr><p:ph type="sldImg" idx="2"/></p:nvPr>
60
+ </p:nvSpPr>
61
+ <p:spPr><a:xfrm><a:off x="685800" y="1143000"/>
62
+ <a:ext cx="5486400" cy="3086100"/></a:xfrm>
63
+ <a:prstGeom prst="rect"><a:avLst/></a:prstGeom>
64
+ </p:spPr>
65
+ </p:sp><p:sp>
66
+ <p:nvSpPr><p:cNvPr id="3" name="Notes"/><p:cNvSpPr/>
67
+ <p:nvPr><p:ph type="body" idx="3"/></p:nvPr>
68
+ </p:nvSpPr>
69
+ <p:spPr><a:xfrm><a:off x="685800" y="4457700"/>
70
+ <a:ext cx="5486400" cy="3771900"/></a:xfrm>
71
+ </p:spPr>
72
+ <p:txBody><a:bodyPr/><a:lstStyle/>${paragraphs}</p:txBody>
73
+ </p:sp>`);
74
+ }
75
+
76
+ function theme(): string {
77
+ const colors = [
78
+ ["dk1", "000000"],
79
+ ["lt1", "FFFFFF"],
80
+ ["dk2", "1F2937"],
81
+ ["lt2", "F3F4F6"],
82
+ ["accent1", "2563EB"],
83
+ ["accent2", "16A34A"],
84
+ ["accent3", "9333EA"],
85
+ ["accent4", "EA580C"],
86
+ ["accent5", "0891B2"],
87
+ ["accent6", "DB2777"],
88
+ ["hlink", "0000FF"],
89
+ ["folHlink", "800080"],
90
+ ];
91
+ const fill = '<a:solidFill><a:schemeClr val="phClr"/></a:solidFill>';
92
+ const font = '<a:latin typeface="Arial"/><a:ea typeface=""/><a:cs typeface=""/>';
93
+
94
+ return `<a:theme xmlns:a="${A}" name="Pi Pocket">
95
+ <a:themeElements>
96
+ <a:clrScheme name="Pi Pocket">${colors
97
+ .map(([name, color]) => `<a:${name}><a:srgbClr val="${color}"/></a:${name}>`)
98
+ .join("")}</a:clrScheme>
99
+ <a:fontScheme name="Pi Pocket">
100
+ <a:majorFont>${font}</a:majorFont><a:minorFont>${font}</a:minorFont>
101
+ </a:fontScheme>
102
+ <a:fmtScheme name="Pi Pocket">
103
+ <a:fillStyleLst>${fill.repeat(3)}</a:fillStyleLst>
104
+ <a:lnStyleLst>${[6350, 12700, 19050]
105
+ .map((width) => `<a:ln w="${width}">${fill}<a:prstDash val="solid"/></a:ln>`)
106
+ .join("")}</a:lnStyleLst>
107
+ <a:effectStyleLst>${"<a:effectStyle><a:effectLst/></a:effectStyle>".repeat(3)}</a:effectStyleLst>
108
+ <a:bgFillStyleLst>${fill.repeat(3)}</a:bgFillStyleLst>
109
+ </a:fmtScheme>
110
+ </a:themeElements>
111
+ </a:theme>`;
112
+ }
113
+
114
+ function imageType(image: Buffer): "png" | "jpeg" {
115
+ if (image.subarray(0, 8).equals(Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]))) {
116
+ return "png";
117
+ }
118
+
119
+ if (image.length >= 3 && image[0] === 0xff && image[1] === 0xd8 && image[2] === 0xff) {
120
+ return "jpeg";
121
+ }
122
+
123
+ throw new Error("PPTX slide images must be PNG or JPEG buffers.");
124
+ }
125
+
126
+ /** Create an OPC PowerPoint ZIP. Each image fills a slide at the given aspect ratio; text goes in its notes. */
127
+ export function pptx(
128
+ slides: { image: Buffer; text: string }[],
129
+ size: { width: number; height: number } = { width: 16, height: 9 },
130
+ ): Buffer {
131
+ const scale = Math.min(WIDTH / size.width, WIDTH / size.height);
132
+ const width = Math.round(size.width * scale);
133
+ const height = Math.round(size.height * scale);
134
+
135
+ if (
136
+ size.width <= 0 ||
137
+ size.height <= 0 ||
138
+ !Number.isFinite(width) ||
139
+ !Number.isFinite(height) ||
140
+ width < 914400 ||
141
+ height < 914400
142
+ ) {
143
+ throw new Error("PPTX slide dimensions need a finite, supported aspect ratio.");
144
+ }
145
+
146
+ const entries: { name: string; bytes: Buffer }[] = [];
147
+ const overrides: string[] = [];
148
+ const imageTypes = new Set<string>();
149
+
150
+ const addXml = (name: string, body: string, contentType?: string) => {
151
+ entries.push({ name, bytes: Buffer.from(XML + body, "utf8") });
152
+
153
+ if (contentType) {
154
+ overrides.push(`<Override PartName="/${name}" ContentType="${contentType}"/>`);
155
+ }
156
+ };
157
+
158
+ const addPart = (name: string, body: string, kind: string) =>
159
+ addXml(name, body, `${MIME}${kind}+xml`);
160
+
161
+ addXml(
162
+ "_rels/.rels",
163
+ `<Relationships xmlns="${PACKAGE_R}">
164
+ <Relationship Id="rId1" Type="${R}/officeDocument" Target="ppt/presentation.xml"/>
165
+ <Relationship Id="rId2" Type="http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties" Target="docProps/core.xml"/>
166
+ <Relationship Id="rId3" Type="${R}/extended-properties" Target="docProps/app.xml"/>
167
+ </Relationships>`,
168
+ );
169
+ addXml(
170
+ "docProps/core.xml",
171
+ '<cp:coreProperties xmlns:cp="http://schemas.openxmlformats.org/package/2006/metadata/core-properties" xmlns:dc="http://purl.org/dc/elements/1.1/"><dc:creator>Pi Pocket</dc:creator></cp:coreProperties>',
172
+ "application/vnd.openxmlformats-package.core-properties+xml",
173
+ );
174
+ addXml(
175
+ "docProps/app.xml",
176
+ `<Properties xmlns="http://schemas.openxmlformats.org/officeDocument/2006/extended-properties">
177
+ <Application>Pi Pocket</Application><PresentationFormat>On-screen Show (16:9)</PresentationFormat>
178
+ <Slides>${slides.length}</Slides><Notes>${slides.length}</Notes>
179
+ </Properties>`,
180
+ "application/vnd.openxmlformats-officedocument.extended-properties+xml",
181
+ );
182
+ addPart(
183
+ "ppt/presentation.xml",
184
+ `<p:presentation ${NS}>
185
+ <p:sldMasterIdLst><p:sldMasterId id="2147483648" r:id="rId1"/></p:sldMasterIdLst>
186
+ <p:notesMasterIdLst><p:notesMasterId r:id="rId2"/></p:notesMasterIdLst>
187
+ ${slides.length ? `<p:sldIdLst>${slides.map((_, i) => `<p:sldId id="${256 + i}" r:id="rId${3 + i}"/>`).join("")}</p:sldIdLst>` : ""}
188
+ <p:sldSz cx="${width}" cy="${height}" type="${size.width * 9 === size.height * 16 ? "screen16x9" : "custom"}"/>
189
+ <p:notesSz cx="6858000" cy="9144000"/>
190
+ </p:presentation>`,
191
+ "presentation.main",
192
+ );
193
+ addXml(
194
+ "ppt/_rels/presentation.xml.rels",
195
+ relationships([
196
+ ["rId1", "slideMaster", "slideMasters/slideMaster1.xml"],
197
+ ["rId2", "notesMaster", "notesMasters/notesMaster1.xml"],
198
+ ...slides.map((_, i): [string, string, string] => [
199
+ `rId${3 + i}`,
200
+ "slide",
201
+ `slides/slide${i + 1}.xml`,
202
+ ]),
203
+ ]),
204
+ );
205
+ addPart(
206
+ "ppt/slideMasters/slideMaster1.xml",
207
+ `<p:sldMaster ${NS}>
208
+ <p:cSld name="Blank">${shapeTree()}</p:cSld><p:clrMap ${COLOR_MAP}/>
209
+ <p:sldLayoutIdLst><p:sldLayoutId id="2147483649" r:id="rId1"/></p:sldLayoutIdLst>
210
+ <p:txStyles><p:titleStyle/><p:bodyStyle/><p:otherStyle/></p:txStyles>
211
+ </p:sldMaster>`,
212
+ "slideMaster",
213
+ );
214
+ addXml(
215
+ "ppt/slideMasters/_rels/slideMaster1.xml.rels",
216
+ relationships([
217
+ ["rId1", "slideLayout", "../slideLayouts/slideLayout1.xml"],
218
+ ["rId2", "theme", "../theme/theme1.xml"],
219
+ ]),
220
+ );
221
+ addPart(
222
+ "ppt/slideLayouts/slideLayout1.xml",
223
+ `<p:sldLayout ${NS} type="blank" preserve="1">
224
+ <p:cSld name="Blank">${shapeTree()}</p:cSld>
225
+ <p:clrMapOvr><a:masterClrMapping/></p:clrMapOvr>
226
+ </p:sldLayout>`,
227
+ "slideLayout",
228
+ );
229
+ addXml(
230
+ "ppt/slideLayouts/_rels/slideLayout1.xml.rels",
231
+ relationships([["rId1", "slideMaster", "../slideMasters/slideMaster1.xml"]]),
232
+ );
233
+ addXml(
234
+ "ppt/theme/theme1.xml",
235
+ theme(),
236
+ "application/vnd.openxmlformats-officedocument.theme+xml",
237
+ );
238
+ addPart(
239
+ "ppt/notesMasters/notesMaster1.xml",
240
+ `<p:notesMaster ${NS}><p:cSld>${notesShapes("")}</p:cSld>
241
+ <p:clrMap ${COLOR_MAP}/><p:notesStyle/>
242
+ </p:notesMaster>`,
243
+ "notesMaster",
244
+ );
245
+ addXml(
246
+ "ppt/notesMasters/_rels/notesMaster1.xml.rels",
247
+ relationships([["rId1", "theme", "../theme/theme1.xml"]]),
248
+ );
249
+
250
+ slides.forEach(({ image, text }, i) => {
251
+ const n = i + 1;
252
+ const extension = imageType(image);
253
+ const imageName = `image${n}.${extension}`;
254
+
255
+ imageTypes.add(extension);
256
+ entries.push({ name: `ppt/media/${imageName}`, bytes: image });
257
+ addPart(
258
+ `ppt/slides/slide${n}.xml`,
259
+ `<p:sld ${NS}><p:cSld>${shapeTree(`<p:pic>
260
+ <p:nvPicPr><p:cNvPr id="2" name="Slide ${n}"/>
261
+ <p:cNvPicPr><a:picLocks noChangeAspect="1"/></p:cNvPicPr><p:nvPr/>
262
+ </p:nvPicPr>
263
+ <p:blipFill><a:blip r:embed="rId2"/><a:stretch><a:fillRect/></a:stretch></p:blipFill>
264
+ <p:spPr><a:xfrm><a:off x="0" y="0"/><a:ext cx="${width}" cy="${height}"/></a:xfrm>
265
+ <a:prstGeom prst="rect"><a:avLst/></a:prstGeom>
266
+ </p:spPr>
267
+ </p:pic>`)}</p:cSld><p:clrMapOvr><a:masterClrMapping/></p:clrMapOvr></p:sld>`,
268
+ "slide",
269
+ );
270
+ addXml(
271
+ `ppt/slides/_rels/slide${n}.xml.rels`,
272
+ relationships([
273
+ ["rId1", "slideLayout", "../slideLayouts/slideLayout1.xml"],
274
+ ["rId2", "image", `../media/${imageName}`],
275
+ ["rId3", "notesSlide", `../notesSlides/notesSlide${n}.xml`],
276
+ ]),
277
+ );
278
+ addPart(
279
+ `ppt/notesSlides/notesSlide${n}.xml`,
280
+ `<p:notes ${NS}><p:cSld>${notesShapes(text)}</p:cSld>
281
+ <p:clrMapOvr><a:masterClrMapping/></p:clrMapOvr>
282
+ </p:notes>`,
283
+ "notesSlide",
284
+ );
285
+ addXml(
286
+ `ppt/notesSlides/_rels/notesSlide${n}.xml.rels`,
287
+ relationships([
288
+ ["rId1", "notesMaster", "../notesMasters/notesMaster1.xml"],
289
+ ["rId2", "slide", `../slides/slide${n}.xml`],
290
+ ]),
291
+ );
292
+ });
293
+ addXml(
294
+ "[Content_Types].xml",
295
+ `<Types xmlns="${CONTENT_TYPES}">
296
+ <Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/>
297
+ <Default Extension="xml" ContentType="application/xml"/>
298
+ ${[...imageTypes].map((extension) => `<Default Extension="${extension}" ContentType="image/${extension}"/>`).join("")}
299
+ ${overrides.join("")}
300
+ </Types>`,
301
+ );
302
+
303
+ return zip(entries);
304
+ }