@tickernelz/paperclip-pro-shared 2026.925.0

package/dist/document-anchors.test.js

@@ -0,0 +1,151 @@
+import { describe, expect, it } from "vitest";
+import { createDocumentAnchorSelector, projectMarkdownToText, remapDocumentAnchor, resolveProjectionRange, verifyDocumentAnchorSelector, } from "./document-anchors.js";
+function selectorFor(markdown, quote) {
+    const projection = projectMarkdownToText(markdown);
+    const start = projection.text.indexOf(quote);
+    expect(start).toBeGreaterThanOrEqual(0);
+    const range = resolveProjectionRange(projection, start, start + quote.length);
+    expect(range).not.toBeNull();
+    return createDocumentAnchorSelector(projection, range);
+}
+describe("document text projection", () => {
+    it("projects markdown into normalized rendered text with source ranges", () => {
+        const markdown = [
+            "# Heading",
+            "",
+            "- Ship **bold** [link text](https://example.com) and `code span`.",
+            "| Name | Value |",
+            "| --- | --- |",
+            "| Alpha | Beta |",
+        ].join("\n");
+        const projection = projectMarkdownToText(markdown);
+        expect(projection.text).toContain("Heading");
+        expect(projection.text).toContain("Ship bold link text and code span.");
+        expect(projection.text).toContain("Name Value");
+        expect(projection.text).toContain("Alpha Beta");
+        expect(projection.text).not.toContain("https://example.com");
+        expect(projection.positions).toHaveLength(projection.text.length);
+        const linkStart = projection.text.indexOf("link text");
+        const range = resolveProjectionRange(projection, linkStart, linkStart + "link text".length);
+        expect(range?.markdownStart).toBe(markdown.indexOf("link text"));
+        expect(range?.markdownEnd).toBe(markdown.indexOf("link text") + "link text".length);
+    });
+    it("normalizes whitespace while retaining markdown offsets", () => {
+        const markdown = "First   line\n\nSecond\t\tline";
+        const projection = projectMarkdownToText(markdown);
+        expect(projection.text).toBe("First line Second line");
+        const range = resolveProjectionRange(projection, projection.text.indexOf("Second"), projection.text.length);
+        expect(range?.markdownStart).toBe(markdown.indexOf("Second"));
+        expect(range?.markdownEnd).toBe(markdown.length);
+    });
+    it("preserves non-link punctuation", () => {
+        const markdown = "Keep (parenthetical) [plain brackets] visible.";
+        const projection = projectMarkdownToText(markdown);
+        expect(projection.text).toBe("Keep (parenthetical) [plain brackets] visible.");
+    });
+});
+describe("document anchor verification and remapping", () => {
+    it("verifies a selector against its base revision", () => {
+        const markdown = "Intro text with **selected text** inside.";
+        const selector = selectorFor(markdown, "selected text");
+        const result = verifyDocumentAnchorSelector({ markdown, selector });
+        expect(result.ok).toBe(true);
+        expect(result.anchor?.selectedText).toBe("selected text");
+        expect(result.anchor?.markdownStart).toBe(markdown.indexOf("selected text"));
+    });
+    it("remaps exact anchors after surrounding text moves", () => {
+        const selector = selectorFor("Alpha paragraph.\n\nTarget sentence here.\n\nOmega paragraph.", "Target sentence here.");
+        const previousAnchor = {
+            selectedText: selector.quote.exact,
+            prefixText: selector.quote.prefix,
+            suffixText: selector.quote.suffix,
+            normalizedStart: selector.position.normalizedStart,
+            normalizedEnd: selector.position.normalizedEnd,
+            markdownStart: selector.position.markdownStart,
+            markdownEnd: selector.position.markdownEnd,
+        };
+        const result = remapDocumentAnchor({
+            previousAnchor,
+            nextMarkdown: "Omega paragraph.\n\nAlpha paragraph.\n\nTarget sentence here.",
+        });
+        expect(result.anchorState).toBe("active");
+        expect(result.confidence).toBe("exact");
+        expect(result.anchor?.selectedText).toBe("Target sentence here.");
+    });
+    it("uses context and proximity to disambiguate duplicate quotes", () => {
+        const selector = selectorFor("One apple near the start.\n\nTwo apple near the end.", "apple");
+        const previousAnchor = {
+            selectedText: selector.quote.exact,
+            prefixText: selector.quote.prefix,
+            suffixText: selector.quote.suffix,
+            normalizedStart: selector.position.normalizedStart,
+            normalizedEnd: selector.position.normalizedEnd,
+            markdownStart: selector.position.markdownStart,
+            markdownEnd: selector.position.markdownEnd,
+        };
+        const result = remapDocumentAnchor({
+            previousAnchor,
+            nextMarkdown: "Zero apple elsewhere.\n\nOne apple near the start.\n\nTwo apple near the end.",
+        });
+        expect(result.anchorState).toBe("active");
+        expect(result.confidence).toBe("duplicate");
+        expect(result.anchor?.prefixText).toContain("One");
+    });
+    it("marks duplicate anchors ambiguous when context cannot distinguish them", () => {
+        const selector = selectorFor("apple apple", "apple");
+        const previousAnchor = {
+            selectedText: selector.quote.exact,
+            prefixText: "",
+            suffixText: "",
+            normalizedStart: selector.position.normalizedStart,
+            normalizedEnd: selector.position.normalizedEnd,
+            markdownStart: selector.position.markdownStart,
+            markdownEnd: selector.position.markdownEnd,
+        };
+        const result = remapDocumentAnchor({ previousAnchor, nextMarkdown: "apple apple" });
+        expect(result.anchorState).toBe("stale");
+        expect(result.confidence).toBe("ambiguous");
+    });
+    it("keeps edited anchors as stale fuzzy matches", () => {
+        const selector = selectorFor("We rely on an important launch assumption for scope.", "important launch assumption");
+        const previousAnchor = {
+            selectedText: selector.quote.exact,
+            prefixText: selector.quote.prefix,
+            suffixText: selector.quote.suffix,
+            normalizedStart: selector.position.normalizedStart,
+            normalizedEnd: selector.position.normalizedEnd,
+            markdownStart: selector.position.markdownStart,
+            markdownEnd: selector.position.markdownEnd,
+        };
+        const result = remapDocumentAnchor({
+            previousAnchor,
+            nextMarkdown: "We rely on an important product launch assumption for scope.",
+        });
+        expect(result.anchorState).toBe("stale");
+        expect(result.confidence).toBe("fuzzy");
+        expect(result.anchor?.selectedText).toBe("important product launch assumption");
+    });
+    it("marks deleted anchors orphaned and allows future remapping from the latest known anchor", () => {
+        const selector = selectorFor("Keep this reviewed phrase in mind.", "reviewed phrase");
+        const previousAnchor = {
+            selectedText: selector.quote.exact,
+            prefixText: selector.quote.prefix,
+            suffixText: selector.quote.suffix,
+            normalizedStart: selector.position.normalizedStart,
+            normalizedEnd: selector.position.normalizedEnd,
+            markdownStart: selector.position.markdownStart,
+            markdownEnd: selector.position.markdownEnd,
+        };
+        const missing = remapDocumentAnchor({ previousAnchor, nextMarkdown: "The target disappeared." });
+        const recovered = remapDocumentAnchor({
+            previousAnchor,
+            nextMarkdown: "The target came back: reviewed phrase.",
+        });
+        expect(missing.anchorState).toBe("orphaned");
+        expect(missing.confidence).toBe("missing");
+        expect(missing.anchor).toBeNull();
+        expect(recovered.anchorState).toBe("active");
+        expect(recovered.anchor?.selectedText).toBe("reviewed phrase");
+    });
+});
+//# sourceMappingURL=document-anchors.test.js.map

