@autono/pinbox-core 0.18.0 → 0.20.0

package/dist/schema-DDpii7iQ.js

@@ -0,0 +1,192 @@
+import { z } from "zod";
+//#region src/model-anchor.ts
+const vector = z.tuple([
+	z.number().finite(),
+	z.number().finite(),
+	z.number().finite()
+]);
+/** A point in a named part's LOCAL coordinates, pinned to an immutable model revision.
+* No implicit reprojection across edits: hosts must explicitly migrate stale anchors. */
+const ModelAnchorSchema = z.object({
+	modelId: z.string().min(1).max(256),
+	revision: z.string().min(1).max(256),
+	partId: z.string().min(1).max(256),
+	position: vector,
+	normal: vector.refine((v) => Math.hypot(...v) > 0, "normal must be nonzero").optional(),
+	units: z.enum([
+		"mm",
+		"cm",
+		"m",
+		"in"
+	]),
+	faceIndex: z.number().int().nonnegative().optional(),
+	camera: z.object({
+		position: vector,
+		target: vector,
+		up: vector
+	}).optional()
+}).strict();
+//#endregion
+//#region src/schema.ts
+const SCHEMA_VERSION = 1;
+const RectSchema = z.object({
+	x: z.number(),
+	y: z.number(),
+	width: z.number(),
+	height: z.number()
+});
+const SessionRefSchema = z.object({
+	agent: z.string(),
+	key: z.string(),
+	cwd: z.string().optional()
+});
+const AttachmentSchema = z.object({
+	id: z.string(),
+	kind: z.enum(["screenshot", "file"]),
+	path: z.string().optional(),
+	url: z.string().optional(),
+	contentType: z.string().optional(),
+	width: z.number().int().optional(),
+	height: z.number().int().optional()
+});
+/**
+* A change an agent made directly to the live page, rather than to a file.
+*
+* On a project with a repo the agent edits source and the dev server reloads, so the change needs
+* no wire representation. A hosted page has no repo to edit, so the only way an agent can actually
+* change what you are looking at is to say which element and what it should now read.
+*
+* `selector` is the pin's own captured selector, never one the agent chose. `texts` lines up with
+* that element's captured `textRuns`, so pinning a nav bar and asking for all four labels to
+* change is a single edit. Text only, never markup, so this can carry no script.
+*/
+const AppliedEditSchema = z.object({
+	selector: z.string(),
+	/** New text for each of the element's text runs, in order. Length must match, or nothing is applied. */
+	texts: z.array(z.string())
+});
+const ThreadMessageSchema = z.object({
+	id: z.string(),
+	pinId: z.string(),
+	role: z.enum([
+		"human",
+		"agent",
+		"mirror"
+	]),
+	origin: z.string().optional(),
+	text: z.string(),
+	edit: AppliedEditSchema.optional(),
+	attachments: z.array(AttachmentSchema).optional(),
+	at: z.string()
+});
+const SourceSchema = z.object({
+	file: z.string(),
+	line: z.number().optional(),
+	via: z.enum([
+		"plugin",
+		"framework",
+		"none"
+	])
+});
+const ContextSchema = z.object({
+	classes: z.array(z.string()).optional(),
+	styles: z.record(z.string(), z.string()).optional(),
+	aria: z.record(z.string(), z.string()).optional(),
+	nearbyText: z.string().optional(),
+	selectedText: z.string().optional(),
+	/**
+	* The pinned element's text, split the way the markup splits it — one entry per element that
+	* actually holds words. A heading is one entry; a nav bar is one per link.
+	*
+	* `nearbyText` runs them together, which is fine to read and useless to edit: it cannot tell an
+	* agent that "work approach people contact" is four separate elements. This can, and it is what
+	* lets feedback on a group ("capitalise these") reach every item in it.
+	*/
+	textRuns: z.array(z.string()).optional()
+});
+const TargetBaseSchema = z.object({
+	model: ModelAnchorSchema.optional(),
+	url: z.string().optional(),
+	selector: z.string().optional(),
+	tag: z.string().optional(),
+	rect: RectSchema.optional(),
+	/** Where inside `rect` the click landed, 0–1 on each axis. Absent ⇒ anchor at the centre. */
+	spot: z.object({
+		x: z.number(),
+		y: z.number()
+	}).optional(),
+	fixed: z.boolean().optional(),
+	anchor: z.string().optional(),
+	source: SourceSchema.optional(),
+	context: ContextSchema.optional()
+});
+const TargetSchema = TargetBaseSchema.extend({ targets: z.array(TargetBaseSchema).optional() });
+const EnvSchema = z.object({
+	viewport: z.object({
+		w: z.number(),
+		h: z.number(),
+		dpr: z.number()
+	}).optional(),
+	browser: z.string().optional(),
+	os: z.string().optional(),
+	colorScheme: z.enum(["light", "dark"]).optional(),
+	branch: z.string().optional(),
+	commit: z.string().optional()
+});
+const AuthorSchema = z.object({
+	userId: z.string(),
+	name: z.string().optional(),
+	email: z.string().optional()
+});
+const ResolutionSchema = z.object({
+	by: z.enum(["human", "agent"]),
+	note: z.string().optional(),
+	commit: z.string().optional(),
+	at: z.string()
+});
+const VerificationSchema = z.object({
+	outcome: z.enum(["accepted", "reopened"]),
+	at: z.string()
+});
+const LinkSchema = z.object({
+	connector: z.string(),
+	ref: z.string(),
+	url: z.string()
+});
+const PinInputSchema = z.object({
+	text: z.string().min(1),
+	kind: z.enum([
+		"note",
+		"move",
+		"comment"
+	]).default("note"),
+	target: TargetSchema.optional(),
+	move: z.object({
+		from: RectSchema,
+		to: RectSchema
+	}).optional(),
+	env: EnvSchema.optional(),
+	author: AuthorSchema,
+	agentSession: SessionRefSchema.optional(),
+	attachments: z.array(AttachmentSchema).optional()
+});
+const PinSchema = PinInputSchema.extend({
+	id: z.string().regex(/^pin_[a-z0-9]{10}$/),
+	/**
+	* Stable per-project ordinal, hub-assigned at creation like an issue number —
+	* never renumbered by resolution or reordering (dogfood: index-derived chip
+	* numbers kept shifting). Optional because pins predate it; readers fall back.
+	*/
+	n: z.number().int().positive().optional(),
+	schemaVersion: z.literal(1),
+	status: z.enum(["open", "resolved"]).default("open"),
+	createdAt: z.string(),
+	resolution: ResolutionSchema.optional(),
+	verification: VerificationSchema.optional(),
+	links: z.array(LinkSchema).optional()
+});
+function pinJsonSchema() {
+	return z.toJSONSchema(PinSchema);
+}
+//#endregion
+export { PinSchema as a, SessionRefSchema as c, ModelAnchorSchema as d, PinInputSchema as i, ThreadMessageSchema as l, AttachmentSchema as n, RectSchema as o, LinkSchema as r, SCHEMA_VERSION as s, AppliedEditSchema as t, pinJsonSchema as u };

