@bendyline/squisq 1.2.2 → 1.4.0

package/dist/__tests__/iconResolve.test.js

@@ -0,0 +1,99 @@
+import { describe, it, expect } from 'vitest';
+import { resolveIcon, canonicalIconToken, looksLikeIconToken, suggestIcons, } from '../icons/resolve';
+describe('resolveIcon — bare tokens', () => {
+    it('resolves a name that is unique across families', () => {
+        // `github` only exists in fa-brands.
+        const icon = resolveIcon('github');
+        expect(icon).not.toBeNull();
+        expect(icon.family).toBe('brands');
+        expect(icon.name).toBe('github');
+    });
+    it('returns null for a name that collides across families', () => {
+        // `user` ships in both solid and regular — bare form is ambiguous.
+        const icon = resolveIcon('user');
+        expect(icon).toBeNull();
+    });
+    it('returns null for unknown names', () => {
+        expect(resolveIcon('totallyMadeUp_____Name')).toBeNull();
+    });
+});
+describe('resolveIcon — qualified tokens', () => {
+    it('resolves an ambiguous name with the fa-solid: prefix', () => {
+        const icon = resolveIcon('fa-solid:user');
+        expect(icon).not.toBeNull();
+        expect(icon.family).toBe('solid');
+        expect(icon.name).toBe('user');
+    });
+    it('resolves the same name in the other family', () => {
+        const icon = resolveIcon('fa-regular:user');
+        expect(icon).not.toBeNull();
+        expect(icon.family).toBe('regular');
+    });
+    it('accepts short family prefixes too', () => {
+        const icon = resolveIcon('brands:github');
+        expect(icon).not.toBeNull();
+        expect(icon.family).toBe('brands');
+    });
+    it('returns null for an unknown family prefix', () => {
+        expect(resolveIcon('fa-foo:github')).toBeNull();
+    });
+    it('returns null for a qualified token whose name does not exist in that family', () => {
+        expect(resolveIcon('fa-brands:user')).toBeNull();
+    });
+});
+describe('canonicalIconToken', () => {
+    it('emits the bare form for unique names', () => {
+        const icon = resolveIcon('github');
+        expect(canonicalIconToken(icon)).toBe('github');
+    });
+    it('emits the qualified form for ambiguous names', () => {
+        const icon = resolveIcon('fa-solid:user');
+        expect(canonicalIconToken(icon)).toBe('fa-solid:user');
+    });
+});
+describe('suggestIcons', () => {
+    it('ranks "starts with" matches above "contains" matches', () => {
+        const results = suggestIcons('git');
+        // `github` (brands) starts with "git" → score 0; `digital-tachograph`
+        // contains "git" → score 1. The first must outrank the latter.
+        const githubIdx = results.findIndex((r) => r.entry.name === 'github');
+        const containsIdx = results.findIndex((r) => r.entry.name.includes('git') && !r.entry.name.startsWith('git'));
+        expect(githubIdx).toBeGreaterThanOrEqual(0);
+        if (containsIdx >= 0) {
+            expect(githubIdx).toBeLessThan(containsIdx);
+        }
+    });
+    it('returns canonical tokens (bare when unique, qualified otherwise)', () => {
+        const results = suggestIcons('user');
+        const userTokens = results.filter((r) => r.entry.name === 'user').map((r) => r.token);
+        // `user` is ambiguous — each match must be qualified.
+        expect(userTokens.every((t) => t.startsWith('fa-'))).toBe(true);
+    });
+    it('matches by keyword too', () => {
+        const results = suggestIcons('octocat'); // a github keyword
+        expect(results.some((r) => r.entry.name === 'github')).toBe(true);
+    });
+    it('honors the limit parameter', () => {
+        expect(suggestIcons('e', 5)).toHaveLength(5);
+    });
+    it('returns nothing useful for whitespace-only queries', () => {
+        // Empty / whitespace queries return the first N icons (score 3
+        // bucket) — useful as a "browse the catalog" affordance in pickers.
+        const results = suggestIcons('   ', 10);
+        expect(results).toHaveLength(10);
+        expect(results.every((r) => r.score === 3)).toBe(true);
+    });
+});
+describe('looksLikeIconToken', () => {
+    it('accepts alphanumeric tokens with hyphens, underscores, and one colon', () => {
+        expect(looksLikeIconToken('github')).toBe(true);
+        expect(looksLikeIconToken('fa-solid:user')).toBe(true);
+        expect(looksLikeIconToken('face-smile_wink')).toBe(true);
+    });
+    it('rejects whitespace and special characters', () => {
+        expect(looksLikeIconToken('hello world')).toBe(false);
+        expect(looksLikeIconToken('with/slash')).toBe(false);
+        expect(looksLikeIconToken('with$dollar')).toBe(false);
+    });
+});
+//# sourceMappingURL=iconResolve.test.js.map

