@ingcreators/annot-core 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,80 @@
 # @ingcreators/annot-core
 
+## 0.2.1
+
+### Patch Changes
+
+- f485646: **Expose `./xmp-bytes` subpath on the published tarball.**
+  The workspace `package.json#exports` declared
+  `"./xmp-bytes": "./src/xmp/xmp-bytes.ts"` from day one, but
+  `publishConfig.exports` only declared `.` + `./styles/*` —
+  so every workspace subpath (`./headless`, `./editor/*`,
+  `./xmp-bytes`, etc.) was stripped from the published
+  tarball.
+
+  This patch unblocks the `./xmp-bytes` subpath specifically.
+  `@ingcreators/annot-product-docs-astro@0.2.1`'s playwright
+  fixture imports `@ingcreators/annot-core/xmp-bytes` (via
+  the bundled `writePngWithTagsOnly` helper); without this
+  patch, any consumer doing
+  `import { test } from "@ingcreators/annot-product-docs-astro/playwright"`
+  hits `Package subpath './xmp-bytes' is not defined`.
+
+  ## Fix
+
+  `vite.config.ts` switches to multi-entry library mode:
+
+  ```ts
+  lib: {
+    entry: {
+      index: resolve(__dirname, "src/index.ts"),
+      "xmp-bytes": resolve(__dirname, "src/xmp/xmp-bytes.ts"),
+    },
+    formats: ["es"],
+  },
+  ```
+
+  `package.json#publishConfig.exports` gains the matching
+  `./xmp-bytes` entry:
+
+  ```json
+  "./xmp-bytes": {
+    "types": "./dist/xmp/xmp-bytes.d.ts",
+    "default": "./dist/xmp-bytes.js"
+  }
+  ```
+
+  Bundle landing in the tarball:
+
+  ```
+  dist/xmp-bytes.js          7.55 kB │ gzip: 2.67 kB
+  dist/xmp/xmp-bytes.d.ts    declarations colocated by the dts plugin
+  ```
+
+  ## Other subpaths still missing
+
+  The workspace `exports` map declares 17+ subpaths (`./headless`,
+  `./editor`, `./editor/*`, `./icons`, `./xmp`, `./zip`,
+  `./utils`, `./desktop-bridge`, `./storage`, `./encode/*`,
+  `./auto-capture-options`, …). Most are Tier C (browser-only)
+  and shouldn't ship as standalone published bundles — Tier C
+  code lives in `@ingcreators/annot-editor` / `-render` for
+  npm consumers. The few Tier A subpaths that DO make sense
+  on npm (`./headless`, `./storage`, `./utils`, `./zip`,
+  `./zip-bytes`) can ship in a separate follow-up patch
+  when a concrete downstream consumer needs them.
+
+  ## After this PR republishes
+
+  `@ingcreators/annot-product-docs-astro` needs a `0.2.2`
+  republish that bumps its `@ingcreators/annot-core` dep
+  from `0.2.0` to `^0.2.1` so the playwright fixture can
+  finally resolve `./xmp-bytes` at consumer install time.
+  Once both land, the `examples/workflow-app/` tour can
+  migrate from the hybrid `captureScreen + page.screenshot`
+  pair to the unified `page.screenshot({ annot: { mdx } })`
+  single call.
+
 ## 0.2.0
 
 ### Minor Changes

package/dist/xmp-bytes.js