package/dist/schema.d.ts

@@ -1,2 +1,2 @@
-import { _ as ThreadMessageSchema, a as Link, c as PinInput, d as Rect, f as RectSchema, g as ThreadMessage, h as SessionRefSchema, i as AttachmentSchema, l as PinInputSchema, m as SessionRef, n as AppliedEditSchema, o as LinkSchema, p as SCHEMA_VERSION, r as Attachment, s as Pin, t as AppliedEdit, u as PinSchema, v as pinJsonSchema } from "./schema-BlM4lTLW.js";
-export { AppliedEdit, AppliedEditSchema, Attachment, AttachmentSchema, Link, LinkSchema, Pin, PinInput, PinInputSchema, PinSchema, Rect, RectSchema, SCHEMA_VERSION, SessionRef, SessionRefSchema, ThreadMessage, ThreadMessageSchema, pinJsonSchema };
+import { _ as ThreadMessageSchema, a as Link, b as ModelAnchorSchema, c as PinInput, d as Rect, f as RectSchema, g as ThreadMessage, h as SessionRefSchema, i as AttachmentSchema, l as PinInputSchema, m as SessionRef, n as AppliedEditSchema, o as LinkSchema, p as SCHEMA_VERSION, r as Attachment, s as Pin, t as AppliedEdit, u as PinSchema, v as pinJsonSchema, y as ModelAnchor } from "./schema-BLZ3MqMD.js";
+export { AppliedEdit, AppliedEditSchema, Attachment, AttachmentSchema, Link, LinkSchema, type ModelAnchor, ModelAnchorSchema, Pin, PinInput, PinInputSchema, PinSchema, Rect, RectSchema, SCHEMA_VERSION, SessionRef, SessionRefSchema, ThreadMessage, ThreadMessageSchema, pinJsonSchema };