package/dist/__tests__/iconResolve.test.js.map

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

package/dist/__tests__/imageEditState.test.d.ts

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

package/dist/__tests__/imageEditState.test.d.ts.map

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

package/dist/__tests__/imageEditState.test.js

@@ -0,0 +1,61 @@
+import { describe, it, expect } from 'vitest';
+import { createEmptyImageEditDoc, addLayer, removeLayer, reorderLayer, updateLayer, setCanvas, } from '../imageEdit/state';
+function textLayer(id, text = 'hi') {
+    return {
+        id,
+        type: 'text',
+        position: { x: 0, y: 0, width: 100, height: 30 },
+        content: { text, style: { fontSize: 16, color: '#000' } },
+    };
+}
+describe('imageEdit/state helpers', () => {
+    it('createEmptyImageEditDoc seeds canvas + meta', () => {
+        const doc = createEmptyImageEditDoc(800, 600, { sourcePath: 'src.png' });
+        expect(doc.version).toBe(1);
+        expect(doc.canvas).toEqual({ width: 800, height: 600, background: 'transparent' });
+        expect(doc.layers).toEqual([]);
+        expect(doc.meta?.sourcePath).toBe('src.png');
+        expect(doc.meta?.createdAt).toBeDefined();
+        expect(doc.meta?.updatedAt).toBeDefined();
+    });
+    it('addLayer appends and assigns id when missing', () => {
+        let doc = createEmptyImageEditDoc(100, 100);
+        doc = addLayer(doc, textLayer('a'));
+        doc = addLayer(doc, { ...textLayer(''), id: '' });
+        expect(doc.layers).toHaveLength(2);
+        expect(doc.layers[0].id).toBe('a');
+        expect(doc.layers[1].id).toMatch(/^layer-/);
+    });
+    it('removeLayer drops by id, no-op when missing', () => {
+        let doc = addLayer(createEmptyImageEditDoc(100, 100), textLayer('a'));
+        doc = addLayer(doc, textLayer('b'));
+        const after = removeLayer(doc, 'a');
+        expect(after.layers.map((l) => l.id)).toEqual(['b']);
+        const noop = removeLayer(after, 'missing');
+        expect(noop).toBe(after);
+    });
+    it('reorderLayer moves and clamps index', () => {
+        let doc = createEmptyImageEditDoc(100, 100);
+        for (const id of ['a', 'b', 'c'])
+            doc = addLayer(doc, textLayer(id));
+        const moved = reorderLayer(doc, 'a', 99);
+        expect(moved.layers.map((l) => l.id)).toEqual(['b', 'c', 'a']);
+        const moved2 = reorderLayer(moved, 'a', -10);
+        expect(moved2.layers.map((l) => l.id)).toEqual(['a', 'b', 'c']);
+    });
+    it('updateLayer shallow-merges by id', () => {
+        let doc = addLayer(createEmptyImageEditDoc(100, 100), textLayer('a'));
+        doc = updateLayer(doc, 'a', { name: 'Title', opacity: 0.5 });
+        expect(doc.layers[0].name).toBe('Title');
+        expect(doc.layers[0].opacity).toBe(0.5);
+    });
+    it('setCanvas replaces canvas', () => {
+        const doc = setCanvas(createEmptyImageEditDoc(100, 100), {
+            width: 200,
+            height: 300,
+            background: '#fff',
+        });
+        expect(doc.canvas).toEqual({ width: 200, height: 300, background: '#fff' });
+    });
+});
+//# sourceMappingURL=imageEditState.test.js.map

package/dist/__tests__/imageEditState.test.js.map

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

package/dist/__tests__/imageEditVersions.test.d.ts

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

