@derive-to/artifacts 0.0.0-stage → 0.6.1

package/dist/protocol/presentation.d.ts

@@ -0,0 +1,9 @@
+import * as z from "zod/mini";
+/** Shared by the host, view, and relay without loading unrelated message schemas. */
+export declare const presentNotification: import("./define.js").NotificationSpec<z.ZodMiniObject<{
+    on: z.ZodMiniBoolean<boolean>;
+    slide: z.ZodMiniOptional<z.ZodMiniInt>;
+}, z.core.$strip>>;
+export declare const exitPresentNotification: import("./define.js").NotificationSpec<z.ZodMiniObject<{}, z.core.$strip>>;
+export declare const escapeNotification: import("./define.js").NotificationSpec<z.ZodMiniObject<{}, z.core.$strip>>;
+//# sourceMappingURL=presentation.d.ts.map

package/dist/protocol/presentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation.d.ts","sourceRoot":"","sources":["../../src/protocol/presentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAG7B,qFAAqF;AACrF,eAAO,MAAM,mBAAmB;;;kBAG/B,CAAA;AAED,eAAO,MAAM,uBAAuB,4EAGnC,CAAA;AAED,eAAO,MAAM,kBAAkB,4EAAoE,CAAA"}

package/dist/protocol/presentation.js

@@ -0,0 +1,7 @@
+import * as z from "zod/mini";
+import { defineNotification } from "./define.js";
+/** Shared by the host, view, and relay without loading unrelated message schemas. */
+export const presentNotification = defineNotification("artifact/notifications/present", z.object({ on: z.boolean(), slide: z.optional(z.int().check(z.nonnegative())) }));
+export const exitPresentNotification = defineNotification("artifact/notifications/exit-present", z.object({}));
+export const escapeNotification = defineNotification("artifact/notifications/escape", z.object({}));
+//# sourceMappingURL=presentation.js.map

package/dist/protocol/presentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation.js","sourceRoot":"","sources":["../../src/protocol/presentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAEhD,qFAAqF;AACrF,MAAM,CAAC,MAAM,mBAAmB,GAAG,kBAAkB,CACnD,gCAAgC,EAChC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC,CACjF,CAAA;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG,kBAAkB,CACvD,qCAAqC,EACrC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CACb,CAAA;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAAkB,CAAC,+BAA+B,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA"}

package/dist/protocol/quote-match.d.ts

@@ -0,0 +1,20 @@
+/** Pure, DOM-free quote matching. The runtime resolves anchors against the live page and
+ *  the server can resolve them against stored text with the same code, so both sides agree
+ *  by construction. Ported from Derive's anchor-shared. */
+import type { Quote } from "./anchors.js";
+import { normWs } from "./source-anchors.js";
+export interface Span {
+    start: number;
+    end: number;
+}
+/** Collapse runs of whitespace and trim. */
+export declare const normalizeWhitespace: typeof normWs;
+/** Locate a quote in `text`: by its context first, then the bare exact text where it occurs
+ *  once. Null when it is gone or now ambiguous. See `findQuoteWithContext`. */
+export declare const findQuote: (text: string, quote: Quote) => Span | null;
+/** Build a quote for the span `[start, end)` of `text`, with context on both sides. */
+export declare const quoteAt: (text: string, span: Span) => Quote;
+/** Like `findQuote`, but never guesses: without matching context, the exact text must occur
+ *  once. For writes, where the wrong occurrence would change the wrong words. */
+export declare const findQuoteStrictly: (text: string, quote: Quote) => Span | "ambiguous" | null;
+//# sourceMappingURL=quote-match.d.ts.map