package/dist/schema.js

@@ -1,163 +1,2 @@
-import { z } from "zod";
-//#region src/schema.ts
-const SCHEMA_VERSION = 1;
-const RectSchema = z.object({
-	x: z.number(),
-	y: z.number(),
-	width: z.number(),
-	height: z.number()
-});
-const SessionRefSchema = z.object({
-	agent: z.string(),
-	key: z.string(),
-	cwd: z.string().optional()
-});
-const AttachmentSchema = z.object({
-	id: z.string(),
-	kind: z.enum(["screenshot", "file"]),
-	path: z.string().optional(),
-	url: z.string().optional(),
-	contentType: z.string().optional(),
-	width: z.number().int().optional(),
-	height: z.number().int().optional()
-});
-/**
-* A change an agent made directly to the live page, rather than to a file.
-*
-* On a project with a repo the agent edits source and the dev server reloads, so the change needs
-* no wire representation. A hosted page has no repo to edit, so the only way an agent can actually
-* change what you are looking at is to say which element and what it should now read.
-*
-* `selector` is the pin's own captured selector, never one the agent chose. `texts` lines up with
-* that element's captured `textRuns`, so pinning a nav bar and asking for all four labels to
-* change is a single edit. Text only, never markup, so this can carry no script.
-*/
-const AppliedEditSchema = z.object({
-	selector: z.string(),
-	/** New text for each of the element's text runs, in order. Length must match, or nothing is applied. */
-	texts: z.array(z.string())
-});
-const ThreadMessageSchema = z.object({
-	id: z.string(),
-	pinId: z.string(),
-	role: z.enum([
-		"human",
-		"agent",
-		"mirror"
-	]),
-	origin: z.string().optional(),
-	text: z.string(),
-	edit: AppliedEditSchema.optional(),
-	attachments: z.array(AttachmentSchema).optional(),
-	at: z.string()
-});
-const SourceSchema = z.object({
-	file: z.string(),
-	line: z.number().optional(),
-	via: z.enum([
-		"plugin",
-		"framework",
-		"none"
-	])
-});
-const ContextSchema = z.object({
-	classes: z.array(z.string()).optional(),
-	styles: z.record(z.string(), z.string()).optional(),
-	aria: z.record(z.string(), z.string()).optional(),
-	nearbyText: z.string().optional(),
-	selectedText: z.string().optional(),
-	/**
-	* The pinned element's text, split the way the markup splits it — one entry per element that
-	* actually holds words. A heading is one entry; a nav bar is one per link.
-	*
-	* `nearbyText` runs them together, which is fine to read and useless to edit: it cannot tell an
-	* agent that "work approach people contact" is four separate elements. This can, and it is what
-	* lets feedback on a group ("capitalise these") reach every item in it.
-	*/
-	textRuns: z.array(z.string()).optional()
-});
-const TargetBaseSchema = z.object({
-	url: z.string().optional(),
-	selector: z.string().optional(),
-	tag: z.string().optional(),
-	rect: RectSchema.optional(),
-	/** Where inside `rect` the click landed, 0–1 on each axis. Absent ⇒ anchor at the centre. */
-	spot: z.object({
-		x: z.number(),
-		y: z.number()
-	}).optional(),
-	fixed: z.boolean().optional(),
-	anchor: z.string().optional(),
-	source: SourceSchema.optional(),
-	context: ContextSchema.optional()
-});
-const TargetSchema = TargetBaseSchema.extend({ targets: z.array(TargetBaseSchema).optional() });
-const EnvSchema = z.object({
-	viewport: z.object({
-		w: z.number(),
-		h: z.number(),
-		dpr: z.number()
-	}).optional(),
-	browser: z.string().optional(),
-	os: z.string().optional(),
-	colorScheme: z.enum(["light", "dark"]).optional(),
-	branch: z.string().optional(),
-	commit: z.string().optional()
-});
-const AuthorSchema = z.object({
-	userId: z.string(),
-	name: z.string().optional(),
-	email: z.string().optional()
-});
-const ResolutionSchema = z.object({
-	by: z.enum(["human", "agent"]),
-	note: z.string().optional(),
-	commit: z.string().optional(),
-	at: z.string()
-});
-const VerificationSchema = z.object({
-	outcome: z.enum(["accepted", "reopened"]),
-	at: z.string()
-});
-const LinkSchema = z.object({
-	connector: z.string(),
-	ref: z.string(),
-	url: z.string()
-});
-const PinInputSchema = z.object({
-	text: z.string().min(1),
-	kind: z.enum([
-		"note",
-		"move",
-		"comment"
-	]).default("note"),
-	target: TargetSchema.optional(),
-	move: z.object({
-		from: RectSchema,
-		to: RectSchema
-	}).optional(),
-	env: EnvSchema.optional(),
-	author: AuthorSchema,
-	agentSession: SessionRefSchema.optional(),
-	attachments: z.array(AttachmentSchema).optional()
-});
-const PinSchema = PinInputSchema.extend({
-	id: z.string().regex(/^pin_[a-z0-9]{10}$/),
-	/**
-	* Stable per-project ordinal, hub-assigned at creation like an issue number —
-	* never renumbered by resolution or reordering (dogfood: index-derived chip
-	* numbers kept shifting). Optional because pins predate it; readers fall back.
-	*/
-	n: z.number().int().positive().optional(),
-	schemaVersion: z.literal(1),
-	status: z.enum(["open", "resolved"]).default("open"),
-	createdAt: z.string(),
-	resolution: ResolutionSchema.optional(),
-	verification: VerificationSchema.optional(),
-	links: z.array(LinkSchema).optional()
-});
-function pinJsonSchema() {
-	return z.toJSONSchema(PinSchema);
-}
-//#endregion
-export { AppliedEditSchema, AttachmentSchema, LinkSchema, PinInputSchema, PinSchema, RectSchema, SCHEMA_VERSION, SessionRefSchema, ThreadMessageSchema, pinJsonSchema };
+import { a as PinSchema, c as SessionRefSchema, d as ModelAnchorSchema, i as PinInputSchema, l as ThreadMessageSchema, n as AttachmentSchema, o as RectSchema, r as LinkSchema, s as SCHEMA_VERSION, t as AppliedEditSchema, u as pinJsonSchema } from "./schema-DDpii7iQ.js";
+export { AppliedEditSchema, AttachmentSchema, LinkSchema, ModelAnchorSchema, PinInputSchema, PinSchema, RectSchema, SCHEMA_VERSION, SessionRefSchema, ThreadMessageSchema, pinJsonSchema };

