@penpair/web 0.3.7 → 0.4.1

package/examples/design-release-maps/journey.json

@@ -0,0 +1,187 @@
+{
+  "schemaVersion": 1,
+  "kind": "journey-map",
+  "id": "reset-password-journey",
+  "title": "Reset password",
+  "goal": "Request password-reset instructions and understand the next step.",
+  "sources": [
+    {
+      "id": "sample-brief",
+      "kind": "other",
+      "path": "examples/design-release-maps/sample-source.md",
+      "sha256": "ab97f0a30f066e9a9f2689d1624608ea91287751cbc6a613542c0e97de187a96"
+    }
+  ],
+  "nodes": [
+    {
+      "id": "address-entry",
+      "label": "Enter email",
+      "kind": "screen",
+      "origin": "observed",
+      "sourceIds": [
+        "sample-brief"
+      ],
+      "requirementIds": [
+        "reset-entry"
+      ],
+      "summary": "Provide an address for reset instructions.",
+      "description": "The synthetic brief includes an address-entry screen. No Penpot frame or application has been inspected. Field validation, submission behavior and the final wording still require project evidence or review.",
+      "icon": "screen"
+    },
+    {
+      "id": "confirmation",
+      "label": "Check your email",
+      "kind": "screen",
+      "origin": "observed",
+      "sourceIds": [
+        "sample-brief"
+      ],
+      "requirementIds": [
+        "reset-confirmation"
+      ],
+      "summary": "Explain the next step after the request.",
+      "description": "The synthetic brief includes a confirmation screen. Its success transition and response messaging are proposed, not observed. Confirm the actual request and account-disclosure policy before implementing this state.",
+      "icon": "screen"
+    },
+    {
+      "id": "recoverable-error",
+      "label": "Retry request",
+      "kind": "state",
+      "origin": "proposed",
+      "requirementIds": [
+        "reset-error-retry"
+      ],
+      "summary": "Keep the address and offer a retry.",
+      "description": "Proposed recovery preserves the entered address after a failed request, explains the failure and allows another attempt. No inspected design or implementation establishes this behavior yet. Review it, then verify a real failure and retry.",
+      "icon": "action"
+    },
+    {
+      "id": "expiry-policy",
+      "label": "Request policy",
+      "kind": "decision",
+      "origin": "unknown",
+      "requirementIds": [
+        "reset-expiry"
+      ],
+      "summary": "Decide expiry and repeat-request behavior.",
+      "description": "The source provides no expiry, repeat-request or disclosure policy. Obtain the actual product and service contract before deciding what the interface should say or do. This is an unresolved requirement, not an inferred security rule.",
+      "icon": "decision"
+    },
+    {
+      "id": "focus-recovery",
+      "label": "Accessible recovery",
+      "kind": "behavior",
+      "origin": "proposed",
+      "requirementIds": [
+        "reset-focus"
+      ],
+      "summary": "Announce errors and guide keyboard focus.",
+      "description": "Proposed accessible recovery should explain failures to screen-reader users and support keyboard correction and retry. Exact focus destinations, announcement behavior and implementation checks remain to be defined and tested.",
+      "icon": "check"
+    }
+  ],
+  "edges": [
+    {
+      "id": "request-success",
+      "from": "address-entry",
+      "to": "confirmation",
+      "label": "Success",
+      "origin": "proposed",
+      "requirementIds": [
+        "reset-confirmation"
+      ]
+    },
+    {
+      "id": "request-failure",
+      "from": "address-entry",
+      "to": "recoverable-error",
+      "label": "Failure",
+      "origin": "proposed",
+      "requirementIds": [
+        "reset-error-retry"
+      ]
+    },
+    {
+      "id": "retry",
+      "from": "recoverable-error",
+      "to": "address-entry",
+      "label": "Retry",
+      "origin": "proposed",
+      "requirementIds": [
+        "reset-error-retry"
+      ]
+    },
+    {
+      "id": "expiry-decision",
+      "from": "address-entry",
+      "to": "expiry-policy",
+      "label": "Resolve policy",
+      "origin": "unknown",
+      "requirementIds": [
+        "reset-expiry"
+      ]
+    },
+    {
+      "id": "focus-requirement",
+      "from": "recoverable-error",
+      "to": "focus-recovery",
+      "label": "Accessible feedback",
+      "origin": "proposed",
+      "requirementIds": [
+        "reset-focus"
+      ]
+    }
+  ],
+  "requirements": [
+    {
+      "id": "reset-entry",
+      "text": "The synthetic source includes an address-entry screen.",
+      "origin": "observed",
+      "sourceIds": [
+        "sample-brief"
+      ]
+    },
+    {
+      "id": "reset-confirmation",
+      "text": "The synthetic source includes a confirmation screen; its actual transition is proposed.",
+      "origin": "observed",
+      "sourceIds": [
+        "sample-brief"
+      ]
+    },
+    {
+      "id": "reset-error-retry",
+      "text": "Proposed: preserve the entered address after a failed request and allow retry.",
+      "origin": "proposed"
+    },
+    {
+      "id": "reset-expiry",
+      "text": "Unknown: expiry policy and treatment of repeated requests require a product/security decision.",
+      "origin": "unknown"
+    },
+    {
+      "id": "reset-focus",
+      "text": "Proposed: focus and announced errors must support keyboard and screen-reader recovery.",
+      "origin": "proposed"
+    }
+  ],
+  "findings": [
+    {
+      "id": "decide-request-contract",
+      "message": "No actual API contract or account-disclosure policy has been supplied.",
+      "severity": "blocking",
+      "status": "open"
+    },
+    {
+      "id": "design-error-state",
+      "message": "Recovery and accessible error presentation are proposals; no inspected frame supports them.",
+      "severity": "warning",
+      "status": "open"
+    }
+  ],
+  "presentation": {
+    "fontFamily": "Inter"
+  },
+  "summary": "Request reset instructions and recover from failure.",
+  "description": "This unapproved planning fixture is grounded only in the synthetic brief. It illustrates the proposed reset flow without claiming inspected Penpot frames, actual application behavior or owner agreement. Request policy, recovery and accessibility behavior remain explicit decisions and verification work."
+}

package/examples/design-release-maps/sample-source.md

@@ -0,0 +1,8 @@
+# Synthetic reset-password source
+
+This is illustrative fixture text, not a Penpot inspection or approved product
+requirement. It supplies reproducible local source bytes for the map examples.
+
+The sample includes an address-entry screen and a confirmation screen.
+The intended user goal is to request password-reset instructions.
+No API, expiry policy, error recovery or focus behavior is established here.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@penpair/web",
-  "version": "0.3.7",
+  "version": "0.4.1",
   "description": "The penpair command for Penpot on the web (design.penpot.app or your team's own): guided setup, a safe write protocol, skills for AI agents. Includes everything in @penpair/core.",
   "license": "MIT",
   "repository": {
@@ -48,7 +48,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@penpair/core": "0.3.7"
+    "@penpair/core": "0.4.1"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",