@templatical/editor 0.43.3 → 0.44.0

package/dist/cdn/chunks/{useLogicTag-J_i_hvZg.js → useLogicTag-D6lWY0bD.js}

@@ -1,5 +1,5 @@
 import { E as e, Q as t } from "./draggable-IB4x6w2O.js";
-import { r as n } from "./src-BR3I3gOW.js";
+import { r as n } from "./src-QIGNPFkl.js";
 import { D as r, E as i, I as a, P as o, T as s, w as c } from "./keys-DCWeHkSF.js";
 //#region src/composables/useLogicTag.ts
 function l() {
@@ -35,4 +35,4 @@ function l() {
 //#endregion
 export { l as t };
 
-//# sourceMappingURL=useLogicTag-J_i_hvZg.js.map
+//# sourceMappingURL=useLogicTag-D6lWY0bD.js.map

package/dist/cdn/chunks/{useLogicTag-J_i_hvZg.js.map → useLogicTag-D6lWY0bD.js.map}

@@ -1 +1 @@
-{"version":3,"file":"useLogicTag-J_i_hvZg.js","names":["inject","ref","SYNTAX_PRESETS","LOGIC_TAG_REQUESTING_KEY","LOGIC_TAG_PICKER_KEY","ON_REQUEST_LOGIC_TAG_KEY","MERGE_TAG_SYNTAX_KEY","LOGIC_TAGS_KEY","LOGIC_PAIRS_KEY","useLogicTag","logicTags","logicPairs","syntax","onRequest","picker","isRequesting","canInsertLogicTag","hasStaticLogic","requestLogicTag"],"sources":["../../../src/composables/useLogicTag.ts"],"sourcesContent":["import type { LogicPair, LogicTag, SyntaxPreset } from \"@templatical/types\";\nimport { SYNTAX_PRESETS } from \"@templatical/types\";\nimport { inject, ref, type Ref } from \"vue\";\nimport {\n  LOGIC_PAIRS_KEY,\n  LOGIC_TAG_PICKER_KEY,\n  LOGIC_TAG_REQUESTING_KEY,\n  LOGIC_TAGS_KEY,\n  MERGE_TAG_SYNTAX_KEY,\n  ON_REQUEST_LOGIC_TAG_KEY,\n} from \"../keys\";\nimport type { LogicTagPickerResult } from \"./useLogicTagPicker\";\n\nexport interface UseLogicTagReturn {\n  /** Configured standalone logic tags. */\n  logicTags: LogicTag[];\n  /** Configured open/close logic pairs. */\n  logicPairs: LogicPair[];\n  /** Resolved syntax preset — shared with merge tags; drives keyword badges. */\n  syntax: SyntaxPreset;\n  /**\n   * Whether the \"Insert logic\" affordance should show. True when at least one\n   * logic tag or pair is configured.\n   */\n  canInsertLogicTag: boolean;\n  /** Whether a logic pick is in progress. */\n  isRequesting: Ref<boolean>;\n  /**\n   * Open the built-in logic picker. Resolves with the chosen tag/pair, or null\n   * when nothing is configured, the picker is unavailable (headless), or the\n   * user cancels.\n   */\n  requestLogicTag: () => Promise<LogicTagPickerResult | null>;\n}\n\n/**\n * Composable for the standalone logic-tag feature — separate from merge tags.\n * Exposes configured logic tags/pairs and opens the built-in logic picker.\n */\nexport function useLogicTag(): UseLogicTagReturn {\n  const logicTags = inject(LOGIC_TAGS_KEY, []);\n  const logicPairs = inject(LOGIC_PAIRS_KEY, []);\n  const syntax = inject(MERGE_TAG_SYNTAX_KEY, SYNTAX_PRESETS.liquid);\n  const onRequest = inject(ON_REQUEST_LOGIC_TAG_KEY, null);\n  // Picker may be null in headless contexts (tests, non-editor consumers).\n  const picker = inject(LOGIC_TAG_PICKER_KEY, null);\n\n  // Shared per editor — same reason as merge tags. See\n  // LOGIC_TAG_REQUESTING_KEY.\n  const isRequesting = inject(LOGIC_TAG_REQUESTING_KEY, null) ?? ref(false);\n\n  // Show the affordance when a consumer callback is set OR static config\n  // exists — mirrors useMergeTag's canRequestMergeTag.\n  const canInsertLogicTag =\n    !!onRequest || logicTags.length > 0 || logicPairs.length > 0;\n\n  const hasStaticLogic = logicTags.length > 0 || logicPairs.length > 0;\n\n  /**\n   * Request a logic tag/pair from the user. Precedence:\n   *  1. `logic.onRequest` callback (consumer-owned UX)\n   *  2. Built-in picker over `logic.tags` / `logic.pairs`\n   *  3. null (nothing configured / headless)\n   */\n  async function requestLogicTag(): Promise<LogicTagPickerResult | null> {\n    if (onRequest) {\n      isRequesting.value = true;\n      try {\n        return await onRequest();\n      } finally {\n        isRequesting.value = false;\n      }\n    }\n    if (picker && hasStaticLogic) {\n      isRequesting.value = true;\n      try {\n        return await picker.open(logicTags, logicPairs);\n      } finally {\n        isRequesting.value = false;\n      }\n    }\n    return null;\n  }\n\n  return {\n    logicTags,\n    logicPairs,\n    syntax,\n    canInsertLogicTag,\n    isRequesting,\n    requestLogicTag,\n  };\n}\n"],"mappings":";;;;AAuCA,SAAgBS,IAAiC;CAC/C,IAAMC,IAAYV,EAAOO,GAAgB,CAAC,CAAC,GACrCI,IAAaX,EAAOQ,GAAiB,CAAC,CAAC,GACvCI,IAASZ,EAAOM,GAAsBJ,EAAe,MAAM,GAC3DW,IAAYb,EAAOK,GAA0B,IAAI,GAEjDS,IAASd,EAAOI,GAAsB,IAAI,GAI1CW,IAAef,EAAOG,GAA0B,IAAI,KAAKF,EAAI,EAAK,GAIlEe,IACJ,CAAC,CAACH,KAAaH,EAAU,SAAS,KAAKC,EAAW,SAAS,GAEvDM,IAAiBP,EAAU,SAAS,KAAKC,EAAW,SAAS;CAQnE,eAAeO,IAAwD;EACrE,IAAIL,GAAW;GACb,EAAa,QAAQ;GACrB,IAAI;IACF,OAAO,MAAMA,EAAU;GACzB,UAAU;IACR,EAAa,QAAQ;GACvB;EACF;EACA,IAAIC,KAAUG,GAAgB;GAC5B,EAAa,QAAQ;GACrB,IAAI;IACF,OAAO,MAAMH,EAAO,KAAKJ,GAAWC,CAAU;GAChD,UAAU;IACR,EAAa,QAAQ;GACvB;EACF;EACA,OAAO;CACT;CAEA,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;CACF;AACF"}
+{"version":3,"file":"useLogicTag-D6lWY0bD.js","names":["inject","ref","SYNTAX_PRESETS","LOGIC_TAG_REQUESTING_KEY","LOGIC_TAG_PICKER_KEY","ON_REQUEST_LOGIC_TAG_KEY","MERGE_TAG_SYNTAX_KEY","LOGIC_TAGS_KEY","LOGIC_PAIRS_KEY","useLogicTag","logicTags","logicPairs","syntax","onRequest","picker","isRequesting","canInsertLogicTag","hasStaticLogic","requestLogicTag"],"sources":["../../../src/composables/useLogicTag.ts"],"sourcesContent":["import type { LogicPair, LogicTag, SyntaxPreset } from \"@templatical/types\";\nimport { SYNTAX_PRESETS } from \"@templatical/types\";\nimport { inject, ref, type Ref } from \"vue\";\nimport {\n  LOGIC_PAIRS_KEY,\n  LOGIC_TAG_PICKER_KEY,\n  LOGIC_TAG_REQUESTING_KEY,\n  LOGIC_TAGS_KEY,\n  MERGE_TAG_SYNTAX_KEY,\n  ON_REQUEST_LOGIC_TAG_KEY,\n} from \"../keys\";\nimport type { LogicTagPickerResult } from \"./useLogicTagPicker\";\n\nexport interface UseLogicTagReturn {\n  /** Configured standalone logic tags. */\n  logicTags: LogicTag[];\n  /** Configured open/close logic pairs. */\n  logicPairs: LogicPair[];\n  /** Resolved syntax preset — shared with merge tags; drives keyword badges. */\n  syntax: SyntaxPreset;\n  /**\n   * Whether the \"Insert logic\" affordance should show. True when at least one\n   * logic tag or pair is configured.\n   */\n  canInsertLogicTag: boolean;\n  /** Whether a logic pick is in progress. */\n  isRequesting: Ref<boolean>;\n  /**\n   * Open the built-in logic picker. Resolves with the chosen tag/pair, or null\n   * when nothing is configured, the picker is unavailable (headless), or the\n   * user cancels.\n   */\n  requestLogicTag: () => Promise<LogicTagPickerResult | null>;\n}\n\n/**\n * Composable for the standalone logic-tag feature — separate from merge tags.\n * Exposes configured logic tags/pairs and opens the built-in logic picker.\n */\nexport function useLogicTag(): UseLogicTagReturn {\n  const logicTags = inject(LOGIC_TAGS_KEY, []);\n  const logicPairs = inject(LOGIC_PAIRS_KEY, []);\n  const syntax = inject(MERGE_TAG_SYNTAX_KEY, SYNTAX_PRESETS.liquid);\n  const onRequest = inject(ON_REQUEST_LOGIC_TAG_KEY, null);\n  // Picker may be null in headless contexts (tests, non-editor consumers).\n  const picker = inject(LOGIC_TAG_PICKER_KEY, null);\n\n  // Shared per editor — same reason as merge tags. See\n  // LOGIC_TAG_REQUESTING_KEY.\n  const isRequesting = inject(LOGIC_TAG_REQUESTING_KEY, null) ?? ref(false);\n\n  // Show the affordance when a consumer callback is set OR static config\n  // exists — mirrors useMergeTag's canRequestMergeTag.\n  const canInsertLogicTag =\n    !!onRequest || logicTags.length > 0 || logicPairs.length > 0;\n\n  const hasStaticLogic = logicTags.length > 0 || logicPairs.length > 0;\n\n  /**\n   * Request a logic tag/pair from the user. Precedence:\n   *  1. `logic.onRequest` callback (consumer-owned UX)\n   *  2. Built-in picker over `logic.tags` / `logic.pairs`\n   *  3. null (nothing configured / headless)\n   */\n  async function requestLogicTag(): Promise<LogicTagPickerResult | null> {\n    if (onRequest) {\n      isRequesting.value = true;\n      try {\n        return await onRequest();\n      } finally {\n        isRequesting.value = false;\n      }\n    }\n    if (picker && hasStaticLogic) {\n      isRequesting.value = true;\n      try {\n        return await picker.open(logicTags, logicPairs);\n      } finally {\n        isRequesting.value = false;\n      }\n    }\n    return null;\n  }\n\n  return {\n    logicTags,\n    logicPairs,\n    syntax,\n    canInsertLogicTag,\n    isRequesting,\n    requestLogicTag,\n  };\n}\n"],"mappings":";;;;AAuCA,SAAgBS,IAAiC;CAC/C,IAAMC,IAAYV,EAAOO,GAAgB,CAAC,CAAC,GACrCI,IAAaX,EAAOQ,GAAiB,CAAC,CAAC,GACvCI,IAASZ,EAAOM,GAAsBJ,EAAe,MAAM,GAC3DW,IAAYb,EAAOK,GAA0B,IAAI,GAEjDS,IAASd,EAAOI,GAAsB,IAAI,GAI1CW,IAAef,EAAOG,GAA0B,IAAI,KAAKF,EAAI,EAAK,GAIlEe,IACJ,CAAC,CAACH,KAAaH,EAAU,SAAS,KAAKC,EAAW,SAAS,GAEvDM,IAAiBP,EAAU,SAAS,KAAKC,EAAW,SAAS;CAQnE,eAAeO,IAAwD;EACrE,IAAIL,GAAW;GACb,EAAa,QAAQ;GACrB,IAAI;IACF,OAAO,MAAMA,EAAU;GACzB,UAAU;IACR,EAAa,QAAQ;GACvB;EACF;EACA,IAAIC,KAAUG,GAAgB;GAC5B,EAAa,QAAQ;GACrB,IAAI;IACF,OAAO,MAAMH,EAAO,KAAKJ,GAAWC,CAAU;GAChD,UAAU;IACR,EAAa,QAAQ;GACvB;EACF;EACA,OAAO;CACT;CAEA,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;CACF;AACF"}

package/dist/cdn/chunks/{useMergeTag-C5MyHYxJ.js → useMergeTag-2iW-BKWW.js}

@@ -1,5 +1,5 @@
 import { E as e, Q as t, f as n } from "./draggable-IB4x6w2O.js";
-import { f as r, o as i, r as a } from "./src-BR3I3gOW.js";
+import { f as r, o as i, r as a } from "./src-QIGNPFkl.js";
 import { A as o, F as s, N as c, O as l, P as u, R as d, Y as f, j as p, k as m } from "./keys-DCWeHkSF.js";
 //#region src/composables/useMergeTag.ts
 function h() {
@@ -57,4 +57,4 @@ function h() {
 //#endregion
 export { h as t };
 
-//# sourceMappingURL=useMergeTag-C5MyHYxJ.js.map
+//# sourceMappingURL=useMergeTag-2iW-BKWW.js.map

package/dist/cdn/chunks/{useMergeTag-C5MyHYxJ.js.map → useMergeTag-2iW-BKWW.js.map}

@@ -1 +1 @@
-{"version":3,"file":"useMergeTag-C5MyHYxJ.js","names":["isMergeTagValue","checkIsMergeTagValue","getMergeTagLabel","resolveMergeTagLabel","inject","ref","computed","isMergeTagValue","getMergeTagLabel","SYNTAX_PRESETS","MERGE_TAG_PICKER_KEY","NO_MERGE_TAGS","MERGE_TAG_SHOW_RAW_VALUE_KEY","MERGE_TAGS_KEY","MERGE_TAG_SYNTAX_KEY","ON_REQUEST_MERGE_TAG_KEY","TRANSLATIONS_KEY","MERGE_TAG_REQUESTING_KEY","MERGE_TAG_AUTOCOMPLETE_KEY","useMergeTag","mergeTags","syntax","onRequestMergeTag","autocomplete","picker","showRawValue","unknownLabel","isRequesting","isMergeTagValue$1","value","getMergeTagLabel$1","findMergeTag","tag","canRepickMergeTag","getMergeTagDisplayLabel","declared","storedLabel","requestMergeTag","context"],"sources":["../../../src/composables/useMergeTag.ts"],"sourcesContent":["import type {\n  MergeTag,\n  MergeTagRequestContext,\n  SyntaxPreset,\n} from \"@templatical/types\";\nimport {\n  isMergeTagValue as checkIsMergeTagValue,\n  getMergeTagLabel as resolveMergeTagLabel,\n  SYNTAX_PRESETS,\n} from \"@templatical/types\";\nimport {\n  computed,\n  inject,\n  ref,\n  type ComputedRef,\n  type Ref,\n  type ShallowRef,\n} from \"vue\";\nimport {\n  MERGE_TAGS_KEY,\n  NO_MERGE_TAGS,\n  MERGE_TAG_SYNTAX_KEY,\n  MERGE_TAG_AUTOCOMPLETE_KEY,\n  MERGE_TAG_PICKER_KEY,\n  MERGE_TAG_SHOW_RAW_VALUE_KEY,\n  MERGE_TAG_REQUESTING_KEY,\n  ON_REQUEST_MERGE_TAG_KEY,\n  TRANSLATIONS_KEY,\n} from \"../keys\";\n\nexport interface UseMergeTagReturn {\n  /**\n   * The configured merge tags. A ref, so `editor.setMergeTags()` reaches\n   * everything reading it — never destructure the array out of it.\n   */\n  mergeTags: ShallowRef<MergeTag[]>;\n  /** Whether a merge tag request is in progress */\n  isRequesting: Ref<boolean>;\n  /**\n   * Whether the \"Insert merge tag\" button should be shown. True when\n   * either `onRequestMergeTag` is provided or `mergeTags.tags` is\n   * non-empty (the built-in picker then handles the click).\n   */\n  canRequestMergeTag: ComputedRef<boolean>;\n  /** Whether typing-based autocomplete is enabled by configuration */\n  autocomplete: boolean;\n  /** The resolved syntax preset for merge tags */\n  syntax: SyntaxPreset;\n  /** Check if a value matches the configured merge tag syntax */\n  isMergeTagValue: (value: string) => boolean;\n  /** Get the human-readable label for a merge tag value */\n  getMergeTagLabel: (value: string) => string;\n  /**\n   * The configured tag whose `value` is exactly `value`, or `undefined` when\n   * the token matches nothing. Unlike `getMergeTagLabel`, absence is reported\n   * rather than falling back to the raw token — callers deciding whether a\n   * chip can be re-picked need to tell the two apart.\n   */\n  findMergeTag: (value: string) => MergeTag | undefined;\n  /**\n   * Whether activating a tag carrying `value` should open the chooser rather\n   * than a raw text input.\n   *\n   * True when the consumer owns the chooser (`onRequest` decides for itself\n   * what an unresolvable token means), or when the token resolves against\n   * `tags` so the built-in picker has something to preselect. False otherwise,\n   * which is the one case where editing the token as text is still the only\n   * way to repair it.\n   *\n   * The single home for that rule: the canvas chip and a sidebar field chip\n   * must not be able to answer it differently.\n   */\n  canRepickMergeTag: (value: string) => boolean;\n  /**\n   * What a tag renders as on screen.\n   *\n   * A declared tag shows its label. An undeclared token normally shows itself —\n   * the editor makes a tag out of anything syntax-shaped, so the token is\n   * usually the only thing identifying it. When the consumer hid raw tokens it\n   * falls back to `storedLabel` (the label captured on the node when the tag\n   * was inserted) and then to a neutral placeholder, so an opaque identifier\n   * never reaches the screen.\n   *\n   * The single home for that chain: the canvas chip, its accessible name and a\n   * sidebar field chip must all say the same thing.\n   */\n  getMergeTagDisplayLabel: (value: string, storedLabel?: string) => string;\n  /**\n   * Whether a tag's tooltip may reveal the raw token behind its label.\n   * `false` when the consumer set `mergeTags.showRawValue: false`.\n   */\n  showRawValue: boolean;\n  /**\n   * Request a merge tag from the user. Precedence: when\n   * `onRequestMergeTag` is set it owns the UX; otherwise the built-in\n   * picker opens with the configured `mergeTags.tags`; otherwise null.\n   *\n   * `context` says whether this is an insertion or a replacement, and carries\n   * the tag being replaced when one resolves.\n   */\n  requestMergeTag: (\n    context?: MergeTagRequestContext,\n  ) => Promise<MergeTag | null>;\n}\n\n/**\n * Composable for merge tag functionality.\n * Provides utilities for detecting, displaying, and requesting merge tags.\n */\nexport function useMergeTag(): UseMergeTagReturn {\n  const mergeTags = inject(MERGE_TAGS_KEY, NO_MERGE_TAGS);\n  const syntax = inject(MERGE_TAG_SYNTAX_KEY, SYNTAX_PRESETS.liquid);\n  const onRequestMergeTag = inject(ON_REQUEST_MERGE_TAG_KEY, null);\n  const autocomplete = inject(MERGE_TAG_AUTOCOMPLETE_KEY, true);\n  // Picker may be null in headless contexts (tests, non-editor consumers).\n  // requestMergeTag() returns null in that case rather than throwing.\n  const picker = inject(MERGE_TAG_PICKER_KEY, null);\n  const showRawValue = inject(MERGE_TAG_SHOW_RAW_VALUE_KEY, true);\n  // Injected directly rather than through `useI18n()`, which throws without a\n  // provider — this composable is used headlessly too. The binding name is one\n  // `i18n-key-usage.test.ts` recognises as a translations holder; an unlisted\n  // name makes every key read through it look dead to that guard.\n  const injectedTranslations = inject(TRANSLATIONS_KEY, null);\n  const unknownLabel =\n    injectedTranslations?.mergeTag.unknownLabel ?? \"Merge tag\";\n\n  // Shared per editor so every host that can open the picker is visible to\n  // useRichTextEditor's click-outside guard. See MERGE_TAG_REQUESTING_KEY.\n  const isRequesting = inject(MERGE_TAG_REQUESTING_KEY, null) ?? ref(false);\n\n  function isMergeTagValue(value: string): boolean {\n    return checkIsMergeTagValue(value, syntax);\n  }\n\n  function getMergeTagLabel(value: string): string {\n    return resolveMergeTagLabel(value, mergeTags.value);\n  }\n\n  function findMergeTag(value: string): MergeTag | undefined {\n    return mergeTags.value.find((tag) => tag.value === value);\n  }\n\n  function canRepickMergeTag(value: string): boolean {\n    return !!onRequestMergeTag || findMergeTag(value) !== undefined;\n  }\n\n  function getMergeTagDisplayLabel(\n    value: string,\n    storedLabel?: string,\n  ): string {\n    const declared = findMergeTag(value);\n    if (declared) return declared.label;\n    // Before the token, not after it. A consumer whose picker mints a tag\n    // returns one that is in no `tags` array, and its label is written onto\n    // the node — reaching for the token first renders a raw identifier the\n    // instant the author picks a field. This costs nothing for a tag the\n    // editor made itself: the input rule, the paste rule, normalization and\n    // `parseHTML` all derive an undeclared tag's stored label from\n    // `getMergeTagLabel`, which returns the token, so the two agree already.\n    if (storedLabel?.trim()) return storedLabel.trim();\n    return showRawValue ? value : unknownLabel;\n  }\n\n  /**\n   * Request a merge tag from the user. Precedence:\n   *  1. `onRequestMergeTag` callback (consumer-owned UX)\n   *  2. Built-in picker over `mergeTags.tags`\n   *  3. null (nothing configured)\n   */\n  async function requestMergeTag(\n    context?: MergeTagRequestContext,\n  ): Promise<MergeTag | null> {\n    if (onRequestMergeTag) {\n      isRequesting.value = true;\n      try {\n        return await onRequestMergeTag(context);\n      } finally {\n        isRequesting.value = false;\n      }\n    }\n    if (mergeTags.value.length > 0 && picker) {\n      isRequesting.value = true;\n      try {\n        return await picker.open(mergeTags.value, {\n          current: context?.current,\n        });\n      } finally {\n        isRequesting.value = false;\n      }\n    }\n    return null;\n  }\n\n  // Computed, not a snapshot: `setMergeTags` can take the list from empty to\n  // populated, and a plain boolean captured here would leave the \"Insert merge\n  // tag\" affordance hidden for the rest of the session.\n  const canRequestMergeTag = computed(\n    () => !!onRequestMergeTag || mergeTags.value.length > 0,\n  );\n\n  return {\n    mergeTags,\n    isRequesting,\n    canRequestMergeTag,\n    autocomplete,\n    syntax,\n    isMergeTagValue,\n    getMergeTagLabel,\n    findMergeTag,\n    canRepickMergeTag,\n    getMergeTagDisplayLabel,\n    showRawValue,\n    requestMergeTag,\n  };\n}\n"],"mappings":";;;;AA6GA,SAAgBmB,IAAiC;CAC/C,IAAMC,IAAYhB,EAAOS,GAAgBF,CAAa,GAChDU,IAASjB,EAAOU,GAAsBL,EAAe,MAAM,GAC3Da,IAAoBlB,EAAOW,GAA0B,IAAI,GACzDQ,IAAenB,EAAOc,GAA4B,EAAI,GAGtDM,IAASpB,EAAOM,GAAsB,IAAI,GAC1Ce,IAAerB,EAAOQ,GAA8B,EAAI,GAMxDc,IADuBtB,EAAOY,GAAkB,IAEpD,CAAA,EAAsB,SAAS,gBAAgB,aAI3CW,IAAevB,EAAOa,GAA0B,IAAI,KAAKZ,EAAI,EAAK;CAExE,SAASL,EAAgB,GAAwB;EAC/C,OAAOC,EAAqB4B,GAAOR,CAAM;CAC3C;CAEA,SAASnB,EAAiB,GAAuB;EAC/C,OAAOC,EAAqB0B,GAAOT,EAAU,KAAK;CACpD;CAEA,SAASW,EAAa,GAAqC;EACzD,OAAOX,EAAU,MAAM,MAAM,MAAQY,EAAI,UAAUH,CAAK;CAC1D;CAEA,SAASI,EAAkB,GAAwB;EACjD,OAAO,CAAC,CAACX,KAAqBS,EAAaF,CAAK,MAAM,KAAA;CACxD;CAEA,SAASK,EACP,GACA,GACQ;EACR,IAAMC,IAAWJ,EAAaF,CAAK;EAUnC,OATIM,IAAiBA,EAAS,QAQ1BC,GAAa,KAAK,IAAUA,EAAY,KAAK,IAC1CX,IAAeI,IAAQH;CAChC;CAQA,eAAeW,EACb,GAC0B;EAC1B,IAAIf,GAAmB;GACrB,EAAa,QAAQ;GACrB,IAAI;IACF,OAAO,MAAMA,EAAkBgB,CAAO;GACxC,UAAU;IACR,EAAa,QAAQ;GACvB;EACF;EACA,IAAIlB,EAAU,MAAM,SAAS,KAAKI,GAAQ;GACxC,EAAa,QAAQ;GACrB,IAAI;IACF,OAAO,MAAMA,EAAO,KAAKJ,EAAU,OAAO,EACxC,SAASkB,GAAS,QACpB,CAAC;GACH,UAAU;IACR,EAAa,QAAQ;GACvB;EACF;EACA,OAAO;CACT;CASA,OAAO;EACL;EACA;EACA,oBAPyBhC,QACnB,CAAC,CAACgB,KAAqBF,EAAU,MAAM,SAAS,CAMtD;EACA;EACA;EACA,iBAAAQ;EACA,kBAAAE;EACA;EACA;EACA;EACA;EACA;CACF;AACF"}
+{"version":3,"file":"useMergeTag-2iW-BKWW.js","names":["isMergeTagValue","checkIsMergeTagValue","getMergeTagLabel","resolveMergeTagLabel","inject","ref","computed","isMergeTagValue","getMergeTagLabel","SYNTAX_PRESETS","MERGE_TAG_PICKER_KEY","NO_MERGE_TAGS","MERGE_TAG_SHOW_RAW_VALUE_KEY","MERGE_TAGS_KEY","MERGE_TAG_SYNTAX_KEY","ON_REQUEST_MERGE_TAG_KEY","TRANSLATIONS_KEY","MERGE_TAG_REQUESTING_KEY","MERGE_TAG_AUTOCOMPLETE_KEY","useMergeTag","mergeTags","syntax","onRequestMergeTag","autocomplete","picker","showRawValue","unknownLabel","isRequesting","isMergeTagValue$1","value","getMergeTagLabel$1","findMergeTag","tag","canRepickMergeTag","getMergeTagDisplayLabel","declared","storedLabel","requestMergeTag","context"],"sources":["../../../src/composables/useMergeTag.ts"],"sourcesContent":["import type {\n  MergeTag,\n  MergeTagRequestContext,\n  SyntaxPreset,\n} from \"@templatical/types\";\nimport {\n  isMergeTagValue as checkIsMergeTagValue,\n  getMergeTagLabel as resolveMergeTagLabel,\n  SYNTAX_PRESETS,\n} from \"@templatical/types\";\nimport {\n  computed,\n  inject,\n  ref,\n  type ComputedRef,\n  type Ref,\n  type ShallowRef,\n} from \"vue\";\nimport {\n  MERGE_TAGS_KEY,\n  NO_MERGE_TAGS,\n  MERGE_TAG_SYNTAX_KEY,\n  MERGE_TAG_AUTOCOMPLETE_KEY,\n  MERGE_TAG_PICKER_KEY,\n  MERGE_TAG_SHOW_RAW_VALUE_KEY,\n  MERGE_TAG_REQUESTING_KEY,\n  ON_REQUEST_MERGE_TAG_KEY,\n  TRANSLATIONS_KEY,\n} from \"../keys\";\n\nexport interface UseMergeTagReturn {\n  /**\n   * The configured merge tags. A ref, so `editor.setMergeTags()` reaches\n   * everything reading it — never destructure the array out of it.\n   */\n  mergeTags: ShallowRef<MergeTag[]>;\n  /** Whether a merge tag request is in progress */\n  isRequesting: Ref<boolean>;\n  /**\n   * Whether the \"Insert merge tag\" button should be shown. True when\n   * either `onRequestMergeTag` is provided or `mergeTags.tags` is\n   * non-empty (the built-in picker then handles the click).\n   */\n  canRequestMergeTag: ComputedRef<boolean>;\n  /** Whether typing-based autocomplete is enabled by configuration */\n  autocomplete: boolean;\n  /** The resolved syntax preset for merge tags */\n  syntax: SyntaxPreset;\n  /** Check if a value matches the configured merge tag syntax */\n  isMergeTagValue: (value: string) => boolean;\n  /** Get the human-readable label for a merge tag value */\n  getMergeTagLabel: (value: string) => string;\n  /**\n   * The configured tag whose `value` is exactly `value`, or `undefined` when\n   * the token matches nothing. Unlike `getMergeTagLabel`, absence is reported\n   * rather than falling back to the raw token — callers deciding whether a\n   * chip can be re-picked need to tell the two apart.\n   */\n  findMergeTag: (value: string) => MergeTag | undefined;\n  /**\n   * Whether activating a tag carrying `value` should open the chooser rather\n   * than a raw text input.\n   *\n   * True when the consumer owns the chooser (`onRequest` decides for itself\n   * what an unresolvable token means), or when the token resolves against\n   * `tags` so the built-in picker has something to preselect. False otherwise,\n   * which is the one case where editing the token as text is still the only\n   * way to repair it.\n   *\n   * The single home for that rule: the canvas chip and a sidebar field chip\n   * must not be able to answer it differently.\n   */\n  canRepickMergeTag: (value: string) => boolean;\n  /**\n   * What a tag renders as on screen.\n   *\n   * A declared tag shows its label. An undeclared token normally shows itself —\n   * the editor makes a tag out of anything syntax-shaped, so the token is\n   * usually the only thing identifying it. When the consumer hid raw tokens it\n   * falls back to `storedLabel` (the label captured on the node when the tag\n   * was inserted) and then to a neutral placeholder, so an opaque identifier\n   * never reaches the screen.\n   *\n   * The single home for that chain: the canvas chip, its accessible name and a\n   * sidebar field chip must all say the same thing.\n   */\n  getMergeTagDisplayLabel: (value: string, storedLabel?: string) => string;\n  /**\n   * Whether a tag's tooltip may reveal the raw token behind its label.\n   * `false` when the consumer set `mergeTags.showRawValue: false`.\n   */\n  showRawValue: boolean;\n  /**\n   * Request a merge tag from the user. Precedence: when\n   * `onRequestMergeTag` is set it owns the UX; otherwise the built-in\n   * picker opens with the configured `mergeTags.tags`; otherwise null.\n   *\n   * `context` says whether this is an insertion or a replacement, and carries\n   * the tag being replaced when one resolves.\n   */\n  requestMergeTag: (\n    context?: MergeTagRequestContext,\n  ) => Promise<MergeTag | null>;\n}\n\n/**\n * Composable for merge tag functionality.\n * Provides utilities for detecting, displaying, and requesting merge tags.\n */\nexport function useMergeTag(): UseMergeTagReturn {\n  const mergeTags = inject(MERGE_TAGS_KEY, NO_MERGE_TAGS);\n  const syntax = inject(MERGE_TAG_SYNTAX_KEY, SYNTAX_PRESETS.liquid);\n  const onRequestMergeTag = inject(ON_REQUEST_MERGE_TAG_KEY, null);\n  const autocomplete = inject(MERGE_TAG_AUTOCOMPLETE_KEY, true);\n  // Picker may be null in headless contexts (tests, non-editor consumers).\n  // requestMergeTag() returns null in that case rather than throwing.\n  const picker = inject(MERGE_TAG_PICKER_KEY, null);\n  const showRawValue = inject(MERGE_TAG_SHOW_RAW_VALUE_KEY, true);\n  // Injected directly rather than through `useI18n()`, which throws without a\n  // provider — this composable is used headlessly too. The binding name is one\n  // `i18n-key-usage.test.ts` recognises as a translations holder; an unlisted\n  // name makes every key read through it look dead to that guard.\n  const injectedTranslations = inject(TRANSLATIONS_KEY, null);\n  const unknownLabel =\n    injectedTranslations?.mergeTag.unknownLabel ?? \"Merge tag\";\n\n  // Shared per editor so every host that can open the picker is visible to\n  // useRichTextEditor's click-outside guard. See MERGE_TAG_REQUESTING_KEY.\n  const isRequesting = inject(MERGE_TAG_REQUESTING_KEY, null) ?? ref(false);\n\n  function isMergeTagValue(value: string): boolean {\n    return checkIsMergeTagValue(value, syntax);\n  }\n\n  function getMergeTagLabel(value: string): string {\n    return resolveMergeTagLabel(value, mergeTags.value);\n  }\n\n  function findMergeTag(value: string): MergeTag | undefined {\n    return mergeTags.value.find((tag) => tag.value === value);\n  }\n\n  function canRepickMergeTag(value: string): boolean {\n    return !!onRequestMergeTag || findMergeTag(value) !== undefined;\n  }\n\n  function getMergeTagDisplayLabel(\n    value: string,\n    storedLabel?: string,\n  ): string {\n    const declared = findMergeTag(value);\n    if (declared) return declared.label;\n    // Before the token, not after it. A consumer whose picker mints a tag\n    // returns one that is in no `tags` array, and its label is written onto\n    // the node — reaching for the token first renders a raw identifier the\n    // instant the author picks a field. This costs nothing for a tag the\n    // editor made itself: the input rule, the paste rule, normalization and\n    // `parseHTML` all derive an undeclared tag's stored label from\n    // `getMergeTagLabel`, which returns the token, so the two agree already.\n    if (storedLabel?.trim()) return storedLabel.trim();\n    return showRawValue ? value : unknownLabel;\n  }\n\n  /**\n   * Request a merge tag from the user. Precedence:\n   *  1. `onRequestMergeTag` callback (consumer-owned UX)\n   *  2. Built-in picker over `mergeTags.tags`\n   *  3. null (nothing configured)\n   */\n  async function requestMergeTag(\n    context?: MergeTagRequestContext,\n  ): Promise<MergeTag | null> {\n    if (onRequestMergeTag) {\n      isRequesting.value = true;\n      try {\n        return await onRequestMergeTag(context);\n      } finally {\n        isRequesting.value = false;\n      }\n    }\n    if (mergeTags.value.length > 0 && picker) {\n      isRequesting.value = true;\n      try {\n        return await picker.open(mergeTags.value, {\n          current: context?.current,\n        });\n      } finally {\n        isRequesting.value = false;\n      }\n    }\n    return null;\n  }\n\n  // Computed, not a snapshot: `setMergeTags` can take the list from empty to\n  // populated, and a plain boolean captured here would leave the \"Insert merge\n  // tag\" affordance hidden for the rest of the session.\n  const canRequestMergeTag = computed(\n    () => !!onRequestMergeTag || mergeTags.value.length > 0,\n  );\n\n  return {\n    mergeTags,\n    isRequesting,\n    canRequestMergeTag,\n    autocomplete,\n    syntax,\n    isMergeTagValue,\n    getMergeTagLabel,\n    findMergeTag,\n    canRepickMergeTag,\n    getMergeTagDisplayLabel,\n    showRawValue,\n    requestMergeTag,\n  };\n}\n"],"mappings":";;;;AA6GA,SAAgBmB,IAAiC;CAC/C,IAAMC,IAAYhB,EAAOS,GAAgBF,CAAa,GAChDU,IAASjB,EAAOU,GAAsBL,EAAe,MAAM,GAC3Da,IAAoBlB,EAAOW,GAA0B,IAAI,GACzDQ,IAAenB,EAAOc,GAA4B,EAAI,GAGtDM,IAASpB,EAAOM,GAAsB,IAAI,GAC1Ce,IAAerB,EAAOQ,GAA8B,EAAI,GAMxDc,IADuBtB,EAAOY,GAAkB,IAEpD,CAAA,EAAsB,SAAS,gBAAgB,aAI3CW,IAAevB,EAAOa,GAA0B,IAAI,KAAKZ,EAAI,EAAK;CAExE,SAASL,EAAgB,GAAwB;EAC/C,OAAOC,EAAqB4B,GAAOR,CAAM;CAC3C;CAEA,SAASnB,EAAiB,GAAuB;EAC/C,OAAOC,EAAqB0B,GAAOT,EAAU,KAAK;CACpD;CAEA,SAASW,EAAa,GAAqC;EACzD,OAAOX,EAAU,MAAM,MAAM,MAAQY,EAAI,UAAUH,CAAK;CAC1D;CAEA,SAASI,EAAkB,GAAwB;EACjD,OAAO,CAAC,CAACX,KAAqBS,EAAaF,CAAK,MAAM,KAAA;CACxD;CAEA,SAASK,EACP,GACA,GACQ;EACR,IAAMC,IAAWJ,EAAaF,CAAK;EAUnC,OATIM,IAAiBA,EAAS,QAQ1BC,GAAa,KAAK,IAAUA,EAAY,KAAK,IAC1CX,IAAeI,IAAQH;CAChC;CAQA,eAAeW,EACb,GAC0B;EAC1B,IAAIf,GAAmB;GACrB,EAAa,QAAQ;GACrB,IAAI;IACF,OAAO,MAAMA,EAAkBgB,CAAO;GACxC,UAAU;IACR,EAAa,QAAQ;GACvB;EACF;EACA,IAAIlB,EAAU,MAAM,SAAS,KAAKI,GAAQ;GACxC,EAAa,QAAQ;GACrB,IAAI;IACF,OAAO,MAAMA,EAAO,KAAKJ,EAAU,OAAO,EACxC,SAASkB,GAAS,QACpB,CAAC;GACH,UAAU;IACR,EAAa,QAAQ;GACvB;EACF;EACA,OAAO;CACT;CASA,OAAO;EACL;EACA;EACA,oBAPyBhC,QACnB,CAAC,CAACgB,KAAqBF,EAAU,MAAM,SAAS,CAMtD;EACA;EACA;EACA,iBAAAQ;EACA,kBAAAE;EACA;EACA;EACA;EACA;EACA;CACF;AACF"}