package/dist/schema.json

@@ -18,6 +18,129 @@
     "target": {
       "type": "object",
       "properties": {
+        "model": {
+          "type": "object",
+          "properties": {
+            "modelId": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 256
+            },
+            "revision": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 256
+            },
+            "partId": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 256
+            },
+            "position": {
+              "type": "array",
+              "prefixItems": [
+                {
+                  "type": "number"
+                },
+                {
+                  "type": "number"
+                },
+                {
+                  "type": "number"
+                }
+              ]
+            },
+            "normal": {
+              "type": "array",
+              "prefixItems": [
+                {
+                  "type": "number"
+                },
+                {
+                  "type": "number"
+                },
+                {
+                  "type": "number"
+                }
+              ]
+            },
+            "units": {
+              "type": "string",
+              "enum": [
+                "mm",
+                "cm",
+                "m",
+                "in"
+              ]
+            },
+            "faceIndex": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "camera": {
+              "type": "object",
+              "properties": {
+                "position": {
+                  "type": "array",
+                  "prefixItems": [
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "number"
+                    }
+                  ]
+                },
+                "target": {
+                  "type": "array",
+                  "prefixItems": [
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "number"
+                    }
+                  ]
+                },
+                "up": {
+                  "type": "array",
+                  "prefixItems": [
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "number"
+                    }
+                  ]
+                }
+              },
+              "required": [
+                "position",
+                "target",
+                "up"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "required": [
+            "modelId",
+            "revision",
+            "partId",
+            "position",
+            "units"
+          ],
+          "additionalProperties": false
+        },
         "url": {
           "type": "string"
         },
