@canonical/pragma-cli 0.33.0 → 0.35.0

package/dist/src/kernel/completion/templates/bash.js

@@ -0,0 +1,209 @@
+// biome-ignore-all lint/suspicious/noTemplateCurlyInString: bash parameter expansions, not JS templates
+/**
+ * The bash completion script (static tier). Requires bash >= 4 for `mapfile`.
+ * That floor is NOT guaranteed by the platform any more: the package dropped
+ * its `os: ["linux"]` pin when it stopped shipping a linux-x64 executable, and
+ * macOS still ships bash 3.2, which has no `mapfile`. `setup completions`
+ * writes this script wherever it is asked to; on such a machine the user's
+ * remedy is a newer bash (zsh and fish are unaffected and are the platform
+ * defaults there).
+ *
+ * Structure — nouns, verbs, flag names, enum values — is inlined into
+ * generator-validated LITERAL `compgen -W` tables (never a variable, never
+ * anything `compgen -W` could evaluate). File params use native `compgen -f`.
+ * Only `{kind:"names"}` contexts exec the CLI: `mapfile` ingests
+ * `pragma __complete` output line-by-line, so candidates are never
+ * word-split or evaluated. That exec is gated by `minChars` (structure + enum
+ * values still complete on bare TAB with zero exec). No `eval`, no backticks,
+ * `--` guards throughout.
+ */
+import { globalFlagNames, globalValueFlags, hasOwnFlags, nounNames, offeredFlagNames, rootFlagNames, valueFlagNames, verbViews, wordList, } from "./shared.js";
+/** A shell-safe function-name base for the bin (`pragma` -> `_pragma`). */
+function fnBase(binName) {
+    return `_${binName.replace(/[^A-Za-z0-9_]/g, "_")}`;
+}
+/** The bash action completing a value source, or undefined for `none`. */
+function sourceAction(source, fn) {
+    switch (source.kind) {
+        case "values":
+            return `COMPREPLY=($(compgen -W "${wordList(source.values, "bash values")}" -- "$cur"))`;
+        case "files":
+            return 'COMPREPLY=($(compgen -f -- "$cur"))';
+        case "names":
+            return `${fn}_dynamic`;
+        case "none":
+            return undefined;
+    }
+}
+/** The `noun/verb/--flag` case arms answering flag-value contexts. */
+function flagValueArms(model, fn) {
+    const arms = [];
+    for (const view of verbViews(model)) {
+        for (const flag of view.verb.flags) {
+            if (!flag.takesValue)
+                continue;
+            const action = sourceAction(flag.source, fn);
+            // A known value flag with nothing to offer still returns silently, so
+            // its value slot is never mistaken for a positional.
+            arms.push(`    ${view.key}/${flag.flag}) ${action === undefined ? "return" : `${action}; return`} ;;`);
+        }
+    }
+    return arms;
+}
+/** The global `--flag` case arms (e.g. --format, --detail values). */
+function globalValueArms(model, fn) {
+    return globalValueFlags(model).flatMap((flag) => {
+        const action = sourceAction(flag.source, fn);
+        return action === undefined
+            ? []
+            : [`    ${flag.flag}) ${action}; return ;;`];
+    });
+}
+/** The `noun/verb` case arms offering per-verb flag names. */
+function flagNameArms(model) {
+    return verbViews(model)
+        .filter(hasOwnFlags)
+        .map((view) => `      ${view.key}) COMPREPLY=($(compgen -W "${wordList(offeredFlagNames(model, view), "bash flags")}" -- "$cur")); return ;;`);
+}
+/** The `noun` case arms offering sub-verb labels. */
+function verbArms(model) {
+    return model.nouns
+        .filter((entry) => entry.verbs.length > 0)
+        .map((entry) => `      ${entry.noun}) COMPREPLY=($(compgen -W "${wordList(entry.verbs.map((verb) => verb.label), "bash verbs")}" -- "$cur")); return ;;`);
+}
+/** The positional case arm for one view, or undefined when it offers nothing. */
+function positionalArm(model, view, fn) {
+    const slots = [];
+    view.verb.positionals.forEach((positional, index) => {
+        const action = sourceAction(positional.source, fn);
+        if (action === undefined)
+            return;
+        const last = index === view.verb.positionals.length - 1;
+        const pattern = positional.variadic && last ? "*" : String(index);
+        slots.push(`        ${pattern}) ${action} ;;`);
+    });
+    if (slots.length === 0)
+        return undefined;
+    return [
+        `    ${view.key})`,
+        `      ${fn}_pos ${view.skipWords} "${wordList(valueFlagNames(model, view), "bash value flags")}"`,
+        '      case "$POS" in',
+        ...slots,
+        "      esac",
+        "      ;;",
+    ].join("\n");
+}
+/** Wrap case arms in a `case` statement, or nothing when there are no arms. */
+function caseBlock(subject, arms, indent) {
+    if (arms.length === 0)
+        return [];
+    return [`${indent}case ${subject} in`, ...arms, `${indent}esac`];
+}
+/**
+ * Render the bash completion script.
+ *
+ * @param model - The completion model.
+ * @param binName - The binary to complete (function names derive from it).
+ * @param minChars - Minimum typed chars before a name source execs `__complete`.
+ * @returns The script text.
+ */
+export function bashScript(model, binName, minChars) {
+    const fn = fnBase(binName);
+    const positionalArms = verbViews(model).flatMap((view) => {
+        const arm = positionalArm(model, view, fn);
+        return arm === undefined ? [] : [arm];
+    });
+    const globalValueSkips = globalValueFlags(model)
+        .map((flag) => flag.flag)
+        .join("|");
+    // Emit the verb block only when there are arms (bash rejects an empty then).
+    const verbSection = verbArms(model).length === 0
+        ? []
+        : [
+            "",
+            "  # verbs",
+            '  if [ -z "$verb" ]; then',
+            ...caseBlock('"$noun"', verbArms(model), "    "),
+            "  fi",
+        ];
+    const lines = [
+        `# ${binName} bash completion (static tier) — generated by \`${binName} setup completions\`. Do not edit.`,
+        "# Structure (nouns, verbs, flags, enum values) is inlined and never execs;",
+        `# entity arguments call \`${binName} __complete\` (storeless, never-throw);`,
+        "# file arguments use native completion. Requires bash >= 4 (mapfile).",
+        `${fn}_dynamic() {`,
+        ...(minChars > 0 ? [`  [ \${#cur} -ge ${minChars} ] || return 0`] : []),
+        `  mapfile -t COMPREPLY < <("${binName}" __complete -- "\${COMP_WORDS[@]:1:COMP_CWORD-1}" "$cur" 2>/dev/null)`,
+        "}",
+        `${fn}_pos() {`,
+        '  local skip="$1" vflags=" $2 " i w',
+        "  POS=0",
+        "  for ((i = 1; i < COMP_CWORD; i++)); do",
+        '    w="${COMP_WORDS[i]}"',
+        '    case "$w" in',
+        '      -*) case "$vflags" in *" $w "*) ((i++)) ;; esac ;;',
+        '      *) if [ "$skip" -gt 0 ]; then skip=$((skip - 1)); else POS=$((POS + 1)); fi ;;',
+        "    esac",
+        "  done",
+        "}",
+        `${fn}() {`,
+        "  local cur prev noun verb i w POS",
+        '  cur="${COMP_WORDS[COMP_CWORD]}"',
+        '  prev="${COMP_WORDS[COMP_CWORD-1]}"',
+        "  # Normalize the COMP_WORDBREAKS '=' split so a --flag=value context routes",
+        "  # as a flag value (mirrors parse.ts). The default breaks split",
+        "  # `--flag=val` into `--flag` `=` `val`; a custom COMP_WORDBREAKS may keep",
+        "  # `--flag=val` whole. Either way, recover $prev=flag and $cur=value.",
+        '  if [[ "$cur" == "=" ]]; then',
+        '    cur=""',
+        '  elif [[ "$prev" == "=" ]]; then',
+        '    prev="${COMP_WORDS[COMP_CWORD-2]}"',
+        '  elif [[ "$cur" == --*=* ]]; then',
+        '    prev="${cur%%=*}"',
+        '    cur="${cur#*=}"',
+        "  fi",
+        '  noun="" verb="" POS=0',
+        "  for ((i = 1; i < COMP_CWORD; i++)); do",
+        '    w="${COMP_WORDS[i]}"',
+        '    case "$w" in',
+        `      ${globalValueSkips}) ((i++)) ;;`,
+        "      -*) ;;",
+        "      *)",
+        '        if [ -z "$noun" ]; then noun="$w"',
+        '        elif [ -z "$verb" ]; then verb="$w"',
+        "        fi",
+        "        ;;",
+        "    esac",
+        "  done",
+        "",
+        "  # flag values (verb-scoped, then global)",
+        ...caseBlock('"$noun/$verb/$prev"', flagValueArms(model, fn), "  "),
+        ...caseBlock('"$prev"', globalValueArms(model, fn), "  "),
+        "",
+        "  # flag names",
+        '  if [[ "$cur" == -* ]]; then',
+        ...caseBlock('"$noun/$verb"', flagNameArms(model), "    "),
+        '    if [ -z "$noun" ]; then',
+        `      COMPREPLY=($(compgen -W "${wordList(rootFlagNames(model), "bash root flags")}" -- "$cur"))`,
+        "    else",
+        `      COMPREPLY=($(compgen -W "${wordList(globalFlagNames(model), "bash global flags")}" -- "$cur"))`,
+        "    fi",
+        "    return",
+        "  fi",
+        "",
+        "  # nouns",
+        '  if [ -z "$noun" ]; then',
+        `    COMPREPLY=($(compgen -W "${wordList(nounNames(model), "bash nouns")}" -- "$cur"))`,
+        "    return",
+        "  fi",
+        ...verbSection,
+        "",
+        "  # positionals",
+        ...caseBlock('"$noun/$verb"', positionalArms, "  "),
+        "}",
+        `complete -F ${fn} ${binName}`,
+        "",
+    ];
+    return lines.join("\n");
+}
+//# sourceMappingURL=bash.js.map