package/dist/__tests__/imageEditVersions.test.d.ts.map

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

package/dist/__tests__/imageEditVersions.test.js

@@ -0,0 +1,141 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { MemoryContentContainer } from '../storage/ContentContainer';
+import { scopeContainer } from '../storage/ScopedContentContainer';
+import { createEmptyImageEditDoc, addLayer } from '../imageEdit/state';
+import { writeImageEditDoc, readImageEditDoc } from '../imageEdit/persistence';
+import { saveImageEditVersion, listImageEditVersions, readImageEditVersion, revertToImageEditVersion, pruneImageEditVersions, } from '../imageEdit/versions';
+import { ImageEditVersionManager } from '../imageEdit/ImageEditVersionManager';
+const text = (id) => ({
+    id,
+    type: 'text',
+    position: { x: 0, y: 0 },
+    content: { text: id, style: { fontSize: 16, color: '#000' } },
+});
+describe('imageEdit/persistence', () => {
+    it('round-trips state.json', async () => {
+        const sidecar = scopeContainer(new MemoryContentContainer(), 'image_files');
+        const doc = addLayer(createEmptyImageEditDoc(640, 480), text('a'));
+        await writeImageEditDoc(sidecar, doc);
+        const read = await readImageEditDoc(sidecar);
+        expect(read?.canvas.width).toBe(640);
+        expect(read?.layers).toHaveLength(1);
+        expect(read?.layers[0].id).toBe('a');
+    });
+    it('returns null when state.json is missing', async () => {
+        const sidecar = scopeContainer(new MemoryContentContainer(), 'sc');
+        expect(await readImageEditDoc(sidecar)).toBeNull();
+    });
+    it('rejects unsupported schema version', async () => {
+        const sidecar = scopeContainer(new MemoryContentContainer(), 'sc');
+        await sidecar.writeFile('state.json', new TextEncoder().encode(JSON.stringify({ version: 2, canvas: { width: 1, height: 1 }, layers: [] })));
+        await expect(readImageEditDoc(sidecar)).rejects.toThrow(/unsupported schema version/);
+    });
+});
+describe('imageEdit/versions', () => {
+    let parent;
+    let sidecar;
+    beforeEach(() => {
+        parent = new MemoryContentContainer();
+        sidecar = scopeContainer(parent, 'image_files');
+    });
+    it('saves a snapshot when state.json exists', async () => {
+        const doc = addLayer(createEmptyImageEditDoc(100, 100), text('a'));
+        await writeImageEditDoc(sidecar, doc);
+        const result = await saveImageEditVersion(sidecar, { now: new Date('2026-04-01T10:00:00Z') });
+        expect(result.saved).toBe(true);
+        expect(result.version?.path).toMatch(/^\.versions\/state\.\d{8}T\d{6}Z\.json$/);
+        // snapshot is inside the sidecar, visible to the parent under the prefix
+        expect(await parent.exists(`image_files/${result.version.path}`)).toBe(true);
+    });
+    it('returns no-state when sidecar is empty', async () => {
+        const result = await saveImageEditVersion(sidecar);
+        expect(result).toEqual({ saved: false, version: null, reason: 'no-state' });
+    });
+    it('skips saving when content is unchanged', async () => {
+        const doc = createEmptyImageEditDoc(100, 100, { now: new Date('2026-01-01') });
+        await writeImageEditDoc(sidecar, doc);
+        const first = await saveImageEditVersion(sidecar, {
+            doc,
+            now: new Date('2026-04-01T10:00:00Z'),
+        });
+        expect(first.saved).toBe(true);
+        const second = await saveImageEditVersion(sidecar, {
+            doc,
+            now: new Date('2026-04-01T10:01:00Z'),
+        });
+        expect(second).toEqual({ saved: false, version: null, reason: 'unchanged' });
+    });
+    it('appends a collision suffix when saves land in the same second', async () => {
+        const same = new Date('2026-04-01T10:00:00Z');
+        const docA = addLayer(createEmptyImageEditDoc(100, 100), text('a'));
+        const docB = addLayer(createEmptyImageEditDoc(100, 100), text('b'));
+        const r1 = await saveImageEditVersion(sidecar, { doc: docA, now: same });
+        const r2 = await saveImageEditVersion(sidecar, { doc: docB, now: same });
+        expect(r1.saved).toBe(true);
+        expect(r2.saved).toBe(true);
+        expect(r1.version.path).not.toBe(r2.version.path);
+        expect(r2.version.path).toMatch(/-2\.json$/);
+    });
+    it('lists versions newest-first', async () => {
+        await saveImageEditVersion(sidecar, {
+            doc: addLayer(createEmptyImageEditDoc(100, 100), text('a')),
+            now: new Date('2026-01-01T00:00:00Z'),
+        });
+        await saveImageEditVersion(sidecar, {
+            doc: addLayer(createEmptyImageEditDoc(100, 100), text('b')),
+            now: new Date('2026-02-01T00:00:00Z'),
+        });
+        const versions = await listImageEditVersions(sidecar);
+        expect(versions).toHaveLength(2);
+        expect(versions[0].timestamp.getUTCFullYear()).toBe(2026);
+        expect(versions[0].timestamp.getUTCMonth()).toBe(1); // Feb
+    });
+    it('readImageEditVersion returns the parsed snapshot', async () => {
+        const doc = addLayer(createEmptyImageEditDoc(100, 100), text('a'));
+        const result = await saveImageEditVersion(sidecar, {
+            doc,
+            now: new Date('2026-03-01T00:00:00Z'),
+        });
+        const read = await readImageEditVersion(sidecar, result.version);
+        expect(read?.layers[0].id).toBe('a');
+    });
+    it('revertToImageEditVersion restores state.json and snapshots current first', async () => {
+        const docA = addLayer(createEmptyImageEditDoc(100, 100), text('a'));
+        await writeImageEditDoc(sidecar, docA);
+        const v1 = await saveImageEditVersion(sidecar, {
+            doc: docA,
+            now: new Date('2026-01-01T00:00:00Z'),
+        });
+        const docB = addLayer(createEmptyImageEditDoc(100, 100), text('b'));
+        await writeImageEditDoc(sidecar, docB);
+        const result = await revertToImageEditVersion(sidecar, v1.version);
+        expect(result.reverted).toBe(true);
+        expect(result.snapshotted).not.toBeNull();
+        const current = await readImageEditDoc(sidecar);
+        expect(current?.layers[0].id).toBe('a');
+    });
+    it('pruneImageEditVersions keep-last-n drops older snapshots', async () => {
+        for (let i = 0; i < 5; i++) {
+            await saveImageEditVersion(sidecar, {
+                doc: addLayer(createEmptyImageEditDoc(100, 100), text(`v${i}`)),
+                now: new Date(`2026-01-0${i + 1}T00:00:00Z`),
+            });
+        }
+        const deleted = await pruneImageEditVersions(sidecar, { type: 'keep-last-n', n: 2 });
+        expect(deleted).toHaveLength(3);
+        const remaining = await listImageEditVersions(sidecar);
+        expect(remaining).toHaveLength(2);
+    });
+});
+describe('ImageEditVersionManager', () => {
+    it('mirrors operations against the captured container', async () => {
+        const sidecar = scopeContainer(new MemoryContentContainer(), 'image_files');
+        const mgr = new ImageEditVersionManager(sidecar);
+        const doc = addLayer(createEmptyImageEditDoc(100, 100), text('a'));
+        await writeImageEditDoc(sidecar, doc);
+        const r = await mgr.saveVersion({ now: new Date('2026-04-01T00:00:00Z') });
+        expect(r.saved).toBe(true);
+        expect((await mgr.listVersions())[0].path).toBe(r.version.path);
+    });
+});
+//# sourceMappingURL=imageEditVersions.test.js.map