package/dist/document-anchors.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-anchors.test.js","sourceRoot":"","sources":["../src/document-anchors.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAE/B,SAAS,WAAW,CAAC,QAAgB,EAAE,KAAa;IAClD,MAAM,UAAU,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,CAAC,KAAK,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,sBAAsB,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9E,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;IAC7B,OAAO,4BAA4B,CAAC,UAAU,EAAE,KAAM,CAAC,CAAC;AAC1D,CAAC;AAED,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,MAAM,QAAQ,GAAG;YACf,WAAW;YACX,EAAE;YACF,mEAAmE;YACnE,kBAAkB;YAClB,eAAe;YACf,kBAAkB;SACnB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,UAAU,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAEnD,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC7C,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,oCAAoC,CAAC,CAAC;QACxE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAChD,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAChD,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;QAC7D,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAElE,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,sBAAsB,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QAC5F,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;QACjE,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,QAAQ,GAAG,gCAAgC,CAAC;QAClD,MAAM,UAAU,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAEnD,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,sBAAsB,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5G,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC9D,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,QAAQ,GAAG,gDAAgD,CAAC;QAClE,MAAM,UAAU,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAEnD,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,4CAA4C,EAAE,GAAG,EAAE;IAC1D,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,QAAQ,GAAG,2CAA2C,CAAC;QAC7D,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;QAExD,MAAM,MAAM,GAAG,4BAA4B,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;QAEpE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC1D,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,QAAQ,GAAG,WAAW,CAAC,+DAA+D,EAAE,uBAAuB,CAAC,CAAC;QACvH,MAAM,cAAc,GAAG;YACrB,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK;YAClC,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM;YACjC,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM;YACjC,eAAe,EAAE,QAAQ,CAAC,QAAQ,CAAC,eAAe;YAClD,aAAa,EAAE,QAAQ,CAAC,QAAQ,CAAC,aAAa;YAC9C,aAAa,EAAE,QAAQ,CAAC,QAAQ,CAAC,aAAa;YAC9C,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,WAAW;SAC3C,CAAC;QAEF,MAAM,MAAM,GAAG,mBAAmB,CAAC;YACjC,cAAc;YACd,YAAY,EAAE,+DAA+D;SAC9E,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,QAAQ,GAAG,WAAW,CAAC,sDAAsD,EAAE,OAAO,CAAC,CAAC;QAC9F,MAAM,cAAc,GAAG;YACrB,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK;YAClC,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM;YACjC,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM;YACjC,eAAe,EAAE,QAAQ,CAAC,QAAQ,CAAC,eAAe;YAClD,aAAa,EAAE,QAAQ,CAAC,QAAQ,CAAC,aAAa;YAC9C,aAAa,EAAE,QAAQ,CAAC,QAAQ,CAAC,aAAa;YAC9C,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,WAAW;SAC3C,CAAC;QAEF,MAAM,MAAM,GAAG,mBAAmB,CAAC;YACjC,cAAc;YACd,YAAY,EAAE,+EAA+E;SAC9F,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAChF,MAAM,QAAQ,GAAG,WAAW,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,cAAc,GAAG;YACrB,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK;YAClC,UAAU,EAAE,EAAE;YACd,UAAU,EAAE,EAAE;YACd,eAAe,EAAE,QAAQ,CAAC,QAAQ,CAAC,eAAe;YAClD,aAAa,EAAE,QAAQ,CAAC,QAAQ,CAAC,aAAa;YAC9C,aAAa,EAAE,QAAQ,CAAC,QAAQ,CAAC,aAAa;YAC9C,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,WAAW;SAC3C,CAAC;QAEF,MAAM,MAAM,GAAG,mBAAmB,CAAC,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC,CAAC;QAEpF,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,QAAQ,GAAG,WAAW,CAAC,sDAAsD,EAAE,6BAA6B,CAAC,CAAC;QACpH,MAAM,cAAc,GAAG;YACrB,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK;YAClC,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM;YACjC,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM;YACjC,eAAe,EAAE,QAAQ,CAAC,QAAQ,CAAC,eAAe;YAClD,aAAa,EAAE,QAAQ,CAAC,QAAQ,CAAC,aAAa;YAC9C,aAAa,EAAE,QAAQ,CAAC,QAAQ,CAAC,aAAa;YAC9C,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,WAAW;SAC3C,CAAC;QAEF,MAAM,MAAM,GAAG,mBAAmB,CAAC;YACjC,cAAc;YACd,YAAY,EAAE,8DAA8D;SAC7E,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yFAAyF,EAAE,GAAG,EAAE;QACjG,MAAM,QAAQ,GAAG,WAAW,CAAC,oCAAoC,EAAE,iBAAiB,CAAC,CAAC;QACtF,MAAM,cAAc,GAAG;YACrB,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK;YAClC,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM;YACjC,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM;YACjC,eAAe,EAAE,QAAQ,CAAC,QAAQ,CAAC,eAAe;YAClD,aAAa,EAAE,QAAQ,CAAC,QAAQ,CAAC,aAAa;YAC9C,aAAa,EAAE,QAAQ,CAAC,QAAQ,CAAC,aAAa;YAC9C,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,WAAW;SAC3C,CAAC;QAEF,MAAM,OAAO,GAAG,mBAAmB,CAAC,EAAE,cAAc,EAAE,YAAY,EAAE,yBAAyB,EAAE,CAAC,CAAC;QACjG,MAAM,SAAS,GAAG,mBAAmB,CAAC;YACpC,cAAc;YACd,YAAY,EAAE,wCAAwC;SACvD,CAAC,CAAC;QAEH,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3C,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;QAClC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7C,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/document-export.d.ts

