openplanr 2.5.0 → 2.6.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 (68) hide show
  1. package/CHANGELOG.md +7 -0
  2. package/lib/host-packages/adapter-registry.json +5 -5
  3. package/lib/host-packages/capability-map.json +1 -1
  4. package/lib/host-packages/claude/.claude-plugin/marketplace.json +2 -2
  5. package/lib/host-packages/claude/openplanr/.claude-plugin/plugin.json +1 -1
  6. package/lib/host-packages/claude/openplanr/.openplanr-content.json +46 -14
  7. package/lib/host-packages/claude/openplanr/skills/design/openplanr.skill.json +22 -0
  8. package/lib/host-packages/claude/openplanr/skills/design/scripts/design.mjs +69 -16
  9. package/lib/host-packages/claude/openplanr/skills/design/scripts/runtime/packages/design/templates/studio/enhancements.js +19 -2
  10. package/lib/host-packages/claude/openplanr/skills/design/scripts/runtime/packages/design/templates/studio/handoff-center.css +81 -0
  11. package/lib/host-packages/claude/openplanr/skills/design/scripts/runtime/packages/design/templates/studio/handoff-center.js +400 -0
  12. package/lib/host-packages/claude/openplanr/skills/design-loop/openplanr.skill.json +22 -0
  13. package/lib/host-packages/claude/openplanr/skills/design-loop/scripts/design.mjs +69 -16
  14. package/lib/host-packages/claude/openplanr/skills/design-loop/scripts/runtime/packages/design/templates/studio/enhancements.js +19 -2
  15. package/lib/host-packages/claude/openplanr/skills/design-loop/scripts/runtime/packages/design/templates/studio/handoff-center.css +81 -0
  16. package/lib/host-packages/claude/openplanr/skills/design-loop/scripts/runtime/packages/design/templates/studio/handoff-center.js +400 -0
  17. package/lib/host-packages/claude/openplanr/skills/design-review/openplanr.skill.json +22 -0
  18. package/lib/host-packages/claude/openplanr/skills/design-review/scripts/design.mjs +69 -16
  19. package/lib/host-packages/claude/openplanr/skills/design-review/scripts/runtime/packages/design/templates/studio/enhancements.js +19 -2
  20. package/lib/host-packages/claude/openplanr/skills/design-review/scripts/runtime/packages/design/templates/studio/handoff-center.css +81 -0
  21. package/lib/host-packages/claude/openplanr/skills/design-review/scripts/runtime/packages/design/templates/studio/handoff-center.js +400 -0
  22. package/lib/host-packages/claude/openplanr/skills/plan/openplanr.skill.json +22 -0
  23. package/lib/host-packages/claude/openplanr/skills/plan/scripts/design.mjs +69 -16
  24. package/lib/host-packages/claude/openplanr/skills/plan/scripts/runtime/packages/design/templates/studio/enhancements.js +19 -2
  25. package/lib/host-packages/claude/openplanr/skills/plan/scripts/runtime/packages/design/templates/studio/handoff-center.css +81 -0
  26. package/lib/host-packages/claude/openplanr/skills/plan/scripts/runtime/packages/design/templates/studio/handoff-center.js +400 -0
  27. package/lib/host-packages/cursor/openplanr/.openplanr-content.json +42 -10
  28. package/lib/host-packages/cursor/openplanr/manifest.json +1 -1
  29. package/lib/host-packages/cursor/openplanr/rules/planr-design/scripts/design.mjs +69 -16
  30. package/lib/host-packages/cursor/openplanr/rules/planr-design/scripts/runtime/packages/design/templates/studio/enhancements.js +19 -2
  31. package/lib/host-packages/cursor/openplanr/rules/planr-design/scripts/runtime/packages/design/templates/studio/handoff-center.css +81 -0
  32. package/lib/host-packages/cursor/openplanr/rules/planr-design/scripts/runtime/packages/design/templates/studio/handoff-center.js +400 -0
  33. package/lib/host-packages/cursor/openplanr/rules/planr-design-loop/scripts/design.mjs +69 -16
  34. package/lib/host-packages/cursor/openplanr/rules/planr-design-loop/scripts/runtime/packages/design/templates/studio/enhancements.js +19 -2
  35. package/lib/host-packages/cursor/openplanr/rules/planr-design-loop/scripts/runtime/packages/design/templates/studio/handoff-center.css +81 -0
  36. package/lib/host-packages/cursor/openplanr/rules/planr-design-loop/scripts/runtime/packages/design/templates/studio/handoff-center.js +400 -0
  37. package/lib/host-packages/cursor/openplanr/rules/planr-design-review/scripts/design.mjs +69 -16
  38. package/lib/host-packages/cursor/openplanr/rules/planr-design-review/scripts/runtime/packages/design/templates/studio/enhancements.js +19 -2
  39. package/lib/host-packages/cursor/openplanr/rules/planr-design-review/scripts/runtime/packages/design/templates/studio/handoff-center.css +81 -0
  40. package/lib/host-packages/cursor/openplanr/rules/planr-design-review/scripts/runtime/packages/design/templates/studio/handoff-center.js +400 -0
  41. package/lib/host-packages/cursor/openplanr/rules/planr-plan/scripts/design.mjs +69 -16
  42. package/lib/host-packages/cursor/openplanr/rules/planr-plan/scripts/runtime/packages/design/templates/studio/enhancements.js +19 -2
  43. package/lib/host-packages/cursor/openplanr/rules/planr-plan/scripts/runtime/packages/design/templates/studio/handoff-center.css +81 -0
  44. package/lib/host-packages/cursor/openplanr/rules/planr-plan/scripts/runtime/packages/design/templates/studio/handoff-center.js +400 -0
  45. package/lib/host-packages/openai/.claude-plugin/marketplace.json +2 -2
  46. package/lib/host-packages/openai/openplanr/.codex-plugin/plugin.json +1 -1
  47. package/lib/host-packages/openai/openplanr/.openplanr-content.json +46 -14
  48. package/lib/host-packages/openai/openplanr/skills/design/openplanr.skill.json +22 -0
  49. package/lib/host-packages/openai/openplanr/skills/design/scripts/design.mjs +69 -16
  50. package/lib/host-packages/openai/openplanr/skills/design/scripts/runtime/packages/design/templates/studio/enhancements.js +19 -2
  51. package/lib/host-packages/openai/openplanr/skills/design/scripts/runtime/packages/design/templates/studio/handoff-center.css +81 -0
  52. package/lib/host-packages/openai/openplanr/skills/design/scripts/runtime/packages/design/templates/studio/handoff-center.js +400 -0
  53. package/lib/host-packages/openai/openplanr/skills/design-loop/openplanr.skill.json +22 -0
  54. package/lib/host-packages/openai/openplanr/skills/design-loop/scripts/design.mjs +69 -16
  55. package/lib/host-packages/openai/openplanr/skills/design-loop/scripts/runtime/packages/design/templates/studio/enhancements.js +19 -2
  56. package/lib/host-packages/openai/openplanr/skills/design-loop/scripts/runtime/packages/design/templates/studio/handoff-center.css +81 -0
  57. package/lib/host-packages/openai/openplanr/skills/design-loop/scripts/runtime/packages/design/templates/studio/handoff-center.js +400 -0
  58. package/lib/host-packages/openai/openplanr/skills/design-review/openplanr.skill.json +22 -0
  59. package/lib/host-packages/openai/openplanr/skills/design-review/scripts/design.mjs +69 -16
  60. package/lib/host-packages/openai/openplanr/skills/design-review/scripts/runtime/packages/design/templates/studio/enhancements.js +19 -2
  61. package/lib/host-packages/openai/openplanr/skills/design-review/scripts/runtime/packages/design/templates/studio/handoff-center.css +81 -0
  62. package/lib/host-packages/openai/openplanr/skills/design-review/scripts/runtime/packages/design/templates/studio/handoff-center.js +400 -0
  63. package/lib/host-packages/openai/openplanr/skills/plan/openplanr.skill.json +22 -0
  64. package/lib/host-packages/openai/openplanr/skills/plan/scripts/design.mjs +69 -16
  65. package/lib/host-packages/openai/openplanr/skills/plan/scripts/runtime/packages/design/templates/studio/enhancements.js +19 -2
  66. package/lib/host-packages/openai/openplanr/skills/plan/scripts/runtime/packages/design/templates/studio/handoff-center.css +81 -0
  67. package/lib/host-packages/openai/openplanr/skills/plan/scripts/runtime/packages/design/templates/studio/handoff-center.js +400 -0
  68. package/package.json +2 -2