package/dist/__tests__/imageEditVersions.test.js.map

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

package/dist/__tests__/inferDocumentTitle.test.d.ts

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

package/dist/__tests__/inferDocumentTitle.test.d.ts.map

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

package/dist/__tests__/inferDocumentTitle.test.js

@@ -0,0 +1,42 @@
+import { describe, expect, it } from 'vitest';
+import { parseMarkdown } from '../markdown/parse.js';
+import { inferDocumentTitle } from '../markdown/utils.js';
+describe('inferDocumentTitle', () => {
+    it('returns the frontmatter title when set', () => {
+        const doc = parseMarkdown('---\ntitle: My Doc\n---\n\n# Heading\n');
+        expect(inferDocumentTitle(doc)).toBe('My Doc');
+    });
+    it('trims surrounding whitespace from frontmatter title', () => {
+        const doc = parseMarkdown('---\ntitle: "  Spaced  "\n---\n\n# Heading\n');
+        expect(inferDocumentTitle(doc)).toBe('Spaced');
+    });
+    it('falls back to the first H1 when frontmatter title is absent', () => {
+        const doc = parseMarkdown('# Welcome\n\n## Details');
+        expect(inferDocumentTitle(doc)).toBe('Welcome');
+    });
+    it('falls back to the first H2 when no H1 is present', () => {
+        const doc = parseMarkdown('## Section\n\n### Detail');
+        expect(inferDocumentTitle(doc)).toBe('Section');
+    });
+    it('prefers the shallowest heading regardless of source order', () => {
+        const doc = parseMarkdown('## Earlier H2\n\n# Real Title\n\n### Nested');
+        expect(inferDocumentTitle(doc)).toBe('Real Title');
+    });
+    it('skips empty frontmatter title and falls back to headings', () => {
+        const doc = parseMarkdown('---\ntitle: ""\n---\n\n# Real\n');
+        expect(inferDocumentTitle(doc)).toBe('Real');
+    });
+    it('returns undefined when there is no frontmatter and no heading', () => {
+        const doc = parseMarkdown('Just a paragraph.\n\nAnother one.');
+        expect(inferDocumentTitle(doc)).toBeUndefined();
+    });
+    it('strips inline formatting from heading text', () => {
+        const doc = parseMarkdown('# **Bold** and *italic*');
+        expect(inferDocumentTitle(doc)).toBe('Bold and italic');
+    });
+    it('skips headings that contain only whitespace', () => {
+        const doc = parseMarkdown('#  \n\n## Real Heading');
+        expect(inferDocumentTitle(doc)).toBe('Real Heading');
+    });
+});
+//# sourceMappingURL=inferDocumentTitle.test.js.map