@@ -0,0 +1,4 @@
+export declare function documentExportSlug(title: string): string;
+export declare function documentExportExtension(format: string | null | undefined): string;
+export declare function documentExportFileName(title: string, extension: string): string;
+//# sourceMappingURL=document-export.d.ts.map

package/dist/document-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-export.d.ts","sourceRoot":"","sources":["../src/document-export.ts"],"names":[],"mappings":"AAUA,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUxD;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAEjF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG/E"}

package/dist/document-export.js

@@ -0,0 +1,27 @@
+const DOCUMENT_EXPORT_FALLBACK_SLUG = "document";
+const DOCUMENT_EXPORT_SLUG_MAX_LENGTH = 80;
+const DOCUMENT_FORMAT_EXTENSIONS = {
+    markdown: "md",
+    html: "html",
+    json: "json",
+    text: "txt",
+};
+export function documentExportSlug(title) {
+    const slug = title
+        .normalize("NFKD")
+        .replace(/[\u0300-\u036f]/g, "")
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, DOCUMENT_EXPORT_SLUG_MAX_LENGTH)
+        .replace(/-+$/g, "");
+    return slug || DOCUMENT_EXPORT_FALLBACK_SLUG;
+}
+export function documentExportExtension(format) {
+    return DOCUMENT_FORMAT_EXTENSIONS[(format ?? "").trim().toLowerCase()] ?? "md";
+}
+export function documentExportFileName(title, extension) {
+    const normalized = extension.replace(/^\.+/, "").toLowerCase() || "md";
+    return `${documentExportSlug(title)}.${normalized}`;
+}
+//# sourceMappingURL=document-export.js.map