package/dist/protocol/quote-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote-match.d.ts","sourceRoot":"","sources":["../../src/protocol/quote-match.ts"],"names":[],"mappings":"AAAA;;2DAE2D;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAIL,MAAM,EACP,MAAM,qBAAqB,CAAA;AAE5B,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;CACZ;AAID,4CAA4C;AAC5C,eAAO,MAAM,mBAAmB,eAAS,CAAA;AAEzC;+EAC+E;AAC/E,eAAO,MAAM,SAAS,SAAU,MAAM,SAAS,KAAK,KAAG,IAAI,GAAG,IACO,CAAA;AAErE,uFAAuF;AACvF,eAAO,MAAM,OAAO,SAAU,MAAM,QAAQ,IAAI,KAAG,KAIjD,CAAA;AAEF;iFACiF;AACjF,eAAO,MAAM,iBAAiB,SAAU,MAAM,SAAS,KAAK,KAAG,IAAI,GAAG,WAAW,GAAG,IAWnF,CAAA"}

package/dist/protocol/quote-match.js

@@ -0,0 +1,33 @@
+import { findQuoteMatches, findQuoteWithContext, findSelectionContextUnique, normWs, } from "./source-anchors.js";
+const CONTEXT = 32;
+/** Collapse runs of whitespace and trim. */
+export const normalizeWhitespace = normWs;
+/** Locate a quote in `text`: by its context first, then the bare exact text where it occurs
+ *  once. Null when it is gone or now ambiguous. See `findQuoteWithContext`. */
+export const findQuote = (text, quote) => findQuoteWithContext(text, quote.exact, quote.prefix, quote.suffix);
+/** Build a quote for the span `[start, end)` of `text`, with context on both sides. */
+export const quoteAt = (text, span) => ({
+    exact: text.slice(span.start, span.end),
+    prefix: text.slice(Math.max(0, span.start - CONTEXT), span.start),
+    suffix: text.slice(span.end, span.end + CONTEXT),
+});
+/** Like `findQuote`, but never guesses: without matching context, the exact text must occur
+ *  once. For writes, where the wrong occurrence would change the wrong words. */
+export const findQuoteStrictly = (text, quote) => {
+    const exact = quote.exact.trim();
+    if (!exact)
+        return null;
+    const contextual = findSelectionContextUnique(text, quote.exact, quote.prefix, quote.suffix);
+    if (contextual.matches > 1)
+        return "ambiguous";
+    if (contextual.span)
+        return contextual.span;
+    const all = findQuoteMatches(text, quote.exact, 2);
+    const [only] = all;
+    if (!only)
+        return null;
+    if (all.length > 1)
+        return "ambiguous";
+    return only;
+};
+//# sourceMappingURL=quote-match.js.map

package/dist/protocol/quote-match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote-match.js","sourceRoot":"","sources":["../../src/protocol/quote-match.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,0BAA0B,EAC1B,MAAM,GACP,MAAM,qBAAqB,CAAA;AAO5B,MAAM,OAAO,GAAG,EAAE,CAAA;AAElB,4CAA4C;AAC5C,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAA;AAEzC;+EAC+E;AAC/E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,KAAY,EAAe,EAAE,CACnE,oBAAoB,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;AAErE,uFAAuF;AACvF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,IAAU,EAAS,EAAE,CAAC,CAAC;IAC3D,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC;IACvC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC;IACjE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC;CACjD,CAAC,CAAA;AAEF;iFACiF;AACjF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAE,KAAY,EAA6B,EAAE;IACzF,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAA;IAChC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAA;IACvB,MAAM,UAAU,GAAG,0BAA0B,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IAC5F,IAAI,UAAU,CAAC,OAAO,GAAG,CAAC;QAAE,OAAO,WAAW,CAAA;IAC9C,IAAI,UAAU,CAAC,IAAI;QAAE,OAAO,UAAU,CAAC,IAAI,CAAA;IAC3C,MAAM,GAAG,GAAG,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;IAClD,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAA;IAClB,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IACtB,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,WAAW,CAAA;IACtC,OAAO,IAAI,CAAA;AACb,CAAC,CAAA"}

package/dist/protocol/sharing.d.ts