package/dist/__tests__/inferDocumentTitle.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inferDocumentTitle.test.js","sourceRoot":"","sources":["../../src/__tests__/inferDocumentTitle.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,GAAG,GAAG,aAAa,CAAC,wCAAwC,CAAC,CAAC;QACpE,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,GAAG,GAAG,aAAa,CAAC,8CAA8C,CAAC,CAAC;QAC1E,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,GAAG,GAAG,aAAa,CAAC,yBAAyB,CAAC,CAAC;QACrD,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,GAAG,GAAG,aAAa,CAAC,0BAA0B,CAAC,CAAC;QACtD,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,GAAG,GAAG,aAAa,CAAC,6CAA6C,CAAC,CAAC;QACzE,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,GAAG,GAAG,aAAa,CAAC,iCAAiC,CAAC,CAAC;QAC7D,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,GAAG,GAAG,aAAa,CAAC,mCAAmC,CAAC,CAAC;QAC/D,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,GAAG,GAAG,aAAa,CAAC,yBAAyB,CAAC,CAAC;QACrD,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,GAAG,GAAG,aAAa,CAAC,wBAAwB,CAAC,CAAC;QACpD,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/jsonForm.chooseControl.test.d.ts

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

package/dist/__tests__/jsonForm.chooseControl.test.d.ts.map

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

package/dist/__tests__/jsonForm.chooseControl.test.js