@@ -0,0 +1,265 @@
+//#region src/xmp/xmp-bytes.ts
+var e = "annot", t = "https://ingcreators.com/annot/ns/1.0/", n = new TextEncoder().encode("http://ns.adobe.com/xap/1.0/\0"), r = new TextEncoder().encode("annot:OriginalImage\0"), i = new TextEncoder().encode("XML:com.adobe.xmp");
+function a(n, r, i, a) {
+	let o = a && Object.keys(a).length > 0 ? JSON.stringify(a) : "";
+	return `<?xpacket begin="" id="W5M0MpCehiHzreSzNTczkc9d"?>
+<x:xmpmeta xmlns:x="adobe:ns:meta/">
+  <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
+    <rdf:Description rdf:about=""
+      xmlns:${e}="${t}">
+      <${e}:annotations><![CDATA[${n}]]></${e}:annotations>
+      <${e}:width>${r}</${e}:width>
+      <${e}:height>${i}</${e}:height>
+      <${e}:version>1.0</${e}:version>${o ? `\n      <${e}:tags>${o}</${e}:tags>` : ""}
+    </rdf:Description>
+  </rdf:RDF>
+</x:xmpmeta>
+<?xpacket end="w"?>`;
+}
+function o(e) {
+	return new Uint8Array([e >> 8 & 255, e & 255]);
+}
+function s(e) {
+	return new Uint8Array([
+		e >> 24 & 255,
+		e >> 16 & 255,
+		e >> 8 & 255,
+		e & 255
+	]);
+}
+function c(e, t) {
+	return e[t] << 8 | e[t + 1];
+}
+function l(e, t) {
+	return (e[t] << 24 | e[t + 1] << 16 | e[t + 2] << 8 | e[t + 3]) >>> 0;
+}
+function u(...e) {
+	let t = 0;
+	for (let n of e) t += n.length;
+	let n = new Uint8Array(t), r = 0;
+	for (let t of e) n.set(t, r), r += t.length;
+	return n;
+}
+function d(e, t, n) {
+	if (t + n.length > e.length) return !1;
+	for (let r = 0; r < n.length; r++) if (e[t + r] !== n[r]) return !1;
+	return !0;
+}
+function f(e) {
+	let t = e.split(",")[1] || "", n = atob(t), r = new Uint8Array(n.length);
+	for (let e = 0; e < n.length; e++) r[e] = n.charCodeAt(e);
+	return r;
+}
+function p(e, t) {
+	let n = t.length + 2;
+	return u(new Uint8Array([255, e]), o(n), t);
+}
+function m(e) {
+	let t = 65533 - r.length - 4, n = Math.ceil(e.length / t), i = [];
+	for (let a = 0; a < n; a++) {
+		let s = a * t, c = Math.min(s + t, e.length), l = e.slice(s, c), d = u(r, o(a), o(n), l);
+		i.push(p(226, d));
+	}
+	return u(...i);
+}
+function h(e) {
+	let t = [e.slice(0, 2)], i = 2;
+	for (; i + 4 <= e.length && e[i] === 255;) {
+		let a = e[i + 1];
+		if (a === 217 || a === 218) return t.push(e.slice(i)), u(...t);
+		let o = c(e, i + 2), s = i + 2 + o;
+		if (s > e.length) break;
+		let l = a === 225 && d(e, i + 4, n), f = a === 226 && d(e, i + 4, r);
+		!l && !f && t.push(e.slice(i, s)), i = s;
+	}
+	return i < e.length && t.push(e.slice(i)), u(...t);
+}
+function g(e, t, r) {
+	let i = p(225, u(n, t)), a = m(r), o = h(e);
+	return u(o.slice(0, 2), i, a, o.slice(2));
+}
+var _ = (() => {
+	let e = new Uint32Array(256);
+	for (let t = 0; t < 256; t++) {
+		let n = t;
+		for (let e = 0; e < 8; e++) n & 1 ? n = 3988292384 ^ n >>> 1 : n >>>= 1;
+		e[t] = n;
+	}
+	return e;
+})();
+function v(e) {
+	let t = 4294967295;
+	for (let n = 0; n < e.length; n++) t = _[(t ^ e[n]) & 255] ^ t >>> 8;
+	return (t ^ 4294967295) >>> 0;
+}
+function y(e, t) {
+	let n = u(e, t), r = v(n);
+	return u(s(t.length), n, s(r));
+}
+function b(e) {
+	let t = u(i, new Uint8Array([
+		0,
+		0,
+		0,
+		0,
+		0
+	]), e);
+	return y(new TextEncoder().encode("iTXt"), t);
+}
+function x(e) {
+	let t = [e.slice(0, 8)], n = 8;
+	for (; n + 12 <= e.length;) {
+		let r = l(e, n), a = e.slice(n + 4, n + 8), o = n + 8, s = o + r + 4;
+		if (s > e.length) break;
+		let c = String.fromCharCode(...a);
+		!(c === "iTXt" && d(e, o, i)) && c !== "svGo" && t.push(e.slice(n, s)), n = s;
+	}
+	return u(...t);
+}
+function S(e, t, n) {
+	let r = b(t), i = y(new TextEncoder().encode("svGo"), n), a = x(e), o = a.length - 12;
+	return u(a.slice(0, o), r, i, a.slice(o));
+}
+function C(n) {
+	return `<?xpacket begin="" id="W5M0MpCehiHzreSzNTczkc9d"?>
+<x:xmpmeta xmlns:x="adobe:ns:meta/">
+  <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
+    <rdf:Description rdf:about=""
+      xmlns:${e}="${t}">
+      <${e}:tags>${JSON.stringify(n)}</${e}:tags>
+    </rdf:Description>
+  </rdf:RDF>
+</x:xmpmeta>
+<?xpacket end="w"?>`;
+}
+function w(e, t) {
+	if (!t || Object.keys(t).length === 0) return e;
+	let n = b(new TextEncoder().encode(C(t))), r = x(e), i = r.length - 12;
+	return u(r.slice(0, i), n, r.slice(i));
+}
+var T = [
+	"source",
+	"screen",
+	"capturedAt",
+	"commit"
+];
+function E(e) {
+	let t = a(e.annotationsSvg, e.width, e.height, e.tags), n = new TextEncoder().encode(t), r = typeof e.originalImage == "string" ? f(e.originalImage) : e.originalImage;
+	return S(e.renderedPng, n, r);
+}
+function D(e) {
+	return A(e) ? M(e) : null;
+}
+function O(e) {
+	return k(e) ? j(e) : A(e) ? M(e) : null;
+}
+function k(e) {
+	return e[0] === 255 && e[1] === 216;
+}
+function A(e) {
+	return e[0] === 137 && e[1] === 80 && e[2] === 78 && e[3] === 71;
+}
+function j(e) {
+	let t = F(e), n = I(e);
+	return t ? N(t, n) : null;
+}
+function M(e) {
+	let t = L(e), n = R(e);
+	return t ? N(t, n) : null;
+}
+function N(e, t) {
+	let n = P(e, "annotations");
+	if (!n) return null;
+	let r = n.replace(/^<!\[CDATA\[/, "").replace(/\]\]>$/, ""), i = Number.parseInt(P(e, "width") || "0", 10), a = Number.parseInt(P(e, "height") || "0", 10), o = "";
+	t && t.length > 0 && (o = `data:${t[0] === 137 && t[1] === 80 ? "image/png" : "image/jpeg"};base64,${z(t)}`);
+	let s = {}, c = P(e, "tags");
+	if (c) try {
+		s = JSON.parse(c);
+	} catch {}
+	return {
+		originalImageDataUrl: o,
+		annotationsSvg: r,
+		width: i,
+		height: a,
+		tags: s
+	};
+}
+function P(t, n) {
+	let r = `<${e}:${n}>`, i = `</${e}:${n}>`, a = t.indexOf(r);
+	if (a < 0) return null;
+	let o = t.indexOf(i, a);
+	return o < 0 ? null : t.substring(a + r.length, o);
+}
+function F(e) {
+	let t = 2;
+	for (; t + 4 <= e.length && e[t] === 255;) {
+		let r = e[t + 1];
+		if (r === 217 || r === 218) break;
+		let i = c(e, t + 2), a = t + 2 + i;
+		if (a > e.length) break;
+		if (r === 225 && d(e, t + 4, n)) {
+			let r = t + 4 + n.length;
+			return new TextDecoder().decode(e.slice(r, a));
+		}
+		t = a;
+	}
+	return null;
+}
+function I(e) {
+	let t = r.length, n = [], i = 2;
+	for (; i + 4 <= e.length && e[i] === 255;) {
+		let a = e[i + 1];
+		if (a === 217 || a === 218) break;
+		let o = c(e, i + 2), s = i + 2 + o;
+		if (s > e.length) break;
+		if (a === 226 && d(e, i + 4, r)) {
+			let r = i + 4 + t;
+			if (r + 4 <= s) {
+				let t = c(e, r), i = e.slice(r + 4, s);
+				n.push({
+					seq: t,
+					data: i
+				});
+			}
+		}
+		i = s;
+	}
+	return n.length === 0 ? null : (n.sort((e, t) => e.seq - t.seq), u(...n.map((e) => e.data)));
+}
+function L(e) {
+	let t = 8;
+	for (; t + 12 <= e.length;) {
+		let n = l(e, t), r = String.fromCharCode(e[t + 4], e[t + 5], e[t + 6], e[t + 7]), a = t + 8, o = a + n + 4;
+		if (o > e.length) break;
+		if (r === "iTXt" && d(e, a, i)) {
+			let t = a + i.length, r = 0, o = t;
+			for (let i = t; i < a + n; i++) if (e[i] === 0 && r++, r >= 4) {
+				o = i + 1;
+				break;
+			}
+			return new TextDecoder().decode(e.slice(o, a + n));
+		}
+		t = o;
+	}
+	return null;
+}
+function R(e) {
+	let t = 8;
+	for (; t + 12 <= e.length;) {
+		let n = l(e, t), r = String.fromCharCode(e[t + 4], e[t + 5], e[t + 6], e[t + 7]), i = t + 8, a = i + n + 4;
+		if (a > e.length) break;
+		if (r === "svGo") return e.slice(i, i + n);
+		t = a;
+	}
+	return null;
+}
+function z(e) {
+	let t = 32768, n = "";
+	for (let r = 0; r < e.length; r += t) {
+		let i = e.subarray(r, Math.min(r + t, e.length));
+		n += String.fromCharCode.apply(null, i);
+	}
+	return btoa(n);
+}
+//#endregion
+export { T as WELL_KNOWN_TAG_KEYS, a as buildXmp, C as buildXmpTagsOnly, E as createEditablePngBytes, f as dataUrlToUint8Array, O as readEditableImage, D as readEditablePngBytes, g as writeJpegWithMetadata, S as writePngWithMetadata, w as writePngWithTagsOnly };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ingcreators/annot-core",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Annot SDK — SVG-first screenshot annotation format, storage abstractions, and editor primitives. The foundation shared by the PWA, Chrome extension, Electron desktop, VSCode extension, and the headless annotator.",
   "license": "Apache-2.0",
   "author": "ingcreators",
@@ -30,6 +30,10 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
+    "./xmp-bytes": {
+      "types": "./dist/xmp/xmp-bytes.d.ts",
+      "default": "./dist/xmp-bytes.js"
+    },
     "./styles/*": "./styles/*"
   },
   "files": [

package/styles/editor.css

@@ -179,9 +179,12 @@ body {
 
 /* The contentEditable overlay lives inside a `<foreignObject>` —
    bring text selection back so the user can mark / replace runs
-   while editing. */
-#svg-root foreignObject [contenteditable="true"],
-[data-annot-shell-root] foreignObject [contenteditable="true"] {
+   while editing. Selectors ordered ascending-by-specificity so
+   Biome's `noDescendingSpecificity` rule is satisfied:
+   `[data-annot-shell-root]` is (0,2,1); `#svg-root` is (1,1,1).
+   Same applied rules either way. */
+[data-annot-shell-root] foreignObject [contenteditable="true"],
+#svg-root foreignObject [contenteditable="true"] {
   user-select: text;
   -webkit-user-select: text;
 }