@econ-v1/ports 7.0.8 → 7.0.9

package/dist/clipboard.d.ts

@@ -34,8 +34,20 @@
  * adapter, or any caller — it is a secret in the invitation-code call site (see
  * `identify-invitation.ts`'s own security note) and must flow straight from the browser API
  * into the caller's live `<input>.value`, nowhere else.
+ * `writeText()` is the mirror image and obeys the same never-reject rule, resolving `false`
+ * on ANY failure — no Clipboard API, no write permission, an insecure context, or the write
+ * itself rejecting. It backs the profile node card's copyable identity and build values
+ * (`stages/profile/behavior/profile.js` emits `nodeos:profile-about-copy`; `app-shell.js`'s
+ * `#onProfileAboutCopy` does the writing), which is why a write seam exists here at all: the
+ * design drop is forbidden to touch a platform API, so the host owns the clipboard call.
+ * A boolean rather than `void` so a caller that wants to confirm the copy can, without any
+ * caller being forced to; nothing may throw at a call site whose only job is a copy button.
+ *
+ * The written text is subject to the same never-retained rule as the read text: it flows from
+ * the caller into the browser API and is held nowhere else.
  */
 export type ClipboardPort = {
     readText: () => Promise<string | undefined>;
+    writeText: (text: string) => Promise<boolean>;
 };
 //# sourceMappingURL=clipboard.d.ts.map

package/dist/clipboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../src/clipboard.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAuCc,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC"}
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../src/clipboard.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAkDc,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;eACjC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@econ-v1/ports",
-  "version": "7.0.8",
+  "version": "7.0.9",
   "description": "Platform-neutral ports for Node client applications",
   "license": "MIT OR Apache-2.0",
   "author": "Node contributors",

package/src/clipboard.js

@@ -36,6 +36,18 @@ export {};
  * adapter, or any caller — it is a secret in the invitation-code call site (see
  * `identify-invitation.ts`'s own security note) and must flow straight from the browser API
  * into the caller's live `<input>.value`, nowhere else.
+ * `writeText()` is the mirror image and obeys the same never-reject rule, resolving `false`
+ * on ANY failure — no Clipboard API, no write permission, an insecure context, or the write
+ * itself rejecting. It backs the profile node card's copyable identity and build values
+ * (`stages/profile/behavior/profile.js` emits `nodeos:profile-about-copy`; `app-shell.js`'s
+ * `#onProfileAboutCopy` does the writing), which is why a write seam exists here at all: the
+ * design drop is forbidden to touch a platform API, so the host owns the clipboard call.
+ * A boolean rather than `void` so a caller that wants to confirm the copy can, without any
+ * caller being forced to; nothing may throw at a call site whose only job is a copy button.
+ *
+ * The written text is subject to the same never-retained rule as the read text: it flows from
+ * the caller into the browser API and is held nowhere else.
  * @typedef {object} ClipboardPort
  * @property {() => Promise<string | undefined>} readText
+ * @property {(text: string) => Promise<boolean>} writeText
  */