@@ -0,0 +1,74 @@
+import { describe, it, expect } from 'vitest';
+import { chooseControl, primaryType, arrayItemKind } from '../jsonForm/index.js';
+describe('chooseControl', () => {
+    it('honors explicit squisq.control', () => {
+        expect(chooseControl({ type: 'string', squisq: { control: 'radio' } })).toBe('radio');
+    });
+    it('maps format=color', () => {
+        expect(chooseControl({ type: 'string', format: 'color' })).toBe('color');
+    });
+    it('maps format=date / time / date-time / markdown / textarea', () => {
+        expect(chooseControl({ type: 'string', format: 'date' })).toBe('date');
+        expect(chooseControl({ type: 'string', format: 'time' })).toBe('time');
+        expect(chooseControl({ type: 'string', format: 'date-time' })).toBe('datetime');
+        expect(chooseControl({ type: 'string', format: 'markdown' })).toBe('richtext');
+        expect(chooseControl({ type: 'string', format: 'textarea' })).toBe('multiline');
+    });
+    it('uses segmented for short enums (≤4)', () => {
+        expect(chooseControl({ type: 'string', enum: ['a', 'b', 'c'] })).toBe('segmented');
+        expect(chooseControl({ type: 'string', enum: ['a', 'b', 'c', 'd'] })).toBe('segmented');
+    });
+    it('uses combobox for long enums (>4)', () => {
+        expect(chooseControl({ type: 'string', enum: ['a', 'b', 'c', 'd', 'e'] })).toBe('combobox');
+    });
+    it('arrays of objects → card-stack', () => {
+        expect(chooseControl({ type: 'array', items: { type: 'object', properties: {} } })).toBe('card-stack');
+    });
+    it('arrays of primitives → chip-bin', () => {
+        expect(chooseControl({ type: 'array', items: { type: 'string' } })).toBe('chip-bin');
+    });
+    it('booleans → toggle', () => {
+        expect(chooseControl({ type: 'boolean' })).toBe('toggle');
+    });
+    it('numbers with both min and max → slider', () => {
+        expect(chooseControl({ type: 'number', minimum: 0, maximum: 100 })).toBe('slider');
+    });
+    it('numbers without bounded range → stepper', () => {
+        expect(chooseControl({ type: 'number' })).toBe('stepper');
+        expect(chooseControl({ type: 'integer', minimum: 0 })).toBe('stepper');
+    });
+    it('strings with maxLength > 200 → multiline', () => {
+        expect(chooseControl({ type: 'string', maxLength: 500 })).toBe('multiline');
+    });
+    it('plain strings → text', () => {
+        expect(chooseControl({ type: 'string' })).toBe('text');
+    });
+    it('objects → group', () => {
+        expect(chooseControl({ type: 'object', properties: {} })).toBe('group');
+    });
+    it('oneOf / anyOf → tabs', () => {
+        expect(chooseControl({ oneOf: [{ type: 'string' }, { type: 'number' }] })).toBe('tabs');
+        expect(chooseControl({ anyOf: [{ type: 'string' }, { type: 'number' }] })).toBe('tabs');
+    });
+});
+describe('primaryType', () => {
+    it('returns the lone type', () => {
+        expect(primaryType({ type: 'string' })).toBe('string');
+    });
+    it('skips null in nullable shorthand', () => {
+        expect(primaryType({ type: ['string', 'null'] })).toBe('string');
+        expect(primaryType({ type: ['null', 'integer'] })).toBe('integer');
+    });
+});
+describe('arrayItemKind', () => {
+    it('detects object items', () => {
+        expect(arrayItemKind({ type: 'array', items: { type: 'object' } })).toBe('object');
+    });
+    it('detects primitive items', () => {
+        expect(arrayItemKind({ type: 'array', items: { type: 'string' } })).toBe('primitive');
+    });
+    it('treats missing items as primitive', () => {
+        expect(arrayItemKind({ type: 'array' })).toBe('primitive');
+    });
+});
+//# sourceMappingURL=jsonForm.chooseControl.test.js.map

package/dist/__tests__/jsonForm.chooseControl.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonForm.chooseControl.test.js","sourceRoot":"","sources":["../../src/__tests__/jsonForm.chooseControl.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEjF,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QAC3B,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvE,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvE,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAChF,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC/E,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACnF,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CACtF,YAAY,CACb,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QAC3B,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrF,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1D,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iBAAiB,EAAE,GAAG,EAAE;QACzB,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxF,MAAM,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjE,MAAM,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrF,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxF,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/jsonForm.evaluateWhen.test.d.ts

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

package/dist/__tests__/jsonForm.evaluateWhen.test.d.ts.map

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

package/dist/__tests__/jsonForm.evaluateWhen.test.js

