@dogsbay/commands 0.2.0-beta.101

package/dist/commands/refactor-files.js

@@ -0,0 +1,264 @@
+/**
+ * File-level refactor commands: rename-file, safe-delete,
+ * extract-include. Reuse-safe by construction — every mutation is an
+ * index lookup plus surgical text edits, and inbound references are
+ * rewritten in the same run (see edits.ts).
+ */
+import { z } from "zod";
+import { fenceOpenBefore } from "@dogsbay/format-dogsbay-md";
+import { dirname } from "@dogsbay/format-topicmap";
+import { normalizeStoragePath } from "../storage.js";
+import { relativeHref, replaceLinkHrefs, replaceIncludePaths, replaceMapHref, rewriteInboundRefs, splitFrontmatter, } from "../edits.js";
+import { defineCommand } from "../engine.js";
+import { contentHash } from "./content.js";
+const fail = (code, message, file) => ({
+    data: { applied: false },
+    issues: [{ severity: "error", code, message, ...(file ? { file } : {}) }],
+    summary: message,
+});
+/** Unrewritable references become warnings — never a silent miss. */
+export const missIssues = (misses) => misses.map((ref) => ({
+    severity: "warning",
+    code: "reference-not-rewritten",
+    message: `${ref.kind} reference "${ref.raw}" could not be located for rewriting — update it manually`,
+    file: ref.from,
+}));
+const isExternal = (href) => /^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(href);
+/** Batched replaceMapHref with the same anti-cross-talk placeholders. */
+const replaceMapHrefs = (source, pairs) => {
+    let out = source;
+    const entries = [...pairs.entries()];
+    entries.forEach(([oldHref], i) => {
+        out = replaceMapHref(out, oldHref, "\u0000" + i + "\u0000");
+    });
+    entries.forEach(([, newHref], i) => {
+        out = out.split("\u0000" + i + "\u0000").join(newHref);
+    });
+    return out;
+};
+export const renameFileCommand = defineCommand({
+    name: "rename-file",
+    writes: "structure",
+    description: "Move/rename a file and rewrite every inbound reference (links, includes, topic maps)",
+    input: z
+        .object({
+        from: z.string().min(1).describe("Current workspace-relative path"),
+        to: z.string().min(1).describe("New workspace-relative path"),
+    })
+        .strict(),
+    positionals: ["from", "to"],
+    async run(ctx, input) {
+        const from = normalizeStoragePath(input.from);
+        const to = normalizeStoragePath(input.to);
+        const { storage } = ctx.workspace;
+        if (from === to)
+            return fail("rename-noop", "from and to are the same path");
+        if (!(await storage.exists(from)))
+            return fail("rename-source-missing", `${from} does not exist`);
+        if (await storage.exists(to))
+            return fail("rename-target-exists", `${to} already exists`);
+        const index = await ctx.workspace.index();
+        let content = await storage.read(from);
+        // The moved doc's own outbound references keep pointing at their
+        // (unmoved) targets from the file's NEW location
+        const doc = index.docs.get(from);
+        if (doc) {
+            const newDir = dirname(to);
+            const linkPairs = new Map();
+            for (const link of doc.links) {
+                if (!link.target || link.href.startsWith("#"))
+                    continue;
+                const target = link.target === from ? to : link.target;
+                const fragment = link.fragment ? `#${link.fragment}` : "";
+                const newHref = relativeHref(newDir, target) + fragment;
+                if (newHref !== link.href)
+                    linkPairs.set(link.href, newHref);
+            }
+            content = replaceLinkHrefs(content, linkPairs);
+            const includePairs = new Map();
+            for (const include of doc.includes) {
+                const newPath = relativeHref(newDir, include.target);
+                if (newPath !== include.raw)
+                    includePairs.set(include.raw, newPath);
+            }
+            content = replaceIncludePaths(content, includePairs);
+        }
+        // A moved topic map or keys file must keep addressing ITS targets
+        // from the new location — rebase its own href entries too
+        const movedMap = index.maps.get(from);
+        if (movedMap && dirname(to) !== dirname(from)) {
+            const pairs = new Map();
+            for (const ref of movedMap.refs) {
+                if (!ref.target)
+                    continue;
+                const newHref = relativeHref(dirname(to), ref.target);
+                if (newHref !== ref.href)
+                    pairs.set(ref.href, newHref);
+            }
+            content = replaceMapHrefs(content, pairs);
+        }
+        const ownKeyDefs = [...index.keys.values()].flat().filter((def) => def.file === from);
+        if (ownKeyDefs.length > 0 && dirname(to) !== dirname(from)) {
+            const pairs = new Map();
+            for (const def of ownKeyDefs) {
+                const href = def.def.href;
+                if (typeof href !== "string" || isExternal(href))
+                    continue;
+                const target = normalizeStoragePath(`${dirname(from)}/${href}`);
+                const newHref = relativeHref(dirname(to), target);
+                if (newHref !== href)
+                    pairs.set(href, newHref);
+            }
+            content = replaceMapHrefs(content, pairs);
+        }
+        const { changed, misses } = await rewriteInboundRefs(ctx.workspace, index, from, (ref) => {
+            const fragment = ref.fragment ? `#${ref.fragment}` : "";
+            return relativeHref(dirname(ref.from), to) + fragment;
+        });
+        const issues = missIssues(misses);
+        // Key definitions addressing the moved file follow it — the key
+        // keeps resolving (safe-delete treats these as referrers; so do we)
+        const keyEditsByFile = new Map();
+        for (const defs of index.keys.values()) {
+            for (const def of defs) {
+                if (def.file === from)
+                    continue; // rebased above, moves with the file
+                const href = def.def.href;
+                if (typeof href !== "string" || isExternal(href))
+                    continue;
+                if (normalizeStoragePath(`${dirname(def.file)}/${href}`) !== from)
+                    continue;
+                const pairs = keyEditsByFile.get(def.file) ?? new Map();
+                pairs.set(href, relativeHref(dirname(def.file), to));
+                keyEditsByFile.set(def.file, pairs);
+            }
+        }
+        for (const [keysFile, pairs] of keyEditsByFile) {
+            const source = await storage.read(keysFile);
+            const updated = replaceMapHrefs(source, pairs);
+            if (updated !== source) {
+                await storage.write(keysFile, updated);
+                changed.push(keysFile);
+            }
+        }
+        await storage.write(to, content);
+        await storage.delete(from);
+        ctx.workspace.invalidate();
+        return {
+            data: { applied: true, from, to, rewrittenFiles: changed },
+            issues,
+            summary: `${from} → ${to} (${changed.length} referencing file(s) updated)`,
+        };
+    },
+});
+export const safeDeleteCommand = defineCommand({
+    name: "safe-delete",
+    writes: "structure",
+    description: "Delete a file only when nothing references it (links, includes, topic maps, keys)",
+    input: z
+        .object({
+        file: z.string().min(1).describe("Workspace-relative path to delete"),
+        force: z.boolean().optional().describe("Delete even when referenced (referrers become issues)"),
+    })
+        .strict(),
+    positionals: ["file"],
+    async run(ctx, input) {
+        const file = normalizeStoragePath(input.file);
+        const { storage } = ctx.workspace;
+        if (!(await storage.exists(file)))
+            return fail("delete-source-missing", `${file} does not exist`);
+        const index = await ctx.workspace.index();
+        const referrers = (index.inbound.get(file) ?? []).map((ref) => ({
+            severity: input.force ? "warning" : "error",
+            code: input.force ? "delete-broke-reference" : "delete-blocked",
+            message: `${ref.kind} reference "${ref.raw}" targets ${file}`,
+            file: ref.from,
+        }));
+        // Key definitions pointing at the file block deletion too
+        for (const defs of index.keys.values()) {
+            for (const def of defs) {
+                const href = def.def.href;
+                if (typeof href !== "string" || /^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(href))
+                    continue;
+                const resolved = normalizeStoragePath(`${dirname(def.file)}/${href}`);
+                if (resolved === file) {
+                    referrers.push({
+                        severity: input.force ? "warning" : "error",
+                        code: input.force ? "delete-broke-reference" : "delete-blocked",
+                        message: `key "${def.name}" href targets ${file}`,
+                        file: def.file,
+                    });
+                }
+            }
+        }
+        if (referrers.length > 0 && !input.force) {
+            return {
+                data: { applied: false, referrers: referrers.length },
+                issues: referrers,
+                summary: `${file} is referenced ${referrers.length} time(s) — not deleted (use --force to override)`,
+            };
+        }
+        await storage.delete(file);
+        ctx.workspace.invalidate();
+        return {
+            data: { applied: true, file, brokenReferences: referrers.length },
+            issues: referrers,
+            summary: referrers.length > 0
+                ? `${file} deleted — ${referrers.length} reference(s) now broken`
+                : `${file} deleted (no references)`,
+        };
+    },
+});
+export const extractIncludeCommand = defineCommand({
+    name: "extract-include",
+    writes: "content",
+    description: "Extract a line range into a reusable snippet and replace it with {% include %}",
+    input: z
+        .object({
+        file: z.string().min(1).describe("Workspace-relative .md path"),
+        start: z.number().int().min(1).describe("First line of the range (1-based, inclusive)"),
+        end: z.number().int().min(1).describe("Last line of the range (1-based, inclusive)"),
+        snippet: z.string().min(1).describe("Workspace-relative path for the new snippet file"),
+        expect: z.string().optional().describe("Divergence gate: the file's `fileHash` from topic-read (a LINE RANGE is only meaningful against the text it was read from)"),
+    })
+        .strict(),
+    positionals: ["file"],
+    async run(ctx, input) {
+        const file = normalizeStoragePath(input.file);
+        const snippet = normalizeStoragePath(input.snippet);
+        const { storage } = ctx.workspace;
+        if (!(await storage.exists(file)))
+            return fail("extract-source-missing", `${file} does not exist`);
+        if (await storage.exists(snippet))
+            return fail("extract-snippet-exists", `${snippet} already exists`);
+        const content = await storage.read(file);
+        if (input.expect !== undefined && input.expect !== contentHash(content)) {
+            return fail("stale-expect", `${file} changed since it was read; the line range no longer means what it did. Re-read it with topic-read.`, file);
+        }
+        const lines = content.split("\n");
+        if (input.end < input.start || input.end > lines.length) {
+            return fail("extract-range-invalid", `line range ${input.start}..${input.end} is out of bounds (${lines.length} lines)`, file);
+        }
+        // The frontmatter block is metadata, not extractable content
+        const [frontmatterBlock] = splitFrontmatter(content);
+        const frontmatterLines = frontmatterBlock === "" ? 0 : frontmatterBlock.split("\n").length - 1;
+        if (input.start <= frontmatterLines) {
+            return fail("extract-range-in-frontmatter", `line range ${input.start}..${input.end} overlaps the frontmatter block (lines 1..${frontmatterLines})`, file);
+        }
+        const openBefore = fenceOpenBefore(content);
+        if (openBefore[input.start - 1] || openBefore[input.end]) {
+            return fail("extract-range-splits-fence", `line range ${input.start}..${input.end} starts or ends inside a code fence`, file);
+        }
+        const extracted = lines.slice(input.start - 1, input.end);
+        const include = `{% include "${relativeHref(dirname(file), snippet)}" %}`;
+        const updated = [...lines.slice(0, input.start - 1), include, ...lines.slice(input.end)];
+        await storage.write(snippet, `${extracted.join("\n").replace(/\s+$/, "")}\n`);
+        await storage.write(file, updated.join("\n"));
+        ctx.workspace.invalidate();
+        return {
+            data: { applied: true, file, snippet, lines: extracted.length },
+            summary: `${extracted.length} line(s) → ${snippet}, replaced with an include`,
+        };
+    },
+});
+//# sourceMappingURL=refactor-files.js.map