package/dist/src/kernel/completion/templates/bash.js.map

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

package/dist/src/kernel/completion/templates/fish.js

@@ -0,0 +1,214 @@
+/**
+ * The fish completion script (static tier). Requires fish >= 3.
+ *
+ * Declarative: one `complete -c` rule per fact, gated by the
+ * `__<bin>_at <noun> [verb]` position probe. Default file completion is
+ * suppressed (`-f`); enum values are inlined literals; file params force
+ * native files back on (`-rF`); only `{kind:"names"}` contexts exec the CLI
+ * via a command substitution — fish treats substitution results as literal
+ * candidates (split on newlines, never evaluated). Each name rule ANDs a
+ * `__<bin>_minchars` guard into its condition, so the exec waits for `minChars`
+ * typed chars, and a name-source POSITIONAL also ANDs `__<bin>_notflag` — fish
+ * evaluates every matching rule rather than one exclusive branch, so without it
+ * a structural `--<TAB>` would spawn the delegate too. No `eval`, no backticks.
+ *
+ * Static-tier coarseness (the resolver is exact): positional value rules are
+ * not index-gated, and a mixed self-verb + sub-verb noun only offers its
+ * sub-verbs — `__complete` answers both cases precisely.
+ */
+import { globalValueFlags, nounNames, verbViews, wordList } from "./shared.js";
+/** A shell-safe function-name base for the bin (`pragma` -> `__pragma`). */
+function fnBase(binName) {
+    return `__${binName.replace(/[^A-Za-z0-9_]/g, "_")}`;
+}
+/** AND a guard into a rule's condition (or start one with it). */
+function and(condition, guard) {
+    return condition ? `${condition}; and ${guard}` : guard;
+}
+/** AND a `minChars` guard into a name rule's condition (or start one). */
+function withMinChars(fn, condition, minChars) {
+    if (minChars <= 0)
+        return condition;
+    return and(condition, `${fn}_minchars ${minChars}`);
+}
+/** The rule fragment completing one flag of a view (or a global flag). */
+function flagRule(binName, fn, condition, flag, minChars) {
+    const name = flag.flag.replace(/^--/, "");
+    // A name-source value gates its exec on `minChars`; other rules keep the bare
+    // position condition (enum/file/none complete on bare TAB).
+    const cond = flag.takesValue && flag.source.kind === "names"
+        ? withMinChars(fn, condition, minChars)
+        : condition;
+    const parts = [`complete -c ${binName}`];
+    if (cond)
+        parts.push(`-n "${cond}"`);
+    parts.push(`-l ${name}`);
+    if (flag.takesValue) {
+        switch (flag.source.kind) {
+            case "values":
+                parts.push(`-x -a "${wordList(flag.source.values, "fish values")}"`);
+                break;
+            case "files":
+                parts.push("-rF");
+                break;
+            case "names":
+                parts.push(`-x -a "(${binName} __complete -- (${fn}_words) 2>/dev/null)"`);
+                break;
+            case "none":
+                parts.push("-x");
+                break;
+        }
+    }
+    return parts.join(" ");
+}
+/** The positional value rule for a view, or undefined when it offers nothing. */
+function positionalRule(binName, fn, condition, verb, minChars) {
+    // fish rules are not index-gated; offer the union of the verb's positional
+    // sources (a name source delegates to the resolver, which IS index-exact).
+    const values = new Set();
+    let names = false;
+    let files = false;
+    for (const positional of verb.positionals) {
+        if (positional.source.kind === "values") {
+            for (const value of positional.source.values)
+                values.add(value);
+        }
+        if (positional.source.kind === "names")
+            names = true;
+        if (positional.source.kind === "files")
+            files = true;
+    }
+    // A name source gates its exec on `minChars` AND on the current token not
+    // being a flag; a values/files positional keeps the bare position condition
+    // so it still completes on bare TAB.
+    //
+    // The `_notflag` half is what keeps a purely STRUCTURAL `--<TAB>` free of
+    // exec. fish evaluates every `complete` rule matching a position, so without
+    // it this positional rule fires alongside the flag-name rules the moment the
+    // token clears `minChars` — and `--` is two characters. That cost a process
+    // spawn per TAB on a flag name AND put the delegate's answer in the user's
+    // candidate list. bash and zsh route the same context through one exclusive
+    // `case` arm and exec nothing; this is how fish joins them.
+    const cond = names
+        ? withMinChars(fn, and(condition, `${fn}_notflag`), minChars)
+        : condition;
+    const parts = [`complete -c ${binName} -n "${cond}"`];
+    if (names) {
+        parts.push(`-a "(${binName} __complete -- (${fn}_words) 2>/dev/null)"`);
+    }
+    else if (values.size > 0) {
+        parts.push(`-a "${wordList([...values].sort(), "fish positional values")}"`);
+    }
+    else if (files) {
+        parts.push("-F");
+    }
+    else {
+        return undefined;
+    }
+    return parts.join(" ");
+}
+/**
+ * Render the fish completion script.
+ *
+ * @param model - The completion model.
+ * @param binName - The binary to complete (function names derive from it).
+ * @param minChars - Minimum typed chars before a name source execs `__complete`.
+ * @returns The script text.
+ */
+export function fishScript(model, binName, minChars) {
+    const fn = fnBase(binName);
+    const globalValueSkips = wordList(globalValueFlags(model).map((flag) => flag.flag), "fish global value flags");
+    const lines = [
+        `# ${binName} fish completion (static tier) — generated by \`${binName} setup completions\`. Do not edit.`,
+        "# Structure (nouns, verbs, flags, enum values) is inlined and never execs;",
+        `# name arguments call \`${binName} __complete\` (storeless, never-throw) once`,
+        `# ${minChars} chars are typed; file arguments use native completion (-rF). Requires fish >= 3.`,
+        `function ${fn}_words`,
+        "    set -l toks (commandline -opc)",
+        "    set -l cur (commandline -ct)",
+        "    printf '%s\\n' $toks[2..-1] $cur",
+        "end",
+        ...(minChars > 0
+            ? [
+                `function ${fn}_minchars`,
+                "    test (string length -- (commandline -ct)) -ge $argv[1]",
+                "end",
+            ]
+            : []),
+        // True when the token being completed is not a flag, so a name-source
+        // positional rule stays out of a structural `--<TAB>`.
+        `function ${fn}_notflag`,
+        "    not string match -q -- '-*' (commandline -ct)",
+        "end",
+        `function ${fn}_at`,
+        "    set -l cmd (commandline -opc)",
+        "    set -l noun ''",
+        "    set -l verb ''",
+        "    set -l skip 0",
+        "    for w in $cmd[2..-1]",
+        "        if test $skip -eq 1",
+        "            set skip 0",
+        "            continue",
+        "        end",
+        "        switch $w",
+        `            case ${globalValueSkips}`,
+        "                set skip 1",
+        "            case '-*'",
+        "            case '*'",
+        '                if test -z "$noun"',
+        "                    set noun $w",
+        '                else if test -z "$verb"',
+        "                    set verb $w",
+        "                end",
+        "        end",
+        "    end",
+        '    test "$noun" = "$argv[1]"; and test "$verb" = "$argv[2]"',
+        "end",
+        `complete -c ${binName} -f`,
+        "",
+        "# nouns",
+        `complete -c ${binName} -n "${fn}_at ''" -a "${wordList(nounNames(model), "fish nouns")}"`,
+        "",
+        "# global flags",
+        ...model.globalFlags.map((flag) => flagRule(binName, fn, flag.rootOnly === true ? `${fn}_at ''` : undefined, flag, minChars)),
+    ];
+    for (const entry of model.nouns) {
+        if (entry.verbs.length > 0) {
+            lines.push("", `# ${entry.noun} verbs`, `complete -c ${binName} -n "${fn}_at ${entry.noun}" -a "${wordList(entry.verbs.map((verb) => verb.label), "fish verbs")}"`);
+        }
+    }
+    for (const view of verbViews(model)) {
+        // A mixed noun's self-verb state is not expressible with the probe; its
+        // sub-verbs own the second word and the resolver owns the rest.
+        if (view.self &&
+            view.verb.positionals.length === 0 &&
+            view.verb.flags.length === 0 &&
+            !view.verb.mutates) {
+            continue;
+        }
+        const nounEntry = model.nouns.find((entry) => entry.noun === view.noun);
+        if (view.self && (nounEntry?.verbs.length ?? 0) > 0)
+            continue;
+        const condition = view.self
+            ? `${fn}_at ${view.noun}`
+            : `${fn}_at ${view.noun} ${view.verb.label}`;
+        const rules = [];
+        for (const flag of view.verb.flags) {
+            rules.push(flagRule(binName, fn, condition, flag, minChars));
+        }
+        if (view.verb.mutates) {
+            for (const flag of model.mutationFlags) {
+                rules.push(flagRule(binName, fn, condition, flag, minChars));
+            }
+        }
+        const positional = positionalRule(binName, fn, condition, view.verb, minChars);
+        if (positional)
+            rules.push(positional);
+        if (rules.length > 0) {
+            lines.push("", `# ${view.key}`, ...rules);
+        }
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+//# sourceMappingURL=fish.js.map

package/dist/src/kernel/completion/templates/fish.js.map

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

package/dist/src/kernel/completion/templates/index.js

@@ -0,0 +1,23 @@
+/**
+ * The static shell-completion templates — one emitter per shell, all fed by
+ * the same completion model.
+ *
+ * The three exports are the domain: each takes the model and returns the text
+ * of a script `setup completions` writes to disk. They are grouped because
+ * they are interchangeable answers to one question — which shell is this — and
+ * because they must stay in step: a fact the model carries has to be
+ * expressible in all three, so a change to one is a change to all three.
+ *
+ * What the barrel does NOT expose is the rendering layer underneath
+ * (`shared.ts`): the per-verb views, the token allowlist re-assertion, the
+ * name/flag list derivations. Those exist so the scripts cannot disagree about
+ * structure, and they are safe only in the emit context they were built for —
+ * every token they return has been re-checked against the safety allowlist on
+ * its way into script text. Offering them across the domain boundary would
+ * offer a way to compose that text without that check, which is the one thing
+ * this domain exists to make impossible.
+ */
+export { bashScript } from "./bash.js";
+export { fishScript } from "./fish.js";
+export { zshScript } from "./zsh.js";
+//# sourceMappingURL=index.js.map

package/dist/src/kernel/completion/templates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/kernel/completion/templates/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC"}

package/dist/src/kernel/completion/templates/shared.js

@@ -0,0 +1,98 @@
+/**
+ * Shared rendering helpers for the static shell-completion templates.
+ *
+ * Everything a template interpolates flows through here: tokens are
+ * re-asserted against the safety allowlist at emit time (belt-and-braces on
+ * top of the model-build gate), and the per-(noun,verb) views give each shell
+ * the same case-table data, so the three scripts can never disagree about
+ * structure. All lists are derived from the model — the templates contain no
+ * live names of their own.
+ */
+import { assertSafeToken } from "../model.js";
+export { assertSafeToken } from "../model.js";
+/**
+ * Every verb view of the model, in deterministic order (nouns sorted, each
+ * noun's self-verb first, then its sub-verbs sorted).
+ */
+export function verbViews(model) {
+    const views = [];
+    for (const entry of model.nouns) {
+        if (entry.selfVerb) {
+            views.push({
+                noun: entry.noun,
+                verb: entry.selfVerb,
+                self: true,
+                key: `${entry.noun}/`,
+                skipWords: 1,
+            });
+        }
+        for (const verb of entry.verbs) {
+            views.push({
+                noun: entry.noun,
+                verb,
+                self: false,
+                key: `${entry.noun}/${verb.label}`,
+                skipWords: 2,
+            });
+        }
+    }
+    return views;
+}
+/**
+ * Join already-validated tokens into a script word list, re-asserting each
+ * (flags are validated on their bare name — the dashes are ours).
+ *
+ * @param tokens - The tokens to inline.
+ * @param where - Human-readable location for the throw message.
+ * @returns The space-joined list, safe to place inside double quotes.
+ * @throws Error when any token fails the allowlist.
+ */
+export function wordList(tokens, where) {
+    for (const token of tokens) {
+        assertSafeToken(token.replace(/^--?/, ""), where);
+    }
+    return tokens.join(" ");
+}
+/** The noun tokens offered at the root. */
+export function nounNames(model) {
+    return model.nouns.map((entry) => entry.noun);
+}
+/** Global flag names offered at the root (includes `rootOnly`). */
+export function rootFlagNames(model) {
+    return model.globalFlags.map((flag) => flag.flag);
+}
+/** Global flag names offered after a noun (excludes `rootOnly`). */
+export function globalFlagNames(model) {
+    return model.globalFlags
+        .filter((flag) => flag.rootOnly !== true)
+        .map((flag) => flag.flag);
+}
+/** Global flags that take a value (their values are inlined per shell). */
+export function globalValueFlags(model) {
+    return model.globalFlags.filter((flag) => flag.takesValue);
+}
+/** The flag names a view offers: verb + mutation (iff mutates) + globals. */
+export function offeredFlagNames(model, view) {
+    return [
+        ...view.verb.flags.map((flag) => flag.flag),
+        ...(view.verb.mutates ? model.mutationFlags.map((flag) => flag.flag) : []),
+        ...globalFlagNames(model),
+    ];
+}
+/**
+ * Every value-taking flag in scope for a view (verb + globals) — the flags
+ * whose values a positional-index scan must skip.
+ */
+export function valueFlagNames(model, view) {
+    return [
+        ...view.verb.flags
+            .filter((flag) => flag.takesValue)
+            .map((flag) => flag.flag),
+        ...globalValueFlags(model).map((flag) => flag.flag),
+    ];
+}
+/** Whether a view has any flag of its own to name (beyond the globals). */
+export function hasOwnFlags(view) {
+    return view.verb.flags.length > 0 || view.verb.mutates;
+}
+//# sourceMappingURL=shared.js.map

package/dist/src/kernel/completion/templates/shared.js.map

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