@@ -0,0 +1,51 @@
+import { describe, it, expect } from 'vitest';
+import { evaluateWhen, resolveFlag } from '../jsonForm/index.js';
+const data = {
+    user: { role: 'admin', name: 'Alex' },
+    count: 3,
+    active: true,
+    tags: ['a', 'b'],
+};
+describe('evaluateWhen', () => {
+    it('equals — primitives', () => {
+        expect(evaluateWhen({ field: 'user.role', equals: 'admin' }, data)).toBe(true);
+        expect(evaluateWhen({ field: 'user.role', equals: 'guest' }, data)).toBe(false);
+    });
+    it('equals — arrays via deep equality', () => {
+        expect(evaluateWhen({ field: 'tags', equals: ['a', 'b'] }, data)).toBe(true);
+        expect(evaluateWhen({ field: 'tags', equals: ['a'] }, data)).toBe(false);
+    });
+    it('oneOf', () => {
+        expect(evaluateWhen({ field: 'count', oneOf: [1, 2, 3] }, data)).toBe(true);
+        expect(evaluateWhen({ field: 'count', oneOf: [10, 20] }, data)).toBe(false);
+    });
+    it('matches regex', () => {
+        expect(evaluateWhen({ field: 'user.name', matches: '^Al' }, data)).toBe(true);
+        expect(evaluateWhen({ field: 'user.name', matches: '^Bo' }, data)).toBe(false);
+    });
+    it('matches: returns false for non-string targets', () => {
+        expect(evaluateWhen({ field: 'count', matches: '\\d' }, data)).toBe(false);
+    });
+    it('truthy', () => {
+        expect(evaluateWhen({ field: 'active', truthy: true }, data)).toBe(true);
+        expect(evaluateWhen({ field: 'active', truthy: false }, data)).toBe(false);
+        expect(evaluateWhen({ field: 'missing', truthy: false }, data)).toBe(true);
+    });
+    it('default behavior with no operator: field is defined', () => {
+        expect(evaluateWhen({ field: 'count' }, data)).toBe(true);
+        expect(evaluateWhen({ field: 'missing' }, data)).toBe(false);
+    });
+});
+describe('resolveFlag', () => {
+    it('passes through literal booleans', () => {
+        expect(resolveFlag(true, data)).toBe(true);
+        expect(resolveFlag(false, data)).toBe(false);
+    });
+    it('returns false for undefined', () => {
+        expect(resolveFlag(undefined, data)).toBe(false);
+    });
+    it('evaluates SquisqWhen', () => {
+        expect(resolveFlag({ field: 'user.role', equals: 'admin' }, data)).toBe(true);
+    });
+});
+//# sourceMappingURL=jsonForm.evaluateWhen.test.js.map

package/dist/__tests__/jsonForm.evaluateWhen.test.js.map

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

package/dist/__tests__/jsonForm.inferSchema.test.d.ts

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

package/dist/__tests__/jsonForm.inferSchema.test.d.ts.map

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

package/dist/__tests__/jsonForm.inferSchema.test.js

@@ -0,0 +1,23 @@
+import { describe, it, expect } from 'vitest';
+import { inferSchema } from '../jsonForm/index.js';
+describe('inferSchema', () => {
+    it('infers an object schema from a sample', () => {
+        const schema = inferSchema({ name: 'Alex', age: 30, active: true });
+        expect(schema.type).toBe('object');
+        expect(schema.properties?.name?.type).toBe('string');
+        expect(schema.properties?.age?.type).toBe('integer');
+        expect(schema.properties?.active?.type).toBe('boolean');
+    });
+    it('infers array item types', () => {
+        const schema = inferSchema({ tags: ['a', 'b', 'c'] });
+        const items = schema.properties?.tags?.items;
+        const first = Array.isArray(items) ? items[0] : items;
+        expect(first?.type).toBe('string');
+    });
+    it('merges multiple samples', () => {
+        const schema = inferSchema({ name: 'Alex' }, { additionalSamples: [{ name: 'Bo', age: 5 }] });
+        expect(schema.properties?.name?.type).toBe('string');
+        expect(schema.properties?.age?.type).toBe('integer');
+    });
+});
+//# sourceMappingURL=jsonForm.inferSchema.test.js.map

package/dist/__tests__/jsonForm.inferSchema.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonForm.inferSchema.test.js","sourceRoot":"","sources":["../../src/__tests__/jsonForm.inferSchema.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,KAAK,CAAC;QAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACtD,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,iBAAiB,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9F,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/jsonForm.pointer.test.d.ts

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

package/dist/__tests__/jsonForm.pointer.test.d.ts.map

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