@@ -8,7 +8,7 @@
8
8
  "files": [
9
9
  {
10
10
  "path": "manifest.json",
11
- "digest": "sha256:d421dd3f039a7f74f572246e5c0a20ea7b3c92527b09f4f56552074c820c93ae"
11
+ "digest": "sha256:6522cb9c4125827f13984f1a0026907e9a2d60eee955a6981aeef62a6bc09ba9"
12
12
  },
13
13
  {
14
14
  "path": "rules/planr-artifact.mdc",
@@ -244,7 +244,7 @@
244
244
  },
245
245
  {
246
246
  "path": "rules/planr-design-loop/scripts/design.mjs",
247
- "digest": "sha256:4374afc1003a4869cc423a093950b5d192a63df314329ee0e30ea423d163560b"
247
+ "digest": "sha256:3fec9a1d47bc41c0caf4909a2c4b9d00205da630c015a46f6921caf2a4d7a2d2"
248
248
  },
249
249
  {
250
250
  "path": "rules/planr-design-loop/scripts/runtime/notices/entities.txt",
@@ -264,7 +264,15 @@
264
264
  },
265
265
  {
266
266
  "path": "rules/planr-design-loop/scripts/runtime/packages/design/templates/studio/enhancements.js",
267
- "digest": "sha256:8f2eea1ed15762799c999745ccfd8f340183ddb12c91fc8224e09ce7ca7e2c97"
267
+ "digest": "sha256:e967e9a622018a3bfdd52751ecfa6e842dbbf1922f573f3395a2bf29ca028589"
268
+ },
269
+ {
270
+ "path": "rules/planr-design-loop/scripts/runtime/packages/design/templates/studio/handoff-center.css",
271
+ "digest": "sha256:2f972f98d16723fd19989df349f6342e6eae951820e53ca84f310b433ef83b48"
272
+ },
273
+ {
274
+ "path": "rules/planr-design-loop/scripts/runtime/packages/design/templates/studio/handoff-center.js",
275
+ "digest": "sha256:012f648cf3936be649ac5f4935412a91489c8f90e076400dc19fbc6ebbf38b21"
268
276
  },
269
277
  {
270
278
  "path": "rules/planr-design-loop/scripts/runtime/packages/design/templates/studio/share.css",
@@ -420,7 +428,7 @@
420
428
  },
421
429
  {
422
430
  "path": "rules/planr-design-review/scripts/design.mjs",
423
- "digest": "sha256:4374afc1003a4869cc423a093950b5d192a63df314329ee0e30ea423d163560b"
431
+ "digest": "sha256:3fec9a1d47bc41c0caf4909a2c4b9d00205da630c015a46f6921caf2a4d7a2d2"
424
432
  },
425
433
  {
426
434
  "path": "rules/planr-design-review/scripts/runtime/notices/entities.txt",
@@ -440,7 +448,15 @@
440
448
  },
441
449
  {
442
450
  "path": "rules/planr-design-review/scripts/runtime/packages/design/templates/studio/enhancements.js",
443
- "digest": "sha256:8f2eea1ed15762799c999745ccfd8f340183ddb12c91fc8224e09ce7ca7e2c97"
451
+ "digest": "sha256:e967e9a622018a3bfdd52751ecfa6e842dbbf1922f573f3395a2bf29ca028589"
452
+ },
453
+ {
454
+ "path": "rules/planr-design-review/scripts/runtime/packages/design/templates/studio/handoff-center.css",
455
+ "digest": "sha256:2f972f98d16723fd19989df349f6342e6eae951820e53ca84f310b433ef83b48"
456
+ },
457
+ {
458
+ "path": "rules/planr-design-review/scripts/runtime/packages/design/templates/studio/handoff-center.js",
459
+ "digest": "sha256:012f648cf3936be649ac5f4935412a91489c8f90e076400dc19fbc6ebbf38b21"
444
460
  },
445
461
  {
446
462
  "path": "rules/planr-design-review/scripts/runtime/packages/design/templates/studio/share.css",
@@ -596,7 +612,7 @@
596
612
  },
597
613
  {
598
614
  "path": "rules/planr-design/scripts/design.mjs",
599
- "digest": "sha256:4374afc1003a4869cc423a093950b5d192a63df314329ee0e30ea423d163560b"
615
+ "digest": "sha256:3fec9a1d47bc41c0caf4909a2c4b9d00205da630c015a46f6921caf2a4d7a2d2"
600
616
  },
601
617
  {
602
618
  "path": "rules/planr-design/scripts/runtime/notices/entities.txt",
@@ -616,7 +632,15 @@
616
632
  },
617
633
  {
618
634
  "path": "rules/planr-design/scripts/runtime/packages/design/templates/studio/enhancements.js",
619
- "digest": "sha256:8f2eea1ed15762799c999745ccfd8f340183ddb12c91fc8224e09ce7ca7e2c97"
635
+ "digest": "sha256:e967e9a622018a3bfdd52751ecfa6e842dbbf1922f573f3395a2bf29ca028589"
636
+ },
637
+ {
638
+ "path": "rules/planr-design/scripts/runtime/packages/design/templates/studio/handoff-center.css",
639
+ "digest": "sha256:2f972f98d16723fd19989df349f6342e6eae951820e53ca84f310b433ef83b48"
640
+ },
641
+ {
642
+ "path": "rules/planr-design/scripts/runtime/packages/design/templates/studio/handoff-center.js",
643
+ "digest": "sha256:012f648cf3936be649ac5f4935412a91489c8f90e076400dc19fbc6ebbf38b21"
620
644
  },
621
645
  {
622
646
  "path": "rules/planr-design/scripts/runtime/packages/design/templates/studio/share.css",
@@ -804,7 +828,7 @@
804
828
  },
805
829
  {
806
830
  "path": "rules/planr-plan/scripts/design.mjs",
807
- "digest": "sha256:4374afc1003a4869cc423a093950b5d192a63df314329ee0e30ea423d163560b"
831
+ "digest": "sha256:3fec9a1d47bc41c0caf4909a2c4b9d00205da630c015a46f6921caf2a4d7a2d2"
808
832
  },
809
833
  {
810
834
  "path": "rules/planr-plan/scripts/planning-ids.mjs",
@@ -828,7 +852,15 @@
828
852
  },
829
853
  {
830
854
  "path": "rules/planr-plan/scripts/runtime/packages/design/templates/studio/enhancements.js",
831
- "digest": "sha256:8f2eea1ed15762799c999745ccfd8f340183ddb12c91fc8224e09ce7ca7e2c97"
855
+ "digest": "sha256:e967e9a622018a3bfdd52751ecfa6e842dbbf1922f573f3395a2bf29ca028589"
856
+ },
857
+ {
858
+ "path": "rules/planr-plan/scripts/runtime/packages/design/templates/studio/handoff-center.css",
859
+ "digest": "sha256:2f972f98d16723fd19989df349f6342e6eae951820e53ca84f310b433ef83b48"
860
+ },
861
+ {
862
+ "path": "rules/planr-plan/scripts/runtime/packages/design/templates/studio/handoff-center.js",
863
+ "digest": "sha256:012f648cf3936be649ac5f4935412a91489c8f90e076400dc19fbc6ebbf38b21"
832
864
  },
833
865
  {
834
866
  "path": "rules/planr-plan/scripts/runtime/packages/design/templates/studio/share.css",
@@ -1011,5 +1043,5 @@
1011
1043
  "digest": "sha256:6378ad3477e4be8b7e916c4249404c50cafecac1c70ffbf5a1a2fce195dfea16"
1012
1044
  }
1013
1045
  ],