package/dist/commands/refactor-files.js.map

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

package/dist/commands/refactor-keys.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Key-space refactor commands: rename-key, keyify.
+ *
+ * Documents are edited through the prose walk (editMarkdownProse), so
+ * `key:` links and `{{ var }}` examples inside code fences/spans are
+ * never rewritten. Keys files are edited TEXTUALLY first (comments and
+ * unrelated content survive); only when the textual edit can't locate
+ * the entry does the YAML load/dump fallback run — with a warning,
+ * because dump normalizes formatting and drops comments.
+ */
+import { z } from "zod";
+export declare const renameKeyCommand: import("../engine.js").CommandDef<z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+}, z.core.$strict>>;
+export declare const keyifyCommand: import("../engine.js").CommandDef<z.ZodObject<{
+    file: z.ZodString;
+    key: z.ZodString;
+    keysFile: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>>;
+//# sourceMappingURL=refactor-keys.d.ts.map

package/dist/commands/refactor-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refactor-keys.d.ts","sourceRoot":"","sources":["../../src/commands/refactor-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0BxB,eAAO,MAAM,gBAAgB;;;mBAyF3B,CAAC;AAEH,eAAO,MAAM,aAAa;;;;mBA4GxB,CAAC"}

package/dist/commands/refactor-keys.js

@@ -0,0 +1,224 @@
+/**
+ * Key-space refactor commands: rename-key, keyify.
+ *
+ * Documents are edited through the prose walk (editMarkdownProse), so
+ * `key:` links and `{{ var }}` examples inside code fences/spans are
+ * never rewritten. Keys files are edited TEXTUALLY first (comments and
+ * unrelated content survive); only when the textual edit can't locate
+ * the entry does the YAML load/dump fallback run — with a warning,
+ * because dump normalizes formatting and drops comments.
+ */
+import { z } from "zod";
+import { load as loadYaml, dump as dumpYaml } from "js-yaml";
+import { dirname } from "@dogsbay/format-topicmap";
+import { normalizeStoragePath } from "../storage.js";
+import { relativeHref, editMarkdownProse } from "../edits.js";
+import { defineCommand } from "../engine.js";
+const fail = (code, message, file) => ({
+    data: { applied: false },
+    issues: [{ severity: "error", code, message, ...(file ? { file } : {}) }],
+    summary: message,
+});
+const escapeRegExp = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+/**
+ * Rename a key's entry line in a keys file, preserving everything else
+ * (comments included). Matches the generated two-space/tab indent
+ * convention; returns null when the entry can't be located textually.
+ */
+const renameKeyEntryLine = (source, from, to) => {
+    const entryRe = new RegExp(`^((?:  |\\t))${escapeRegExp(from)}:(?=\\s|$)`, "m");
+    if (!entryRe.test(source))
+        return null;
+    return source.replace(entryRe, `$1${to}:`);
+};
+export const renameKeyCommand = defineCommand({
+    name: "rename-key",
+    writes: "structure",
+    description: "Rename a key across keys files, key: links, and {{ variable }} references",
+    input: z
+        .object({
+        from: z.string().min(1).describe("Current key name"),
+        to: z.string().min(1).describe("New key name"),
+    })
+        .strict(),
+    positionals: ["from", "to"],
+    async run(ctx, { from, to }) {
+        const index = await ctx.workspace.index();
+        const defs = index.keys.get(from);
+        if (!defs || defs.length === 0)
+            return fail("key-undefined", `key "${from}" is not defined`);
+        if (index.keys.has(to))
+            return fail("key-conflict", `key "${to}" already exists`);
+        const { storage } = ctx.workspace;
+        const issues = [];
+        // Definitions: textual entry rename first (comments survive);
+        // YAML round-trip only as a flagged fallback
+        const defFiles = [...new Set(defs.map((def) => def.file))];
+        for (const file of defFiles) {
+            const source = await storage.read(file);
+            const textual = renameKeyEntryLine(source, from, to);
+            if (textual !== null) {
+                await storage.write(file, textual);
+                continue;
+            }
+            const raw = loadYaml(source);
+            const newKeys = {};
+            for (const [name, def] of Object.entries(raw?.keys ?? {})) {
+                newKeys[name === from ? to : name] = def;
+            }
+            await storage.write(file, dumpYaml({ keys: newKeys }));
+            issues.push({
+                severity: "warning",
+                code: "keys-file-normalized",
+                message: `"${from}" could not be renamed textually — ${file} was rewritten via YAML round-trip (comments/formatting lost)`,
+                file,
+            });
+        }
+        // key: links in documents (prose only — fenced examples untouched)
+        const linkRe = new RegExp(`\\]\\(\\s*key:${escapeRegExp(from)}(?=[#)\\s])`, "g");
+        const updatedDocs = [];
+        for (const docPath of index.keyUses.get(from) ?? []) {
+            const source = await storage.read(docPath);
+            const updated = editMarkdownProse(source, (prose) => prose.replace(linkRe, (match) => match.replace(`key:${from}`, `key:${to}`)));
+            if (updated !== source) {
+                await storage.write(docPath, updated);
+                updatedDocs.push(docPath);
+            }
+        }
+        // {{ from }} minja text references (the TEXT-key reuse form the DITA
+        // importer emits). Variable names are shared with build attributes,
+        // so renames here are flagged for a human sanity check.
+        const varRe = new RegExp(`\\{\\{\\s*${escapeRegExp(from)}\\s*\\}\\}`, "g");
+        let variableRefs = 0;
+        for (const doc of index.docs.values()) {
+            const source = await storage.read(doc.path);
+            const updated = editMarkdownProse(source, (prose) => {
+                const matches = prose.match(varRe);
+                if (matches)
+                    variableRefs += matches.length;
+                return prose.replace(varRe, `{{ ${to} }}`);
+            });
+            if (updated !== source) {
+                await storage.write(doc.path, updated);
+                if (!updatedDocs.includes(doc.path))
+                    updatedDocs.push(doc.path);
+            }
+        }
+        if (variableRefs > 0) {
+            issues.push({
+                severity: "warning",
+                code: "key-variable-renamed",
+                message: `renamed ${variableRefs} {{ ${from} }} reference(s) — verify they referred to this key, not a build attribute of the same name`,
+            });
+        }
+        ctx.workspace.invalidate();
+        return {
+            data: { applied: true, from, to, definitionFiles: defFiles, updatedDocs, variableRefs },
+            issues,
+            summary: `key "${from}" → "${to}" (${defFiles.length} keys file(s), ${updatedDocs.length} doc(s))`,
+        };
+    },
+});
+export const keyifyCommand = defineCommand({
+    name: "keyify",
+    writes: "structure",
+    description: "Give a file a key and convert inbound direct links to key: references",
+    input: z
+        .object({
+        file: z.string().min(1).describe("Workspace-relative file the key should address"),
+        key: z.string().min(1).describe("Key name to define"),
+        keysFile: z
+            .string()
+            .optional()
+            .describe("Keys file to define it in (default: first existing keys file, else keys.yaml)"),
+    })
+        .strict(),
+    positionals: ["file", "key"],
+    async run(ctx, input) {
+        const file = normalizeStoragePath(input.file);
+        const { storage } = ctx.workspace;
+        if (!(await storage.exists(file)))
+            return fail("keyify-target-missing", `${file} does not exist`);
+        const index = await ctx.workspace.index();
+        const issues = [];
+        // Where does the definition live?
+        const existingKeysFiles = [...new Set([...index.keys.values()].flat().map((d) => d.file))].sort();
+        const keysFile = normalizeStoragePath(input.keysFile ?? existingKeysFiles[0] ?? "keys.yaml");
+        const keyHref = relativeHref(dirname(keysFile), file);
+        const existing = index.keys.get(input.key);
+        if (existing && existing.length > 0) {
+            const currentHref = existing[0].def.href;
+            const resolves = typeof currentHref === "string" &&
+                normalizeStoragePath(`${dirname(existing[0].file)}/${currentHref}`) === file;
+            if (!resolves) {
+                return fail("key-conflict", `key "${input.key}" already exists in ${existing[0].file} and does not address ${file}`);
+            }
+        }
+        else if (await storage.exists(keysFile)) {
+            // Insert textually right under the `keys:` table line so
+            // hand-authored comments and siblings survive
+            const source = await storage.read(keysFile);
+            const tableLine = source.match(/^keys:[ \t]*$/m);
+            if (tableLine && tableLine.index !== undefined) {
+                const insertAt = tableLine.index + tableLine[0].length;
+                const entry = `\n  ${input.key}:\n    href: ${keyHref}`;
+                await storage.write(keysFile, source.slice(0, insertAt) + entry + source.slice(insertAt));
+            }
+            else {
+                const raw = loadYaml(source)?.keys ?? {};
+                raw[input.key] = { href: keyHref };
+                await storage.write(keysFile, dumpYaml({ keys: raw }));
+                issues.push({
+                    severity: "warning",
+                    code: "keys-file-normalized",
+                    message: `no plain "keys:" table line found — ${keysFile} was rewritten via YAML round-trip (comments/formatting lost)`,
+                    file: keysFile,
+                });
+            }
+        }
+        else {
+            await storage.write(keysFile, `keys:\n  ${input.key}:\n    href: ${keyHref}\n`);
+        }
+        // Inbound direct links become key: references. Fragment links and
+        // includes/topic-map entries are left alone (keys address whole
+        // resources), each with a note so nothing is silently skipped.
+        const updatedDocs = [];
+        const byFile = new Map();
+        for (const ref of index.inbound.get(file) ?? []) {
+            if (ref.kind !== "link") {
+                continue; // images/includes/topic maps keep direct paths
+            }
+            if (ref.fragment) {
+                issues.push({
+                    severity: "warning",
+                    code: "keyify-fragment-skipped",
+                    message: `link "${ref.raw}" targets an anchor — key references address whole files; left as a direct link`,
+                    file: ref.from,
+                });
+                continue;
+            }
+            const list = byFile.get(ref.from) ?? [];
+            list.push({ raw: ref.raw });
+            byFile.set(ref.from, list);
+        }
+        for (const [docPath, refs] of byFile) {
+            const source = await storage.read(docPath);
+            let updated = source;
+            for (const ref of refs) {
+                const re = new RegExp(`\\]\\(\\s*${escapeRegExp(ref.raw)}(?=[)\\s])`, "g");
+                updated = editMarkdownProse(updated, (prose) => prose.replace(re, (match) => match.replace(ref.raw, `key:${input.key}`)));
+            }
+            if (updated !== source) {
+                await storage.write(docPath, updated);
+                updatedDocs.push(docPath);
+            }
+        }
+        ctx.workspace.invalidate();
+        return {
+            data: { applied: true, file, key: input.key, keysFile, keyHref, updatedDocs },
+            issues,
+            summary: `key "${input.key}" → ${file} (${updatedDocs.length} doc(s) now use key: links)`,
+        };
+    },
+});
+//# sourceMappingURL=refactor-keys.js.map

package/dist/commands/refactor-keys.js.map

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

package/dist/commands/refactor-structure.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Structural refactor commands: split-topic, merge-topics.
+ *
+ * Both operate line-wise with the shared fence grammar (a `## heading`
+ * inside a code example is never structure), then reindex and repair
+ * inbound references so links keep landing after the surgery. What
+ * cannot be repaired mechanically is issued, never silently dropped.
+ */
+import { z } from "zod";
+export declare const splitTopicCommand: import("../engine.js").CommandDef<z.ZodObject<{
+    file: z.ZodString;
+    expect: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>>;
+export declare const mergeTopicsCommand: import("../engine.js").CommandDef<z.ZodObject<{
+    into: z.ZodString;
+    sources: z.ZodArray<z.ZodString>;
+    expect: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>>;
+//# sourceMappingURL=refactor-structure.d.ts.map

package/dist/commands/refactor-structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refactor-structure.d.ts","sourceRoot":"","sources":["../../src/commands/refactor-structure.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2BxB,eAAO,MAAM,iBAAiB;;;mBAwH5B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;mBA4K7B,CAAC"}