package/dist/document-export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-export.js","sourceRoot":"","sources":["../src/document-export.ts"],"names":[],"mappings":"AAAA,MAAM,6BAA6B,GAAG,UAAU,CAAC;AACjD,MAAM,+BAA+B,GAAG,EAAE,CAAC;AAE3C,MAAM,0BAA0B,GAA2B;IACzD,QAAQ,EAAE,IAAI;IACd,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,KAAK;CACZ,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,MAAM,IAAI,GAAG,KAAK;SACf,SAAS,CAAC,MAAM,CAAC;SACjB,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;SAC/B,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,+BAA+B,CAAC;SACzC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACvB,OAAO,IAAI,IAAI,6BAA6B,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAiC;IACvE,OAAO,0BAA0B,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,IAAI,IAAI,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAa,EAAE,SAAiB;IACrE,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC;IACvE,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,UAAU,EAAE,CAAC;AACtD,CAAC"}

package/dist/env-file.d.ts

@@ -0,0 +1,16 @@
+export type EnvValueEncoding = "minimal" | "json";
+export type UpdateEnvFileContentsOptions = {
+    valueEncoding?: EnvValueEncoding;
+};
+export declare function encodeEnvValue(value: string, encoding?: EnvValueEncoding): string;
+/**
+ * Updates only the named assignments and preserves every unrelated byte.
+ *
+ * Duplicate managed keys are intentional: every occurrence is checked and any
+ * stale occurrence is updated. Occurrences that already decode to the desired
+ * value retain their original quoting and spacing.
+ */
+export declare function updateEnvFileContents(contents: string, entries: Record<string, string>, options?: UpdateEnvFileContentsOptions): string;
+/** Writes a changed env file through a same-directory temporary file and rename. */
+export declare function writeEnvFileAtomicallyIfChanged(filePath: string, previousContents: string | null, nextContents: string): boolean;
+//# sourceMappingURL=env-file.d.ts.map

package/dist/env-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-file.d.ts","sourceRoot":"","sources":["../src/env-file.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,MAAM,CAAC;AAElD,MAAM,MAAM,4BAA4B,GAAG;IACzC,aAAa,CAAC,EAAE,gBAAgB,CAAC;CAClC,CAAC;AAUF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,gBAAyB,GAAG,MAAM,CAKzF;AA8ED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,OAAO,GAAE,4BAAiC,GACzC,MAAM,CAwCR;AAED,oFAAoF;AACpF,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,YAAY,EAAE,MAAM,GACnB,OAAO,CAqBT"}

package/dist/env-file.js