1014
- "contentDigest": "sha256:503d63325361da770219c363855bc4070b690262d6af62a3c9f37704053743ec"
1046
+ "contentDigest": "sha256:1d01c89fc1f8cfc87f27126936ae0b7b39707a4da2c1ee1ad439728ded8f58ee"
1015
1047
  }
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "openplanr",
3
- "version": "2.5.0",
3
+ "version": "2.6.0",
4
4
  "ruleCount": 27,
5
5
  "rules": [
6
6
  "rules/planr-artifact.mdc",
@@ -3,7 +3,7 @@
3
3
  // packages/design/lib/design/utility.mjs
4
4
  import { spawn } from "node:child_process";
5
5
  import { existsSync as existsSync12, mkdirSync as mkdirSync9, readFileSync as readFileSync17, realpathSync as realpathSync7, writeFileSync as writeFileSync9 } from "node:fs";
6
- import { dirname as dirname14, join as join13, resolve as resolve7 } from "node:path";
6
+ import { dirname as dirname14, join as join13, resolve as resolve8 } from "node:path";
7
7
  import { fileURLToPath as fileURLToPath3 } from "node:url";
8
8
 
9
9
  // packages/design/lib/design/document.mjs
@@ -354,11 +354,11 @@ function createArtifactBridgeTools(document2, window2) {
354
354
  const outputWidth = Math.max(1, Math.round(width * scale)), outputHeight = Math.max(1, Math.round(height * scale));
355
355
  const svg = '<svg xmlns="http://www.w3.org/2000/svg" width="' + outputWidth + '" height="' + outputHeight + '" viewBox="0 0 ' + width + " " + height + '"><foreignObject width="' + width + '" height="' + height + '">' + markup + "</foreignObject></svg>";
356
356
  image = new Image();
357
- await new Promise((resolve8, reject) => {
357
+ await new Promise((resolve9, reject) => {
358
358
  const timer = setTimeout(() => reject(new Error("Thumbnail capture timed out.")), Math.max(1, deadline - Date.now()));
359
359
  image.onload = () => {
360
360
  clearTimeout(timer);
361
- resolve8();
361
+ resolve9();
362
362
  };
363
363
  image.onerror = () => {
364
364
  clearTimeout(timer);
@@ -13081,12 +13081,14 @@ ${shellMarkup}
13081
13081
  }
13082
13082
 
13083
13083
  // packages/design/lib/design/studio-render.mjs
13084
- var DESIGN_STUDIO_VERSION = "1.8.5";
13084
+ var DESIGN_STUDIO_VERSION = "1.9.0";
13085
13085
  var DESIGN_STUDIO_ASSETS = Object.freeze({
13086
13086
  style: "templates/studio/studio.css",
13087
13087
  runtime: "templates/studio/studio.js",
13088
13088
  enhancementsStyle: "templates/studio/enhancements.css",
13089
- enhancementsRuntime: "templates/studio/enhancements.js"
13089
+ enhancementsRuntime: "templates/studio/enhancements.js",
13090
+ handoffCenterStyle: "templates/studio/handoff-center.css",
13091
+ handoffCenterRuntime: "templates/studio/handoff-center.js"
13090
13092
  });
13091
13093
  function applyDesignStudioTheme(preference) {
13092
13094
  if (!preference) {
@@ -13543,8 +13545,8 @@ function renderDesignStudio(input = {}, options = {}) {
13543
13545
  return renderDesignStudioMarkup({ ...input, entries: input.entries ?? createDesignStudioEntries(input.document, input.envelope) }, {
13544
13546
  ...options,
13545
13547
  renderShell: renderArtifactShellDocument,
13546
- style: ["studio.css", "enhancements.css"].map((file) => readFileSync7(new URL(file, templateRoot), "utf8")).join("\n"),
13547
- runtime: renderDesignReviewExportSource() + "\n" + ["studio.js", "enhancements.js"].map((file) => readFileSync7(new URL(file, templateRoot), "utf8")).join("\n")
13548
+ style: ["studio.css", "enhancements.css", "handoff-center.css"].map((file) => readFileSync7(new URL(file, templateRoot), "utf8")).join("\n"),
13549
+ runtime: renderDesignReviewExportSource() + "\n" + ["studio.js", "enhancements.js", "handoff-center.js"].map((file) => readFileSync7(new URL(file, templateRoot), "utf8")).join("\n")
13548
13550
  });
13549
13551
  }
13550
13552
 
@@ -13827,7 +13829,7 @@ function designRendererRevision() {
13827
13829
  json({
13828
13830
  version: DESIGN_RENDERER_VERSION,
13829
13831
  stage: hash(stageRuntimeBytes()),
13830
- assets: ["studio.css", "studio.js", "enhancements.css", "enhancements.js"].filter((name) => existsSync3(new URL(`../../templates/studio/${name}`, new URL("./runtime/packages/design/lib/design/document.mjs", import.meta.url).href))).map(
13832
+ assets: ["studio.css", "studio.js", "enhancements.css", "enhancements.js", "handoff-center.css", "handoff-center.js"].filter((name) => existsSync3(new URL(`../../templates/studio/${name}`, new URL("./runtime/packages/design/lib/design/document.mjs", import.meta.url).href))).map(
13831
13833
  (name) => hash(
13832
13834
  readFileSync8(
13833
13835
  new URL(`../../templates/studio/${name}`, new URL("./runtime/packages/design/lib/design/document.mjs", import.meta.url).href)
@@ -13994,7 +13996,7 @@ ${errors.join("\n")}`);
13994
13996
 
13995
13997
  // packages/design/lib/design/review.mjs
13996
13998
  import { existsSync as existsSync11, readFileSync as readFileSync16 } from "node:fs";
13997
- import { dirname as dirname13, join as join12 } from "node:path";
13999
+ import { dirname as dirname13, join as join12, relative as relative4, resolve as resolve7 } from "node:path";
13998
14000
 
13999
14001
  // packages/artifact/lib/artifact/import.mjs
14000
14002
  import {
@@ -18363,6 +18365,52 @@ function currentImplementationBasis(file, env) {
18363
18365
  }
18364
18366
  };
18365
18367
  }
18368
+ function proposeImplementationPackage(file, env) {
18369
+ const current = currentDesign(file);
18370
+ const basis = currentImplementationBasis(file, env);
18371
+ const repository = projectRoot(current.root);
18372
+ const paths = [.../* @__PURE__ */ new Set([
18373
+ designSpecPath(current.root),
18374
+ ...(current.sourceFiles ?? []).map((path) => resolve7(current.root, path))
18375
+ ])].filter((path) => existsSync11(path));
18376
+ const sources = paths.map((path, index) => {
18377
+ const logicalPath2 = relative4(repository, path).replaceAll("\\", "/");
18378
+ const extension = logicalPath2.split(".").pop()?.toLowerCase();
18379
+ return {
18380
+ id: `SRC-${String(index + 1).padStart(3, "0")}`,
18381
+ kind: path === designSpecPath(current.root) ? "design-specification" : extension === "html" ? "screen" : ["css", "json"].includes(extension) ? "token" : "component",
18382
+ path: logicalPath2,
18383
+ revision: basis.sourceRevision,
18384
+ digest: `sha256:${hash(readFileSync16(path))}`
18385
+ };
18386
+ });
18387
+ const sourceByPath = new Map(sources.map((source) => [source.path, source.id]));
18388
+ const sourceId = (path) => sourceByPath.get(relative4(repository, resolve7(current.root, path)).replaceAll("\\", "/"));
18389
+ const selected = current.document.variants.find((variant) => variant.id === current.document.selectedVariant);
18390
+ const requirements = current.document.screens.map((screen) => {
18391
+ const authored = selected?.sources?.[screen.id] ?? screen.source;
18392
+ const refs = [authored?.html, ...authored?.styles ?? [], ...authored?.scripts ?? []].map(sourceId).filter(Boolean);
18393
+ return {
18394
+ kind: "behavior",
18395
+ statement: `${screen.title}: ${screen.description || "Implement the approved screen behavior and states."}`,
18396
+ sourceRefs: refs.length ? refs : [sources[0].id],
18397
+ verification: current.document.frames.map((frame) => `${screen.title} matches the approved ${frame.label} frame at ${frame.width} \xD7 ${frame.height}.`)
18398
+ };
18399
+ });
18400
+ const allRefs = sources.map((source) => source.id);
18401
+ requirements.push({
18402
+ kind: "accessibility",
18403
+ statement: "Preserve the approved interaction semantics, keyboard path, focus behavior and readable status communication.",
18404
+ sourceRefs: allRefs,
18405
+ verification: ["Keyboard-only use, visible focus, screen-reader labels and status announcements pass on every implemented screen."]
18406
+ });
18407
+ return {
18408
+ id: `${current.document.id}-implementation`,
18409
+ title: `${current.document.title} implementation package`,
18410
+ sources,
18411
+ requirements
18412
+ };
18413
+ }
18366
18414
  async function persistDesignTaste(current, state) {
18367
18415
  const path = join12(
18368
18416
  projectRoot(current.root),
@@ -18585,7 +18633,12 @@ ${renderArtifactParentRuntime({ ...options, adapterRuntimeUrl: `${base}api/desig
18585
18633
  const unlock = await acquireStartLock(join12(design.root, ".design/render.lock"));
18586
18634
  try {
18587
18635
  const root = dirname13(designSpecPath(design.root));
18588
- respond(res, 200, { ok: true, draft: readImplementationHandoffDraft(root), ...readImplementationHandoffLifecycle(root), approvalPreview: previewImplementationHandoffApproval(root) });
18636
+ let proposal = null;
18637
+ try {
18638
+ proposal = proposeImplementationPackage(file, env);
18639
+ } catch {
18640
+ }
18641
+ respond(res, 200, { ok: true, draft: readImplementationHandoffDraft(root), ...readImplementationHandoffLifecycle(root), approvalPreview: previewImplementationHandoffApproval(root), proposal });
18589
18642
  } finally {
18590
18643
  unlock();
18591
18644
  }
@@ -19066,7 +19119,7 @@ function verifyDesignDocument(file, report) {
19066
19119
  const images = (Array.isArray(report.screenshots) ? report.screenshots : []).filter((item2) => {
19067
19120
  const path = typeof item2 === "string" ? item2 : item2?.path;
19068
19121
  try {
19069
- return typeof path === "string" && isPng(readFileSync17(resolve7(path)));
19122
+ return typeof path === "string" && isPng(readFileSync17(resolve8(path)));
19070
19123
  } catch {
19071
19124
  return false;
19072
19125
  }
@@ -19095,14 +19148,14 @@ async function designUtility(argv, { stdout = (value) => process.stdout.write(`$
19095
19148
  flags[key] = ["json", "no-open"].includes(key) ? true : args[++i];
19096
19149
  }
19097
19150
  if (flags.view && !["canvas", "prototype", "walkthrough"].includes(flags.view)) throw new Error("View must be canvas, prototype, or walkthrough.");
19098
- const file = resolve7(input);
19151
+ const file = resolve8(input);
19099
19152
  let result;
19100
19153
  if (command === "handoff") {
19101
19154
  const action3 = flags.action ?? "inspect";
19102
19155
  if (action3 === "inspect") result = readDesignHandoff(file);
19103
19156
  else {
19104
19157
  const snapshot2 = readDesignHandoff(file);
19105
- const input2 = flags.input ? readJson2(resolve7(flags.input)) : {};
19158
+ const input2 = flags.input ? readJson2(resolve8(flags.input)) : {};
19106
19159
  result = await updateDesignHandoff(file, { ...input2, action: action3, revision: input2.revision ?? snapshot2.revision, version: input2.version ?? (snapshot2.draft?.version ?? 0) });
19107
19160
  }
19108
19161
  }
@@ -19137,7 +19190,7 @@ async function designUtility(argv, { stdout = (value) => process.stdout.write(`$
19137
19190
  const current = currentDesign(file), view = flags.view ?? current.document.defaultView;
19138
19191
  const state = readJson2(join13(current.root, ".design/studio-state.json"), { state: {} }).state;
19139
19192
  if (flags.format && flags.format !== "html") throw new Error("Portable export supports HTML. Use the studio PNG action for browser-rendered captures.");
19140
- const output = resolve7(flags.output ?? join13(current.root, `${view}-export.html`));
19193
+ const output = resolve8(flags.output ?? join13(current.root, `${view}-export.html`));
19141
19194
  if (existsSync12(output)) throw new Error(`Export already exists: ${output}. Choose a new --output path.`);
19142
19195
  mkdirSync9(dirname14(output), { recursive: true });
19143
19196
  writeFileSync9(output, standaloneDesignHtml({ ...current, state }, view), { flag: "wx" });
@@ -19145,7 +19198,7 @@ async function designUtility(argv, { stdout = (value) => process.stdout.write(`$
19145
19198
  }
19146
19199
  if (command === "verify") {
19147
19200
  if (!flags.report) throw new Error("verify requires --report <browser-report.json>.");
19148
- result = verifyDesignDocument(file, readJson2(resolve7(flags.report)));
19201
+ result = verifyDesignDocument(file, readJson2(resolve8(flags.report)));
19149
19202
  }
19150
19203
  if (command === "feedback") {
19151
19204
  await syncDesignShare(file, { env, fetchImpl });
@@ -19156,7 +19209,7 @@ async function designUtility(argv, { stdout = (value) => process.stdout.write(`$
19156
19209
  if (!["json", "markdown"].includes(format)) throw new Error("Feedback export format must be json or markdown.");
19157
19210
  if (!["current", "all"].includes(scope)) throw new Error("Feedback export scope must be current or all.");
19158
19211
  if (!flags.output) throw new Error("Feedback export requires --output <path>.");
19159
- const output = resolve7(flags.output);
19212
+ const output = resolve8(flags.output);
19160
19213
  if (existsSync12(output)) throw new Error("Feedback export already exists. Choose a new --output path.");
19161
19214
  const snapshot2 = exportDesignReview(file, { scope, env });
19162
19215
  mkdirSync9(dirname14(output), { recursive: true });
@@ -736,7 +736,7 @@
736
736
  await loadPair();
737
737
  } catch (error) { status.textContent = error.message; content.append(button('Retry comparison', () => compareRevisions(beforeId, afterId))); }
738
738
  }
739
- async function handoff() {
739
+ async function reviewHandoff() {
740
740
  const { content, status } = modal('Review handoff', 'design-handoff'); status.textContent = 'Loading review decisions…'; let response;
741
741
  const render = () => {
742
742
  content.replaceChildren(); const draft = response.draft;
@@ -766,7 +766,11 @@
766
766
  catch (error) { status.textContent = error.message; for (const [value,disabled] of previousDisabled) if (value.isConnected) value.disabled = disabled; }
767
767
  };
768
768
  try { response = await request('loadHandoff', 'handoffUrl'); if (response.metadata) metadata = response.metadata; render(); status.textContent = ''; }
769
- catch (error) { status.textContent = error.message; content.append(button('Retry', handoff)); }
769
+ catch (error) { status.textContent = error.message; content.append(button('Retry', reviewHandoff)); }
770
+ }
771
+ function handoff() {
772
+ if (window.__openPlanrDesignHandoffCenter?.open) return window.__openPlanrDesignHandoffCenter.open();
773
+ return reviewHandoff();
770
774
  }
771
775
  async function refreshExperience() {
772
776
  const previousContext = JSON.stringify(experience?.reviewContext || payload.reviewContext);
@@ -797,6 +801,19 @@
797
801
  on(document, 'openplanr:design-experience-changed', () => { void refreshExperience(); });
798
802
  const dispose = () => { disposed = true; activeDialog?.dismiss(); for (const remove of destroyers.splice(0)) remove(); clearTimeout(toastTimer); };
799
803
  on(window, 'pagehide', dispose); on(root, 'planr:design-destroy', dispose);
804
+ window.__openPlanrDesignHandoffBridge = Object.freeze({
805
+ owner,
806
+ revision,
807
+ announce,
808
+ openReviewHandoff: reviewHandoff,
809
+ loadReadiness: () => request('loadReadiness', 'readinessUrl'),
810
+ loadReviewHandoff: () => request('loadHandoff', 'handoffUrl'),
811
+ updateReviewHandoff: input => request('updateHandoff', 'handoffUrl', { ...input, revision: revision() }),
812
+ loadImplementationHandoff: () => request('loadImplementationHandoff', 'implementationHandoffUrl'),
813
+ updateImplementationHandoff: input => request('updateImplementationHandoff', 'implementationHandoffUrl', input),
814
+ continueToActiveHost: typeof options().continueToPlan === 'function' ? handoff => options().continueToPlan(handoff) : null,
815
+ context: () => ({ designId: design.id, title: design.title, revision: revision(), host: options().activeHost || options().host || '' }),
816
+ });
800
817
  window.__openPlanrDesignExperience = Object.freeze({ about, profile:editProfile, setTheme, history, compare: compareRevisions, handoff, refresh: refreshExperience, getState: () => ({ railTab, inspectorEnabled, profile:{...profile}, theme:themePreference, metadata: structuredClone(metadata) }) });
801
818
  }
802
819
  const started = Date.now();
@@ -0,0 +1,81 @@
1
+ .design-handoff-center {
2
+ position:absolute; z-index:42; inset:var(--planr-toolbar-height) 0 0 auto;
3
+ display:grid; grid-template-rows:auto auto minmax(0,1fr) auto;
4
+ box-sizing:border-box; width:var(--planr-review-rail-width); max-width:calc(100% - 16px);
5
+ border-left:1px solid var(--planr-color-rule); background:var(--planr-color-chrome);
6
+ color:var(--planr-color-text); box-shadow:-12px 0 32px #0004;
7
+ font:400 var(--design-type-body,14px)/1.5 var(--planr-font-body);
8
+ }
9
+ .design-handoff-center > header { display:flex; align-items:center; justify-content:space-between; gap:12px; min-height:64px; padding:12px 14px; border-bottom:1px solid var(--planr-color-rule); }
10
+ .design-handoff-center h2,.design-handoff-center h3,.design-handoff-center h4 { margin:0; font-family:var(--planr-font-display); }
11
+ .design-handoff-center h2 { font-size:18px; }
12
+ .design-handoff-center h3 { font-size:20px; letter-spacing:-.02em; }
13
+ .design-handoff-center h4 { font-size:14px; }
14
+ .design-handoff-center p { margin:0; overflow-wrap:anywhere; }
15
+ .design-handoff-eyebrow { display:block; color:var(--planr-color-primary); font-size:10px; font-weight:650; letter-spacing:.1em; text-transform:uppercase; }
16
+ .design-handoff-center button,.design-handoff-center input,.design-handoff-center textarea { box-sizing:border-box; font:inherit; }
17
+ .design-handoff-center button { min-height:36px; border:1px solid var(--planr-color-rule); border-radius:6px; padding:8px 10px; color:var(--planr-color-text); background:var(--planr-color-panel); cursor:pointer; }
18
+ .design-handoff-center button:disabled { cursor:wait; opacity:.55; }
19
+ .design-handoff-center button:focus-visible,.design-handoff-center input:focus-visible,.design-handoff-center textarea:focus-visible,.design-handoff-center summary:focus-visible { outline:2px solid var(--planr-color-primary); outline-offset:2px; }
20
+ .design-handoff-center .design-primary { width:100%; min-height:44px; color:var(--planr-color-background); background:var(--planr-color-primary); border-color:transparent; font-weight:650; }
21
+ .design-handoff-center .design-danger { width:100%; color:var(--planr-color-danger); }
22
+ .design-handoff-close { width:44px; height:44px; padding:0!important; background:transparent!important; font-size:22px!important; }
23
+ .design-handoff-progress { display:grid; grid-template-columns:repeat(5,minmax(0,1fr)); gap:2px; padding:8px; border-bottom:1px solid var(--planr-color-rule); overflow-x:auto; }
24
+ .design-handoff-step { display:grid; justify-items:center; gap:3px; min-width:52px; min-height:58px!important; padding:6px 3px!important; border-color:transparent!important; background:transparent!important; color:var(--planr-color-text-muted)!important; font-size:9px!important; line-height:1.2!important; text-align:center; }
25
+ .design-handoff-step > span:first-child { font:650 11px/1 var(--planr-font-body); }
26
+ .design-handoff-step[aria-current="step"] { color:var(--planr-color-text)!important; background:var(--planr-color-raised)!important; border-color:var(--planr-color-rule)!important; }
27
+ .design-handoff-badge { display:inline-flex; align-items:center; gap:4px; width:max-content; max-width:100%; border:1px solid var(--planr-color-rule); border-radius:999px; padding:2px 7px; color:var(--planr-color-text-muted); font-size:10px; font-weight:650; line-height:1.4; }
28
+ .design-handoff-badge::before { content:""; flex:none; width:6px; height:6px; border-radius:50%; background:currentColor; }
29
+ .design-handoff-badge[data-status="ready"],.design-handoff-badge[data-status="pass"],.design-handoff-badge[data-status="approved"] { color:var(--planr-color-primary); }
30
+ .design-handoff-badge[data-status="blocked"],.design-handoff-badge[data-status="revoked"] { color:var(--planr-color-danger); }
31
+ .design-handoff-badge[data-status="attention"],.design-handoff-badge[data-status="stale"],.design-handoff-badge[data-status="superseded"] { color:#d89a39; }
32
+ .design-handoff-step .design-handoff-badge { max-width:44px; overflow:hidden; padding:0; border:0; color:inherit; text-indent:-999px; }
33
+ .design-handoff-step .design-handoff-badge::before { width:7px; height:7px; }
34
+ .design-handoff-content { min-width:0; overflow:auto; overscroll-behavior:contain; padding:18px 14px 28px; }
35
+ .design-handoff-step-header { display:grid; gap:6px; margin-bottom:18px; }
36
+ .design-handoff-step-header p,.design-handoff-content .design-muted { color:var(--planr-color-text-muted); font-size:12px; }
37
+ .design-handoff-summary { display:grid; gap:10px; margin-bottom:16px; padding:12px; border:1px solid var(--planr-color-rule); border-radius:8px; background:var(--planr-color-raised); }
38
+ .design-handoff-summary strong { font-size:13px; line-height:1.45; }
39
+ .design-handoff-empty { display:grid; gap:7px; margin:12px 0 18px; padding:18px 14px; border:1px dashed var(--planr-color-rule); border-radius:8px; }
40
+ .design-handoff-empty p { color:var(--planr-color-text-muted); font-size:12px; }
41
+ .design-handoff-checks,.design-handoff-requirement-list { display:grid; gap:8px; margin:0 0 18px; padding:0; list-style:none; }
42
+ .design-handoff-checks li,.design-handoff-requirement-list li { display:grid; gap:8px; padding:10px; border:1px solid var(--planr-color-rule); border-radius:7px; }
43
+ .design-handoff-checks li > div { display:flex; align-items:flex-start; justify-content:space-between; gap:8px; }
44
+ .design-handoff-checks strong,.design-handoff-requirement-list strong { font-size:12px; line-height:1.45; }
45
+ .design-handoff-link { min-height:32px!important; padding:4px 0!important; border:0!important; background:transparent!important; color:var(--planr-color-primary)!important; text-align:left; }
46
+ .design-handoff-review-groups { display:grid; gap:10px; margin-bottom:18px; }
47
+ .design-handoff-review-group { display:grid; gap:7px; }
48
+ .design-handoff-review-group article { display:grid; gap:4px; padding:9px 10px; border-left:2px solid var(--planr-color-rule); background:var(--planr-color-panel); font-size:12px; }
49
+ .design-handoff-refinement { color:var(--planr-color-text-muted); }
50
+ .design-handoff-package-editor,.design-handoff-requirements,.design-handoff-package-editor fieldset { display:grid; gap:12px; min-width:0; }
51
+ .design-handoff-package-editor > label,.design-handoff-package-editor fieldset label,.design-handoff-content > label { display:grid; gap:6px; margin-bottom:14px; color:var(--planr-color-text-muted); font-size:12px; }
52
+ .design-handoff-package-editor input,.design-handoff-package-editor textarea,.design-handoff-content > label input,.design-handoff-plan-result textarea { width:100%; min-height:44px; border:1px solid var(--planr-color-rule); border-radius:6px; padding:9px 10px; color:var(--planr-color-text); background:var(--planr-color-panel); }
53
+ .design-handoff-package-editor textarea { min-height:82px; resize:vertical; }
54
+ .design-handoff-package-editor fieldset { margin:0; border:1px solid var(--planr-color-rule); border-radius:7px; padding:10px; }
55
+ .design-handoff-package-editor legend { padding:0 5px; color:var(--planr-color-text); font-size:11px; text-transform:capitalize; }
56
+ .design-handoff-content details { margin:14px 0; border-top:1px solid var(--planr-color-rule); padding-top:12px; }
57
+ .design-handoff-content summary { min-height:36px; cursor:pointer; color:var(--planr-color-text-muted); font-size:12px; }
58
+ .design-handoff-approval-card { display:grid; gap:9px; margin-bottom:18px; padding:16px; border:1px solid var(--planr-color-rule); border-radius:8px; background:var(--planr-color-raised); }
59
+ .design-handoff-plan-result { display:grid; gap:10px; margin-top:14px; }
60
+ .design-handoff-plan-result code { display:block; overflow:auto; border:1px solid var(--planr-color-rule); border-radius:6px; padding:10px; background:var(--planr-color-background); font-size:11px; white-space:pre; }
61
+ .design-handoff-copy { width:100%; }
62
+ .design-handoff-center > footer { display:flex; align-items:center; justify-content:space-between; gap:10px; min-height:50px; padding:8px 12px; border-top:1px solid var(--planr-color-rule); background:var(--planr-color-chrome); }
63
+ .design-handoff-center > footer p { flex:1; color:var(--planr-color-text-muted); font-size:10px; }
64
+ .design-handoff-center > footer p[data-error="true"] { color:var(--planr-color-danger); }
65
+ .design-handoff-center > footer button { flex:none; }
66
+ .planr-shell[data-design-handoff-open="true"] .planr-review-rail { visibility:hidden; pointer-events:none; }
67
+ @media (max-width:960px) {
68
+ .design-handoff-center { position:absolute; width:min(380px,calc(100% - 16px)); }
69
+ }
70
+ @media (max-width:680px) {
71
+ .design-handoff-center { inset:var(--planr-toolbar-height) 0 0; width:100%; max-width:none; border-left:0; }
72
+ .design-handoff-center button,.design-handoff-center input,.design-handoff-center textarea,.design-handoff-center summary { min-height:44px; }
73
+ .design-handoff-center input,.design-handoff-center textarea { font-size:16px; }
74
+ .design-handoff-progress { position:sticky; z-index:2; top:0; background:var(--planr-color-chrome); }
75
+ .design-handoff-content { padding-inline:16px; }
76
+ }
77
+ @media (prefers-reduced-motion:reduce) { .design-handoff-center * { scroll-behavior:auto!important; transition:none!important; animation:none!important; } }
78
+ @media (forced-colors:active) {
79
+ .design-handoff-center,.design-handoff-summary,.design-handoff-empty,.design-handoff-checks li,.design-handoff-requirement-list li { border-color:CanvasText; }
80
+ .design-handoff-badge::before { forced-color-adjust:none; background:currentColor; }
81
+ }