@@ -144,6 +267,129 @@
           "items": {
             "type": "object",
             "properties": {
+              "model": {
+                "type": "object",
+                "properties": {
+                  "modelId": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 256
+                  },
+                  "revision": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 256
+                  },
+                  "partId": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 256
+                  },
+                  "position": {
+                    "type": "array",
+                    "prefixItems": [
+                      {
+                        "type": "number"
+                      },
+                      {
+                        "type": "number"
+                      },
+                      {
+                        "type": "number"
+                      }
+                    ]
+                  },
+                  "normal": {
+                    "type": "array",
+                    "prefixItems": [
+                      {
+                        "type": "number"
+                      },
+                      {
+                        "type": "number"
+                      },
+                      {
+                        "type": "number"
+                      }
+                    ]
+                  },
+                  "units": {
+                    "type": "string",
+                    "enum": [
+                      "mm",
+                      "cm",
+                      "m",
+                      "in"
+                    ]
+                  },
+                  "faceIndex": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 9007199254740991
+                  },
+                  "camera": {
+                    "type": "object",
+                    "properties": {
+                      "position": {
+                        "type": "array",
+                        "prefixItems": [
+                          {
+                            "type": "number"
+                          },
+                          {
+                            "type": "number"
+                          },
+                          {
+                            "type": "number"
+                          }
+                        ]
+                      },
+                      "target": {
+                        "type": "array",
+                        "prefixItems": [
+                          {
+                            "type": "number"
+                          },
+                          {
+                            "type": "number"
+                          },
+                          {
+                            "type": "number"
+                          }
+                        ]
+                      },
+                      "up": {
+                        "type": "array",
+                        "prefixItems": [
+                          {
+                            "type": "number"
+                          },
+                          {
+                            "type": "number"
+                          },
+                          {
+                            "type": "number"
+                          }
+                        ]
+                      }
+                    },
+                    "required": [
+                      "position",
+                      "target",
+                      "up"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "required": [
+                  "modelId",
+                  "revision",
+                  "partId",
+                  "position",
+                  "units"
+                ],
+                "additionalProperties": false
+              },
               "url": {
                 "type": "string"
               },

package/dist/{sessions-BOrd8Yvv.d.ts → sessions-Bd7_G5jW.d.ts}

@@ -1,4 +1,4 @@
-import { m as SessionRef } from "./schema-BlM4lTLW.js";
+import { m as SessionRef } from "./schema-BLZ3MqMD.js";
 import { z } from "zod";
 import { Database } from "bun:sqlite";
 //#region src/trailer.d.ts

package/dist/sessions.d.ts

@@ -1,2 +1,2 @@
-import { a as parseTrailers, i as SqliteSessionStore, n as SessionSchema, r as SessionStore, t as Session } from "./sessions-BOrd8Yvv.js";
+import { a as parseTrailers, i as SqliteSessionStore, n as SessionSchema, r as SessionStore, t as Session } from "./sessions-Bd7_G5jW.js";
 export { Session, SessionSchema, SessionStore, SqliteSessionStore, parseTrailers };