@@ -0,0 +1,149 @@
+import fs from "node:fs";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+const ENV_ASSIGNMENT_PATTERN = /^(\s*(?:export\s+)?)([A-Za-z_][A-Za-z0-9_]*)(\s*=\s*)(.*)$/;
+const MINIMAL_ENV_VALUE_PATTERN = /^[A-Za-z0-9_./:@-]+$/;
+export function encodeEnvValue(value, encoding = "json") {
+    if (encoding === "minimal" && MINIMAL_ENV_VALUE_PATTERN.test(value)) {
+        return value;
+    }
+    return JSON.stringify(value);
+}
+function trailingEnvCommentStart(rawValue) {
+    let quote = null;
+    let escaped = false;
+    for (let index = 0; index < rawValue.length; index += 1) {
+        const character = rawValue[index];
+        if (escaped) {
+            escaped = false;
+            continue;
+        }
+        if (quote === "\"" && character === "\\") {
+            escaped = true;
+            continue;
+        }
+        if (quote !== null) {
+            if (character === quote)
+                quote = null;
+            continue;
+        }
+        if (character === "\"" || character === "'") {
+            quote = character;
+            continue;
+        }
+        // dotenv treats every unquoted # as the start of a comment, even when it
+        // immediately follows the assignment separator or the value.
+        if (character !== "#")
+            continue;
+        let commentStart = index;
+        while (commentStart > 0 && /\s/.test(rawValue[commentStart - 1] ?? "")) {
+            commentStart -= 1;
+        }
+        return commentStart;
+    }
+    return null;
+}
+function parseComparableEnvValue(rawValue) {
+    const commentStart = trailingEnvCommentStart(rawValue);
+    const encodedValue = rawValue.slice(0, commentStart ?? rawValue.length).trim();
+    if (encodedValue === "")
+        return "";
+    if (encodedValue.startsWith("\"") && encodedValue.endsWith("\"")) {
+        try {
+            const parsed = JSON.parse(encodedValue);
+            return typeof parsed === "string" ? parsed : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    if (encodedValue.startsWith("'") && encodedValue.endsWith("'")) {
+        return encodedValue.slice(1, -1);
+    }
+    return encodedValue;
+}
+function splitEnvLines(contents) {
+    const lines = [];
+    const newlinePattern = /\r\n|\n|\r/g;
+    let lineStart = 0;
+    let match;
+    while ((match = newlinePattern.exec(contents)) !== null) {
+        lines.push({
+            contents: contents.slice(lineStart, match.index),
+            ending: match[0],
+        });
+        lineStart = newlinePattern.lastIndex;
+    }
+    if (lineStart < contents.length || contents.length === 0) {
+        lines.push({ contents: contents.slice(lineStart), ending: "" });
+    }
+    return lines;
+}
+/**
+ * Updates only the named assignments and preserves every unrelated byte.
+ *
+ * Duplicate managed keys are intentional: every occurrence is checked and any
+ * stale occurrence is updated. Occurrences that already decode to the desired
+ * value retain their original quoting and spacing.
+ */
+export function updateEnvFileContents(contents, entries, options = {}) {
+    const valueEncoding = options.valueEncoding ?? "json";
+    const missingEntries = new Map(Object.entries(entries));
+    const lines = splitEnvLines(contents);
+    for (const line of lines) {
+        const match = line.contents.match(ENV_ASSIGNMENT_PATTERN);
+        if (!match)
+            continue;
+        const [, prefix, key, separator, rawValue] = match;
+        const value = entries[key];
+        if (value === undefined)
+            continue;
+        missingEntries.delete(key);
+        if (parseComparableEnvValue(rawValue) === value)
+            continue;
+        const commentStart = trailingEnvCommentStart(rawValue);
+        const trailingComment = commentStart === null ? "" : rawValue.slice(commentStart);
+        line.contents = `${prefix}${key}${separator}${encodeEnvValue(value, valueEncoding)}${trailingComment}`;
+    }
+    if (missingEntries.size > 0) {
+        const newline = lines.find((line) => line.ending.length > 0)?.ending ?? "\n";
+        const insertedLines = Array.from(missingEntries, ([key, value]) => ({
+            contents: `${key}=${encodeEnvValue(value, valueEncoding)}`,
+            ending: newline,
+        }));
+        const trailingBlankIndex = lines.at(-1)?.contents === "" ? lines.length - 1 : lines.length;
+        if (trailingBlankIndex === lines.length && lines.length > 0) {
+            const previousLine = lines.at(-1);
+            if (previousLine.ending === "") {
+                previousLine.ending = newline;
+                insertedLines.at(-1).ending = "";
+            }
+        }
+        lines.splice(trailingBlankIndex, 0, ...insertedLines);
+    }
+    return lines.map((line) => `${line.contents}${line.ending}`).join("");
+}
+/** Writes a changed env file through a same-directory temporary file and rename. */
+export function writeEnvFileAtomicallyIfChanged(filePath, previousContents, nextContents) {
+    if (previousContents === nextContents)
+        return false;
+    const directory = path.dirname(filePath);
+    fs.mkdirSync(directory, { recursive: true });
+    const temporaryPath = path.join(directory, `.${path.basename(filePath)}.${process.pid}.${randomUUID()}.tmp`);
+    try {
+        fs.writeFileSync(temporaryPath, nextContents, { encoding: "utf8", mode: 0o600, flag: "wx" });
+        fs.renameSync(temporaryPath, filePath);
+        fs.chmodSync(filePath, 0o600);
+    }
+    catch (error) {
+        try {
+            fs.unlinkSync(temporaryPath);
+        }
+        catch {
+            // The temporary file may not have been created or may already have been renamed.
+        }
+        throw error;
+    }
+    return true;
+}
+//# sourceMappingURL=env-file.js.map

package/dist/env-file.js.map

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

package/dist/env-file.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=env-file.test.d.ts.map

package/dist/env-file.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-file.test.d.ts","sourceRoot":"","sources":["../src/env-file.test.ts"],"names":[],"mappings":""}

package/dist/env-file.test.js

@@ -0,0 +1,72 @@
+import { describe, expect, it } from "vitest";
+import { encodeEnvValue, updateEnvFileContents } from "./env-file.js";
+describe("env file editor", () => {
+    it("pins minimal and JSON value encoding", () => {
+        expect(encodeEnvValue("plain-value", "minimal")).toBe("plain-value");
+        expect(encodeEnvValue("#439edb", "minimal")).toBe('"#439edb"');
+        expect(encodeEnvValue("plain-value", "json")).toBe('"plain-value"');
+    });
+    it("preserves unrelated content and CRLF while updating every stale duplicate", () => {
+        const original = [
+            "# operator comment",
+            "UNKNOWN='keep this encoding'",
+            "",
+            "export PAPERCLIP_HOME = '/old path'  # managed path",
+            "PAPERCLIP_DUPLICATE=stale",
+            'PAPERCLIP_DUPLICATE="current"',
+            "TRAILING=untouched",
+            "",
+        ].join("\r\n");
+        const updated = updateEnvFileContents(original, {
+            PAPERCLIP_HOME: "/new path",
+            PAPERCLIP_DUPLICATE: "current",
+            PAPERCLIP_WORKTREE_COLOR: "#439edb",
+        }, { valueEncoding: "minimal" });
+        expect(updated).toBe([
+            "# operator comment",
+            "UNKNOWN='keep this encoding'",
+            "",
+            'export PAPERCLIP_HOME = "/new path"  # managed path',
+            "PAPERCLIP_DUPLICATE=current",
+            'PAPERCLIP_DUPLICATE="current"',
+            "TRAILING=untouched",
+            'PAPERCLIP_WORKTREE_COLOR="#439edb"',
+            "",
+        ].join("\r\n"));
+        expect(updated.replaceAll("\r\n", "")).not.toContain("\n");
+    });
+    it("uses JSON encoding for changed values without re-encoding current assignments", () => {
+        const original = [
+            "PAPERCLIP_CURRENT=plain-value",
+            "PAPERCLIP_CHANGED=old",
+            "UNKNOWN=\"operator value\"",
+            "",
+        ].join("\n");
+        expect(updateEnvFileContents(original, {
+            PAPERCLIP_CURRENT: "plain-value",
+            PAPERCLIP_CHANGED: "new",
+            PAPERCLIP_ADDED: "added",
+        }, { valueEncoding: "json" })).toBe([
+            "PAPERCLIP_CURRENT=plain-value",
+            'PAPERCLIP_CHANGED="new"',
+            'UNKNOWN="operator value"',
+            'PAPERCLIP_ADDED="added"',
+            "",
+        ].join("\n"));
+    });
+    it("does not treat an unquoted dotenv comment as the managed value", () => {
+        expect(updateEnvFileContents(["PAPERCLIP_COLOR=#439edb", "PAPERCLIP_HOME=old# keep this comment"].join("\n"), {
+            PAPERCLIP_COLOR: "#439edb",
+            PAPERCLIP_HOME: "new",
+        }, { valueEncoding: "minimal" })).toBe(['PAPERCLIP_COLOR="#439edb"#439edb', "PAPERCLIP_HOME=new# keep this comment"].join("\n"));
+    });
+    it("is a no-op when every managed duplicate is already current", () => {
+        const original = [
+            "export PAPERCLIP_HOME = '/same path' # first",
+            'PAPERCLIP_HOME="/same path"',
+            "UNKNOWN=value",
+        ].join("\n");
+        expect(updateEnvFileContents(original, { PAPERCLIP_HOME: "/same path" })).toBe(original);
+    });
+});
+//# sourceMappingURL=env-file.test.js.map

package/dist/env-file.test.js.map

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

package/dist/environment-custom-images.d.ts

@@ -0,0 +1,17 @@
+export declare const REDACTED_ENVIRONMENT_CUSTOM_IMAGE_VALUE = "[redacted]";
+export declare function redactEnvironmentCustomImageValue<T>(value: T): T;
+export interface EnvironmentCustomImageTemplateRedactionInput {
+    templateRef?: string | null;
+    sourceTemplateRef?: string | null;
+    metadata?: Record<string, unknown> | null;
+}
+export declare function redactEnvironmentCustomImageTemplate<T extends EnvironmentCustomImageTemplateRedactionInput>(template: T): T;
+export interface EnvironmentCustomImageSetupSessionRedactionInput {
+    providerLeaseId?: string | null;
+    baseTemplateRef?: string | null;
+    connectionSecretRef?: string | null;
+    connectionSummary?: Record<string, unknown> | null;
+    metadata?: Record<string, unknown> | null;
+}
+export declare function redactEnvironmentCustomImageSetupSession<T extends EnvironmentCustomImageSetupSessionRedactionInput>(session: T): T;
+//# sourceMappingURL=environment-custom-images.d.ts.map

package/dist/environment-custom-images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-custom-images.d.ts","sourceRoot":"","sources":["../src/environment-custom-images.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uCAAuC,eAAe,CAAC;AAsCpE,wBAAgB,iCAAiC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAgBhE;AAED,MAAM,WAAW,4CAA4C;IAC3D,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC3C;AAED,wBAAgB,oCAAoC,CAClD,CAAC,SAAS,4CAA4C,EACtD,QAAQ,EAAE,CAAC,GAAG,CAAC,CAWhB;AAED,MAAM,WAAW,gDAAgD;IAC/D,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC3C;AAED,wBAAgB,wCAAwC,CACtD,CAAC,SAAS,gDAAgD,EAC1D,OAAO,EAAE,CAAC,GAAG,CAAC,CA2Bf"}

package/dist/environment-custom-images.js

@@ -0,0 +1,88 @@
+export const REDACTED_ENVIRONMENT_CUSTOM_IMAGE_VALUE = "[redacted]";
+const SENSITIVE_KEY_PATTERNS = [
+    /auth/i,
+    /credential/i,
+    /host/i,
+    /ip/i,
+    /^key$/i,
+    /lease/i,
+    /password/i,
+    /private.?key/i,
+    /sandbox.?id/i,
+    /secret/i,
+    /template.?ref/i,
+    /token/i,
+    /url/i,
+];
+const IPV4_PATTERN = /\b(?:\d{1,3}\.){3}\d{1,3}\b/;
+const SSH_COMMAND_PATTERN = /\bssh\s+[-\w@.:/]+\b/i;
+function isPlainRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isSensitiveKey(key) {
+    if (key.endsWith("Redacted"))
+        return false;
+    return SENSITIVE_KEY_PATTERNS.some((pattern) => pattern.test(key));
+}
+function redactSensitivePrimitive(value) {
+    if (typeof value !== "string")
+        return value;
+    if (IPV4_PATTERN.test(value) || SSH_COMMAND_PATTERN.test(value)) {
+        return REDACTED_ENVIRONMENT_CUSTOM_IMAGE_VALUE;
+    }
+    return value;
+}
+export function redactEnvironmentCustomImageValue(value) {
+    if (Array.isArray(value)) {
+        return value.map((entry) => redactEnvironmentCustomImageValue(entry));
+    }
+    if (!isPlainRecord(value)) {
+        return redactSensitivePrimitive(value);
+    }
+    const redacted = {};
+    for (const [key, entry] of Object.entries(value)) {
+        redacted[key] = isSensitiveKey(key)
+            ? REDACTED_ENVIRONMENT_CUSTOM_IMAGE_VALUE
+            : redactEnvironmentCustomImageValue(entry);
+    }
+    return redacted;
+}
+export function redactEnvironmentCustomImageTemplate(template) {
+    return {
+        ...template,
+        templateRef: template.templateRef == null ? template.templateRef : REDACTED_ENVIRONMENT_CUSTOM_IMAGE_VALUE,
+        sourceTemplateRef: template.sourceTemplateRef == null
+            ? template.sourceTemplateRef
+            : REDACTED_ENVIRONMENT_CUSTOM_IMAGE_VALUE,
+        metadata: template.metadata == null
+            ? template.metadata
+            : redactEnvironmentCustomImageValue(template.metadata),
+    };
+}
+export function redactEnvironmentCustomImageSetupSession(session) {
+    const connectionSummary = session.connectionSummary == null
+        ? session.connectionSummary
+        : {
+            ...redactEnvironmentCustomImageValue(session.connectionSummary),
+            ...(Object.prototype.hasOwnProperty.call(session.connectionSummary, "username")
+                ? { username: REDACTED_ENVIRONMENT_CUSTOM_IMAGE_VALUE }
+                : {}),
+        };
+    return {
+        ...session,
+        providerLeaseId: session.providerLeaseId == null
+            ? session.providerLeaseId
+            : REDACTED_ENVIRONMENT_CUSTOM_IMAGE_VALUE,
+        baseTemplateRef: session.baseTemplateRef == null
+            ? session.baseTemplateRef
+            : REDACTED_ENVIRONMENT_CUSTOM_IMAGE_VALUE,
+        connectionSecretRef: session.connectionSecretRef == null
+            ? session.connectionSecretRef
+            : REDACTED_ENVIRONMENT_CUSTOM_IMAGE_VALUE,
+        connectionSummary,
+        metadata: session.metadata == null
+            ? session.metadata
+            : redactEnvironmentCustomImageValue(session.metadata),
+    };
+}
+//# sourceMappingURL=environment-custom-images.js.map

package/dist/environment-custom-images.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-custom-images.js","sourceRoot":"","sources":["../src/environment-custom-images.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uCAAuC,GAAG,YAAY,CAAC;AAEpE,MAAM,sBAAsB,GAAG;IAC7B,OAAO;IACP,aAAa;IACb,OAAO;IACP,KAAK;IACL,QAAQ;IACR,QAAQ;IACR,WAAW;IACX,eAAe;IACf,cAAc;IACd,SAAS;IACT,gBAAgB;IAChB,QAAQ;IACR,MAAM;CACP,CAAC;AAEF,MAAM,YAAY,GAAG,6BAA6B,CAAC;AACnD,MAAM,mBAAmB,GAAG,uBAAuB,CAAC;AAEpD,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,cAAc,CAAC,GAAW;IACjC,IAAI,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAc;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,OAAO,uCAAuC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAI,KAAQ;IAC3D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,iCAAiC,CAAC,KAAK,CAAC,CAAM,CAAC;IAC7E,CAAC;IAED,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,wBAAwB,CAAC,KAAK,CAAM,CAAC;IAC9C,CAAC;IAED,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,QAAQ,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,GAAG,CAAC;YACjC,CAAC,CAAC,uCAAuC;YACzC,CAAC,CAAC,iCAAiC,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,QAAa,CAAC;AACvB,CAAC;AAQD,MAAM,UAAU,oCAAoC,CAElD,QAAW;IACX,OAAO;QACL,GAAG,QAAQ;QACX,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,uCAAuC;QAC1G,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB,IAAI,IAAI;YACnD,CAAC,CAAC,QAAQ,CAAC,iBAAiB;YAC5B,CAAC,CAAC,uCAAuC;QAC3C,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,IAAI;YACjC,CAAC,CAAC,QAAQ,CAAC,QAAQ;YACnB,CAAC,CAAC,iCAAiC,CAAC,QAAQ,CAAC,QAAQ,CAAC;KACzD,CAAC;AACJ,CAAC;AAUD,MAAM,UAAU,wCAAwC,CAEtD,OAAU;IACV,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,IAAI;QACzD,CAAC,CAAC,OAAO,CAAC,iBAAiB;QAC3B,CAAC,CAAC;YACE,GAAG,iCAAiC,CAAC,OAAO,CAAC,iBAAiB,CAAC;YAC/D,GAAG,CACD,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,UAAU,CAAC;gBACzE,CAAC,CAAC,EAAE,QAAQ,EAAE,uCAAuC,EAAE;gBACvD,CAAC,CAAC,EAAE,CACP;SACF,CAAC;IACN,OAAO;QACL,GAAG,OAAO;QACV,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,IAAI;YAC9C,CAAC,CAAC,OAAO,CAAC,eAAe;YACzB,CAAC,CAAC,uCAAuC;QAC3C,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,IAAI;YAC9C,CAAC,CAAC,OAAO,CAAC,eAAe;YACzB,CAAC,CAAC,uCAAuC;QAC3C,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,IAAI,IAAI;YACtD,CAAC,CAAC,OAAO,CAAC,mBAAmB;YAC7B,CAAC,CAAC,uCAAuC;QAC3C,iBAAiB;QACjB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;YAChC,CAAC,CAAC,OAAO,CAAC,QAAQ;YAClB,CAAC,CAAC,iCAAiC,CAAC,OAAO,CAAC,QAAQ,CAAC;KACxD,CAAC;AACJ,CAAC"}

package/dist/environment-custom-images.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=environment-custom-images.test.d.ts.map

package/dist/environment-custom-images.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-custom-images.test.d.ts","sourceRoot":"","sources":["../src/environment-custom-images.test.ts"],"names":[],"mappings":""}