@@ -0,0 +1,133 @@
+import * as z from "zod/mini";
+import { type Verb } from "./access.js";
+/**
+ * Roles, in increasing power. Each holds the verbs up to its own on the ladder:
+ * viewer: view and interact; commenter: + comment; editor: + edit; owner: + manage.
+ */
+export declare const roleSchema: z.ZodMiniEnum<{
+    commenter: "commenter";
+    editor: "editor";
+    owner: "owner";
+    viewer: "viewer";
+}>;
+export type Role = z.infer<typeof roleSchema>;
+export declare const ROLES: readonly Role[];
+/** What anyone holding the artifact's share link gets. `none` means the link is off. */
+export declare const linkRoleSchema: z.ZodMiniEnum<{
+    commenter: "commenter";
+    editor: "editor";
+    none: "none";
+    viewer: "viewer";
+}>;
+export type LinkRole = z.infer<typeof linkRoleSchema>;
+/** Whether members of the artifact's space open it at their own seat role. */
+export declare const spaceAccessSchema: z.ZodMiniEnum<{
+    member: "member";
+    none: "none";
+}>;
+export type SpaceAccess = z.infer<typeof spaceAccessSchema>;
+/** The verbs a role holds: always a run from the bottom of the ladder. */
+export declare const roleVerbs: (role: Role | null) => Verb[];
+/** The highest of some roles, ignoring nulls; null when there is none. */
+export declare const maxRole: (...roles: readonly (Role | null)[]) => Role | null;
+/** The lower of two roles. */
+export declare const minRole: (a: Role, b: Role) => Role;
+/** Does `held` reach `needed`? */
+export declare const roleReaches: (held: Role, needed: Role) => boolean;
+/** Everything that decides one principal's role on one artifact. */
+export interface Standing {
+    /** Is there a signed-in actor? */
+    signedIn: boolean;
+    /** Did the request arrive by this artifact's live share link? */
+    viaLink: boolean;
+    /** The actor created the artifact. */
+    creator: boolean;
+    /** The actor's own grant on this artifact, if any. */
+    grant: Role | null;
+    /** The actor's seat in the artifact's space, if they are a member. */
+    seat: Role | null;
+    spaceAccess: SpaceAccess;
+    linkRole: LinkRole;
+    /** For an agent: the most it may ever hold, whoever it acts for. */
+    cap: Role | null;
+}
+/**
+ * The role a principal holds on an artifact: the highest of the creator's ownership, their
+ * grant, their seat (when the space has access), and the share link (when they arrived by
+ * it). Three rules hold for every input, proven in `lean/Kernel/Sharing.lean`:
+ * an anonymous principal is at most a viewer; an agent never exceeds its cap; and removing
+ * any source of standing never raises the role.
+ */
+export declare const effectiveRole: (s: Standing) => Role | null;
+/** An artifact's sharing settings, as a manager sees them. */
+export declare const shareSettingsSchema: z.ZodMiniObject<{
+    spaceAccess: z.ZodMiniEnum<{
+        member: "member";
+        none: "none";
+    }>;
+    linkRole: z.ZodMiniEnum<{
+        commenter: "commenter";
+        editor: "editor";
+        none: "none";
+        viewer: "viewer";
+    }>;
+    linkToken: z.ZodMiniNullable<z.ZodMiniString<string>>;
+}, z.core.$strip>;
+export type ShareSettings = z.infer<typeof shareSettingsSchema>;
+export declare const DEFAULT_SHARE_SETTINGS: ShareSettings;
+export declare const shareGrantSchema: z.ZodMiniObject<{
+    actor: z.ZodMiniObject<{
+        id: z.ZodMiniString<string>;
+        name: z.ZodMiniString<string>;
+        avatarUrl: z.ZodMiniOptional<z.ZodMiniURL>;
+    }, z.core.$strip>;
+    role: z.ZodMiniEnum<{
+        commenter: "commenter";
+        editor: "editor";
+        owner: "owner";
+        viewer: "viewer";
+    }>;
+}, z.core.$strip>;
+export type ShareGrant = z.infer<typeof shareGrantSchema>;
+export declare const sharingSchema: z.ZodMiniObject<{
+    settings: z.ZodMiniObject<{
+        spaceAccess: z.ZodMiniEnum<{
+            member: "member";
+            none: "none";
+        }>;
+        linkRole: z.ZodMiniEnum<{
+            commenter: "commenter";
+            editor: "editor";
+            none: "none";
+            viewer: "viewer";
+        }>;
+        linkToken: z.ZodMiniNullable<z.ZodMiniString<string>>;
+    }, z.core.$strip>;
+    grants: z.ZodMiniArray<z.ZodMiniObject<{
+        actor: z.ZodMiniObject<{
+            id: z.ZodMiniString<string>;
+            name: z.ZodMiniString<string>;
+            avatarUrl: z.ZodMiniOptional<z.ZodMiniURL>;
+        }, z.core.$strip>;
+        role: z.ZodMiniEnum<{
+            commenter: "commenter";
+            editor: "editor";
+            owner: "owner";
+            viewer: "viewer";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Sharing = z.infer<typeof sharingSchema>;
+/** What this reader may do with sharing, as the server decides it: whether they may change
+ *  it at all, and the roles they may give (at most their own; owner only by an owner). */
+export declare const sharingAccessSchema: z.ZodMiniObject<{
+    mayShare: z.ZodMiniBoolean<boolean>;
+    givable: z.ZodMiniArray<z.ZodMiniEnum<{
+        commenter: "commenter";
+        editor: "editor";
+        owner: "owner";
+        viewer: "viewer";
+    }>>;
+}, z.core.$strip>;
+export type SharingAccess = z.infer<typeof sharingAccessSchema>;
+//# sourceMappingURL=sharing.d.ts.map

package/dist/protocol/sharing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharing.d.ts","sourceRoot":"","sources":["../../src/protocol/sharing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAC7B,OAAO,EAAS,KAAK,IAAI,EAAE,MAAM,aAAa,CAAA;AAG9C;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;EAAqD,CAAA;AAC5E,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAA;AAC7C,eAAO,MAAM,KAAK,EAAE,SAAS,IAAI,EAAuB,CAAA;AAExD,wFAAwF;AACxF,eAAO,MAAM,cAAc;;;;;EAAoD,CAAA;AAC/E,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAErD,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB;;;EAA6B,CAAA;AAC3D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAS3D,0EAA0E;AAC1E,eAAO,MAAM,SAAS,SAAU,IAAI,GAAG,IAAI,KAAG,IAAI,EACsB,CAAA;AAIxE,0EAA0E;AAC1E,eAAO,MAAM,OAAO,aAAc,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,KAAG,IAAI,GAAG,IAIjE,CAAA;AAEH,8BAA8B;AAC9B,eAAO,MAAM,OAAO,MAAO,IAAI,KAAK,IAAI,KAAG,IAAoC,CAAA;AAE/E,kCAAkC;AAClC,eAAO,MAAM,WAAW,SAAU,IAAI,UAAU,IAAI,KAAG,OAAqC,CAAA;AAE5F,oEAAoE;AACpE,MAAM,WAAW,QAAQ;IACvB,kCAAkC;IAClC,QAAQ,EAAE,OAAO,CAAA;IACjB,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAA;IAChB,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAA;IAChB,sDAAsD;IACtD,KAAK,EAAE,IAAI,GAAG,IAAI,CAAA;IAClB,sEAAsE;IACtE,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;IACjB,WAAW,EAAE,WAAW,CAAA;IACxB,QAAQ,EAAE,QAAQ,CAAA;IAClB,oEAAoE;IACpE,GAAG,EAAE,IAAI,GAAG,IAAI,CAAA;CACjB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,MAAO,QAAQ,KAAG,IAAI,GAAG,IAOlD,CAAA;AAED,8DAA8D;AAC9D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;iBAK9B,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE/D,eAAO,MAAM,sBAAsB,EAAE,aAIpC,CAAA;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;iBAAqD,CAAA;AAClF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAEzD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGxB,CAAA;AACF,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AAEnD;0FAC0F;AAC1F,eAAO,MAAM,mBAAmB;;;;;;;;iBAG9B,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA"}

package/dist/protocol/sharing.js

@@ -0,0 +1,67 @@
+import * as z from "zod/mini";
+import { VERBS } from "./access.js";
+import { actorSchema } from "./extension.js";
+/**
+ * Roles, in increasing power. Each holds the verbs up to its own on the ladder:
+ * viewer: view and interact; commenter: + comment; editor: + edit; owner: + manage.
+ */
+export const roleSchema = z.enum(["viewer", "commenter", "editor", "owner"]);
+export const ROLES = roleSchema.options;
+/** What anyone holding the artifact's share link gets. `none` means the link is off. */
+export const linkRoleSchema = z.enum(["none", "viewer", "commenter", "editor"]);
+/** Whether members of the artifact's space open it at their own seat role. */
+export const spaceAccessSchema = z.enum(["member", "none"]);
+const TOP_VERB = {
+    viewer: "interact",
+    commenter: "comment",
+    editor: "edit",
+    owner: "manage",
+};
+/** The verbs a role holds: always a run from the bottom of the ladder. */
+export const roleVerbs = (role) => role === null ? [] : VERBS.slice(0, VERBS.indexOf(TOP_VERB[role]) + 1);
+const rank = (role) => ROLES.indexOf(role);
+/** The highest of some roles, ignoring nulls; null when there is none. */
+export const maxRole = (...roles) => roles.reduce((best, role) => (role !== null && (best === null || rank(role) > rank(best)) ? role : best), null);
+/** The lower of two roles. */
+export const minRole = (a, b) => (rank(a) <= rank(b) ? a : b);
+/** Does `held` reach `needed`? */
+export const roleReaches = (held, needed) => rank(held) >= rank(needed);
+/**
+ * The role a principal holds on an artifact: the highest of the creator's ownership, their
+ * grant, their seat (when the space has access), and the share link (when they arrived by
+ * it). Three rules hold for every input, proven in `lean/Kernel/Sharing.lean`:
+ * an anonymous principal is at most a viewer; an agent never exceeds its cap; and removing
+ * any source of standing never raises the role.
+ */
+export const effectiveRole = (s) => {
+    const own = s.signedIn ? maxRole(s.creator ? "owner" : null, s.grant) : null;
+    const seat = s.signedIn && s.spaceAccess === "member" ? s.seat : null;
+    const linked = s.viaLink && s.linkRole !== "none" ? s.linkRole : null;
+    const link = linked !== null && !s.signedIn ? "viewer" : linked;
+    const role = maxRole(own, seat, link);
+    return role !== null && s.cap !== null ? minRole(role, s.cap) : role;
+};
+/** An artifact's sharing settings, as a manager sees them. */
+export const shareSettingsSchema = z.object({
+    spaceAccess: spaceAccessSchema,
+    linkRole: linkRoleSchema,
+    /** The share link's token; null while the link is off. Only managers see it. */
+    linkToken: z.nullable(z.string()),
+});
+export const DEFAULT_SHARE_SETTINGS = {
+    spaceAccess: "member",
+    linkRole: "none",
+    linkToken: null,
+};
+export const shareGrantSchema = z.object({ actor: actorSchema, role: roleSchema });
+export const sharingSchema = z.object({
+    settings: shareSettingsSchema,
+    grants: z.array(shareGrantSchema),
+});
+/** What this reader may do with sharing, as the server decides it: whether they may change
+ *  it at all, and the roles they may give (at most their own; owner only by an owner). */
+export const sharingAccessSchema = z.object({
+    mayShare: z.boolean(),
+    givable: z.array(roleSchema),
+});
+//# sourceMappingURL=sharing.js.map

package/dist/protocol/sharing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharing.js","sourceRoot":"","sources":["../../src/protocol/sharing.ts"],"names":[],"mappings":"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"}

package/dist/protocol/slot-map.d.ts

@@ -0,0 +1,4 @@
+import * as z from "zod/mini";
+/** Keep a JSON object schema and restore ordinary own properties after validation. */
+export declare const slotMapSchema: z.ZodMiniType<Record<string, string>>;
+//# sourceMappingURL=slot-map.d.ts.map

package/dist/protocol/slot-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot-map.d.ts","sourceRoot":"","sources":["../../src/protocol/slot-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAQ7B,sFAAsF;AACtF,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAS/D,CAAA"}

package/dist/protocol/slot-map.js

@@ -0,0 +1,10 @@
+import * as z from "zod/mini";
+/** Encode every key before record validation, which otherwise removes __proto__. */
+const encodeKeys = (value) => value !== null && typeof value === "object" && !Array.isArray(value)
+    ? Object.fromEntries(Object.entries(value).map(([key, id]) => [`slot:${key}`, id]))
+    : value;
+/** Keep a JSON object schema and restore ordinary own properties after validation. */
+export const slotMapSchema = z.pipe(z.transform(encodeKeys), z
+    .record(z.string(), z.string())
+    .check(z.overwrite((value) => Object.fromEntries(Object.entries(value).map(([key, id]) => [key.slice(5), id])))));
+//# sourceMappingURL=slot-map.js.map

package/dist/protocol/slot-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot-map.js","sourceRoot":"","sources":["../../src/protocol/slot-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAE7B,oFAAoF;AACpF,MAAM,UAAU,GAAG,CAAC,KAAc,EAAW,EAAE,CAC7C,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;IAClE,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACnF,CAAC,CAAC,KAAK,CAAA;AAEX,sFAAsF;AACtF,MAAM,CAAC,MAAM,aAAa,GAA0C,CAAC,CAAC,IAAI,CACxE,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,EACvB,CAAC;KACE,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;KAC9B,KAAK,CACJ,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CACpB,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CACjF,CACF,CACJ,CAAA"}

package/dist/protocol/source-anchors.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Isomorphic anchoring primitives — the code that MUST produce byte-identical results
+ * in the browser (against a live DOM, inside the sandboxed iframe client) and on the
+ * server (against parsed HTML descriptors). Both `anchor-client.ts` (the injected
+ * client) and `element-anchor.ts` (the server resolver) import from here, so a content
+ * fingerprint made in one place equals one made in the other BY CONSTRUCTION — not by
+ * hand-copying a vanilla-JS transcription and hoping it stays in lockstep (which drifted
+ * once: a different join separator silently broke every browser-made element anchor).
+ *
+ * Keep this file dependency-free and DOM-free so it bundles cleanly into the browser
+ * client and runs untouched on the server.
+ */
+/** Field separator inside a content fingerprint, so a value ending and the next
+ *  beginning can't blur into a collision (src "…a" + alt "b" vs src "…" + alt "ab").
+ *  A control char (U+0001) that never appears in real content. */
+export declare const FP_SEP = "\u0001";
+/** Cap on the text slice that feeds a fingerprint — enough to identify, bounded so a
+ *  huge block doesn't dominate the hash. */
+export declare const FP_TEXT_CAP = 120;
+/**
+ * FNV-1a (32-bit) → base36. A tiny, fast, dependency-free hash — we only need a stable
+ * content fingerprint, not cryptographic strength.
+ */
+export declare function fnv1a(s: string): string;
+/** Collapse runs of whitespace and trim. Used everywhere a value feeds matching. */
+export declare function normWs(s: string): string;
+/** Ellipsis-truncate to `n` chars. The one copy of the convention (cut at n-1, "…"),
+ *  shared by anchor labels, edit error copy, and version messages. */
+export declare const clip: (s: string, n: number) => string;
+/**
+ * The canonical content fingerprint over the four identifying fields. Each side pulls
+ * {tag, src, alt, text} from its own environment — a live DOM node in the browser, a
+ * parsed descriptor on the server — then calls this, so the hash ASSEMBLY (the field
+ * order, the separator, the text normalization + cap) lives in exactly one place.
+ */
+export declare function fingerprintFrom(tag: string, src: string, alt: string, text: string): string;
+/**
+ * Locate `exact` in `text` whitespace-flexibly, using `prefix`/`suffix` as CONTEXT to
+ * disambiguate a quote that repeats — then return the span of `exact` itself (not the
+ * context). An `exact` that also appears inside the prefix can't hijack the result
+ * (the capture group's own indices are read). When the context no longer matches, falls
+ * back to the bare exact only where it occurs once: a comment whose words now repeat is
+ * left unanchored rather than pinned to the wrong occurrence. Whitespace in the quote
+ * matches any run of whitespace in the text, because a selection, DOM text and HTML source
+ * each serialize the gaps between blocks differently. The one resolver every reader uses
+ * (`findQuote` in the protocol entry delegates here). Returns null if unfound or ambiguous.
+ */
+export declare function findQuoteWithContext(text: string, exact: string, prefix?: string, suffix?: string): {
+    start: number;
+    end: number;
+} | null;
+/**
+ * The STRICT context matcher for destructive callers: the context must match
+ * exactly ONCE. Two identical repeated cards produce two identical context
+ * windows — a lenient matcher would silently act on the first card when the user
+ * touched the second, so `matches > 1` reports the ambiguity for the caller to
+ * refuse. `span` is null on a miss (no context given, pattern failed, or zero
+ * matches) — pair with {@link findQuoteMatches} to accept a miss only when the
+ * exact is globally unambiguous.
+ *
+ * When the adjacent-context pattern finds nothing, one retry lets the seams between
+ * prefix|exact|suffix hold optional whitespace. A capture path can drop the space at a
+ * block edge ("Slack" + suffix "Ask in a channel" for `<h3>Slack</h3><p>Ask…`). The
+ * retry only runs on a miss and must also match exactly once, so it never changes a
+ * result the adjacent pattern already decided.
+ */
+export declare function findQuoteContextUnique(text: string, exact: string, prefix?: string, suffix?: string): {
+    span: {
+        start: number;
+        end: number;
+    } | null;
+    matches: number;
+};
+/** A DOM selection uses one context grammar for display and destructive writes. */
+export declare const findSelectionWithContext: (text: string, exact: string, prefix: string, suffix: string) => {
+    start: number;
+    end: number;
+} | null;
+/** Count with the exact display pattern. Never use a second, looser lookup for a write. */
+export declare const findSelectionContextUnique: (text: string, exact: string, prefix: string, suffix: string) => {
+    span: {
+        start: number;
+        end: number;
+    } | null;
+    matches: number;
+};
+/**
+ * Every whitespace-flexible match of `quote` in `text` (capped so a degenerate quote
+ * on a huge document stays bounded). Lets a destructive caller distinguish "matches
+ * once — safe to act on" from "matches many — ambiguous, refuse".
+ */
+export declare function findQuoteMatches(text: string, quote: string, cap?: number): {
+    start: number;
+    end: number;
+}[];
+/** The elements whose boundaries the server's page-text projection renders as
+ *  whitespace (everything else, an inline seam, renders as nothing). Shared by
+ *  anchor.ts (pageText), latex-emit.ts (which pins its mirror equal in a test) and the
+ *  in-frame client, whose edit snapshot must put a seam exactly where pageText does. */
+export declare const BLOCK_TEXT_ELEMENTS: Set<string>;
+//# sourceMappingURL=source-anchors.d.ts.map

package/dist/protocol/source-anchors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-anchors.d.ts","sourceRoot":"","sources":["../../src/protocol/source-anchors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;kEAEkE;AAClE,eAAO,MAAM,MAAM,WAAW,CAAA;AAE9B;4CAC4C;AAC5C,eAAO,MAAM,WAAW,MAAM,CAAA;AAE9B;;;GAGG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAOvC;AAED,oFAAoF;AACpF,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAExC;AAED;sEACsE;AACtE,eAAO,MAAM,IAAI,MAAO,MAAM,KAAK,MAAM,KAAG,MAAsD,CAAA;AAElG;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3F;AA4BD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAavC;AAcD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd;IAAE,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAMlE;AA+CD,mFAAmF;AACnF,eAAO,MAAM,wBAAwB,SAC7B,MAAM,SACL,MAAM,UACL,MAAM,UACN,MAAM,KACb;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAInC,CAAA;AAED,2FAA2F;AAC3F,eAAO,MAAM,0BAA0B,SAC/B,MAAM,SACL,MAAM,UACL,MAAM,UACN,MAAM,KACb;IAAE,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CACU,CAAA;AAE3E;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,GAAG,SAAK,GACP;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,CAoBlC;AAED;;;wFAGwF;AACxF,eAAO,MAAM,mBAAmB,EAAE,GAAG,CAAC,MAAM,CA4C1C,CAAA"}