@hyperfixi/core 2.9.4 → 2.10.0

package/dist/ast-utils/index.js

@@ -5504,7 +5504,7 @@ function getSchema(action) {
 function getDefinedSchemas() {
   return Object.values(commandSchemas).filter((s) => s.roles.length > 0 || s.bareKeyword === true);
 }
-var toggleSchema, addSchema, removeSchema, putSchema, setSchema, bindSchema, liveSchema, eventsourceSchema, socketSchema, workerSchema, interceptSchema, showSchema, hideSchema, onSchema, triggerSchema, waitSchema, fetchSchema, incrementSchema, decrementSchema, appendSchema, prependSchema, logSchema, getCommandSchema, takeSchema, makeSchema, haltSchema, settleSchema, throwSchema, sendSchema, ifSchema, unlessSchema, elseSchema, repeatSchema, forSchema, whileSchema, continueSchema, URL_MARKER_ALL_LANGS, goSchema, transitionSchema, cloneSchema, focusSchema, blurSchema, emptySchema, openSchema, closeSchema, selectSchema, clearSchema, resetSchema, breakpointSchema, callSchema, returnSchema, jsSchema, asyncSchema, tellSchema, defaultSchema, initSchema, behaviorSchema, installSchema, measureSchema, swapSchema, morphSchema, beepSchema, breakSchema, copySchema, exitSchema, pickSchema, scrollSchema, PARTIALS_IN_MARKER_ALL_LANGS, pushSchema, replaceSchema, processSchema, renderSchema, commandSchemas;
+var toggleSchema, addSchema, removeSchema, putSchema, setSchema, bindSchema, liveSchema, eventsourceSchema, socketSchema, workerSchema, interceptSchema, showSchema, hideSchema, onSchema, triggerSchema, waitSchema, fetchSchema, incrementSchema, decrementSchema, appendSchema, prependSchema, logSchema, getCommandSchema, takeSchema, makeSchema, haltSchema, settleSchema, throwSchema, sendSchema, ifSchema, unlessSchema, elseSchema, repeatSchema, forSchema, whileSchema, continueSchema, URL_MARKER_ALL_LANGS, goSchema, transitionSchema, cloneSchema, focusSchema, blurSchema, emptySchema, openSchema, closeSchema, selectSchema, clearSchema, resetSchema, breakpointSchema, callSchema, returnSchema, jsSchema, asyncSchema, tellSchema, defaultSchema, initSchema, behaviorSchema, installSchema, measureSchema, USING_VIEW_MARKER_ALL_LANGS, VIEW_TRANSITION_MANNER_ROLE, swapSchema, morphSchema, beepSchema, breakSchema, copySchema, exitSchema, pickSchema, scrollSchema, PARTIALS_IN_MARKER_ALL_LANGS, pushSchema, replaceSchema, processSchema, renderSchema, commandSchemas;
 var init_command_schemas = __esm({
   "src/generators/command-schemas.ts"() {
     toggleSchema = {
@@ -5513,7 +5513,6 @@ var init_command_schemas = __esm({
       category: "dom-class",
       primaryRole: "patient",
       // `toggle .active on #btn for 2s` \u2192 args ['.active'], modifiers { on, for }.
-      // NOTE: `duration` is read here but not declared in `roles` below.
       ast: { args: ["patient"], modifiers: { on: "destination", for: "duration" } },
       roles: [
         {
@@ -6604,8 +6603,8 @@ var init_command_schemas = __esm({
       description: "Take content from a source element",
       category: "dom-content",
       primaryRole: "patient",
-      // `take .active from #parent` \u2192 args ['.active'], modifiers { from: '#parent' }.
-      ast: { args: ["patient"], modifiers: { from: "source" } },
+      // `take .active from #parent for me` \u2192 args ['.active'], modifiers { from, for }.
+      ast: { args: ["patient"], modifiers: { from: "source", for: "recipient" } },
       roles: [
         {
           role: "patient",
@@ -6628,6 +6627,38 @@ var init_command_schemas = __esm({
           expectedTypes: ["selector", "reference"],
           svoPosition: 2,
           sovPosition: 1
+        },
+        {
+          role: "recipient",
+          description: "The element the class moves ONTO (`take .active from .tab for me`)",
+          required: false,
+          // References only, deliberately. Upstream accepts an element expression,
+          // but the 23 non-en corpus surfaces carry the recipient as a BARE
+          // trailing pronoun (i18n renders `\u2026 von .tab-button ich`), so this slot
+          // is marker-less almost everywhere and a selector-typed slot would
+          // swallow the second selector of `take .active from .a .b`. English is
+          // unaffected: `take` is on the core parser's skipSemanticParsing list,
+          // so the traditional parser owns `for <anything>` there.
+          expectedTypes: ["reference"],
+          svoPosition: 3,
+          sovPosition: 3,
+          // NO default. The runtime already defaults the recipient to `me`
+          // (commands/animation/take.ts), and a schema default would emit an
+          // explicit `for me` modifier on every take \u2014 re-smuggling the exact
+          // "absent means absent" semantics #859 removed from `source`.
+          //
+          // Shape-anchored on `reference`: without it this optional slot weighs
+          // into every take pattern's denominator in `scoreRoleCoverage`, dropping
+          // plain `take .active from .tab-button` from 1.0 to ~0.69 \u2014 the toggle-es
+          // regression class the R1 role-set flip ratchet exists to catch.
+          valueShape: "reference",
+          // en only. The other 23 languages render the recipient unmarked, so a
+          // marker there would never match their corpus rows; where the marker-less
+          // slot proves inert they stay uncaptured and the pattern lands in the
+          // baseline's `roleLossyPatterns` as named R1 burn-down tail. A language
+          // gets a real particle here ONLY if the empty slot perturbs its other
+          // parses (toggle's ja \u9593 / ko \ub3d9\uc548 case).
+          markerOverride: { en: "for" }
         }
       ]
     };
@@ -7692,6 +7723,47 @@ var init_command_schemas = __esm({
         }
       ]
     };
+    USING_VIEW_MARKER_ALL_LANGS = {
+      en: "using view",
+      es: "using view",
+      pt: "using view",
+      fr: "using view",
+      de: "using view",
+      it: "using view",
+      ja: "using view",
+      ko: "using view",
+      zh: "using view",
+      ar: "using view",
+      he: "using view",
+      hi: "using view",
+      bn: "using view",
+      tr: "using view",
+      ru: "using view",
+      uk: "using view",
+      pl: "using view",
+      id: "using view",
+      vi: "using view",
+      th: "using view",
+      ms: "using view",
+      tl: "using view",
+      sw: "using view",
+      qu: "using view"
+    };
+    VIEW_TRANSITION_MANNER_ROLE = {
+      role: "manner",
+      description: "Run the swap inside a `document.startViewTransition()` (`using view transition`)",
+      required: false,
+      // Both types, because the SAME word tokenizes differently per language and
+      // the difference is an accident of vocabulary: `transition` is a command
+      // keyword in en/fr (it is also their verb) and a bare identifier everywhere
+      // else, which types it `literal` in the first group and `expression` in the
+      // second. Measured: with `['literal']` alone only en and fr captured the
+      // tail. Widening is safe precisely because the slot is marker-guarded \u2014
+      // nothing reaches it until `using view` has matched.
+      expectedTypes: ["literal", "expression"],
+      valueShape: "keyword",
+      markerOverride: USING_VIEW_MARKER_ALL_LANGS
+    };
     swapSchema = {
       action: "swap",
       description: "Swap DOM content using various strategies (innerHTML, outerHTML, delete, etc.)",
@@ -7712,7 +7784,11 @@ var init_command_schemas = __esm({
       // work. Preserved verbatim by the Arc F migration (a faithful migration must
       // not change output) and pinned as two `drift` exemptions; this is the
       // behavior fix those entries were waiting for.
-      ast: { args: ["method", "destination", "patient"] },
+      //
+      // `manner` is the exception to "keyword-positional args": it rides as
+      // `modifiers.viewTransition`, which SwapCommand.parseInput reads for presence
+      // alongside its existing flat-args `using`/`view`/`transition` scan.
+      ast: { args: ["method", "destination", "patient"], modifiers: { viewTransition: "manner" } },
       roles: [
         {
           role: "method",
@@ -7807,6 +7883,11 @@ var init_command_schemas = __esm({
             ar: "\u0628\u0640",
             tl: "nang"
           }
+        },
+        {
+          ...VIEW_TRANSITION_MANNER_ROLE,
+          svoPosition: 4,
+          sovPosition: 4
         }
       ]
     };
@@ -7817,7 +7898,15 @@ var init_command_schemas = __esm({
       primaryRole: "patient",
       // `morph #list to it` \u2192 args [content], modifiers { on: element }.
       // Content is source or destination; the element being morphed is the patient.
-      ast: { args: [["source", "destination"]], modifiers: { on: "patient" } },
+      //
+      // `manner` rides as `modifiers.viewTransition`, same as swap/process \u2014
+      // MorphCommand.parseInput reads it for presence alongside its existing
+      // flat-args `using`/`view`/`transition` scan (the traditional-parser path,
+      // which owns English because morph sits on SKIP_SEMANTIC_COMMANDS).
+      ast: {
+        args: [["source", "destination"]],
+        modifiers: { on: "patient", viewTransition: "manner" }
+      },
       roles: [
         {
           role: "patient",
@@ -7838,6 +7927,18 @@ var init_command_schemas = __esm({
           sovPosition: 2,
           markerOverride: { en: "to" }
           // "morph #target to it"
+        },
+        {
+          // `morph #target to it using view transition` \u2014 the same tail as swap and
+          // process, closed here for the same reason (#870's third-schema filing):
+          // without the role the semantic parser matched morph at confidence 1.0
+          // and stranded the tail, so every semantic-only consumer (multilingual
+          // bundles, the bridge, `translate()`) silently dropped the animation
+          // request in all 24 languages. Morph has NO hand-written patterns in any
+          // language, so this schema role is the whole fix on the pattern side.
+          ...VIEW_TRANSITION_MANNER_ROLE,
+          svoPosition: 3,
+          sovPosition: 3
         }
       ]
     };
@@ -8024,6 +8125,13 @@ var init_command_schemas = __esm({
       description: "Process hx-partial markup in HTML content",
       category: "dom-content",
       primaryRole: "patient",
+      // `process partials in it` \u2192 args ['it']; the optional tail rides as
+      // `modifiers.viewTransition`, which ProcessPartialsCommand.parseInput has
+      // read since #861 (`raw.modifiers?.viewTransition !== undefined`). Without a
+      // descriptor this schema fell through to `buildGenericCommand`, whose
+      // modifier list is fixed (destination/duration/method/style) and would have
+      // dropped a captured `manner` on the floor.
+      ast: { args: ["patient"], modifiers: { viewTransition: "manner" } },
       roles: [
         {
           role: "patient",
@@ -8033,6 +8141,11 @@ var init_command_schemas = __esm({
           svoPosition: 1,
           sovPosition: 1,
           markerOverride: PARTIALS_IN_MARKER_ALL_LANGS
+        },
+        {
+          ...VIEW_TRANSITION_MANNER_ROLE,
+          svoPosition: 2,
+          sovPosition: 2
         }
       ]
     };
@@ -9488,7 +9601,9 @@ var init_french = __esm({
         trigger: { primary: "d\xE9clencher", normalized: "trigger" },
         send: { primary: "envoyer", alternatives: ["envoie"], normalized: "send" },
         focus: { primary: "focaliser", alternatives: ["concentrer"], normalized: "focus" },
-        blur: { primary: "d\xE9focaliser", normalized: "blur" },
+        // `d\u00e9focaliser` is an unattested infinitive; French pedagogy writes
+        // `perte de focus` for the event (2026-07 terminology review).
+        blur: { primary: "perte de focus", alternatives: ["d\xE9focaliser"], normalized: "blur" },
         // Phase 1 (v0.9.90): DOM / form state / debug
         // `vide` (adjective, "empty") is the i18n transformer's `is empty` predicate
         // form; `vider` is the verb ("to empty"). Accept both so the emptiness check
@@ -9501,7 +9616,13 @@ var init_french = __esm({
         reset: { primary: "r\xE9initialiser", alternatives: ["reinitialiser"], normalized: "reset" },
         breakpoint: { primary: "point-arr\xEAt", alternatives: ["point-arret"], normalized: "breakpoint" },
         go: { primary: "aller", alternatives: ["naviguer", "va"], normalized: "go" },
-        scroll: { primary: "d\xE9filer", alternatives: ["faire-d\xE9filer"], normalized: "scroll" },
+        // MDN fr and the OQLF standardize the noun `d\u00e9filement` for the event; the
+        // infinitive stays as an alternative.
+        scroll: {
+          primary: "d\xE9filement",
+          alternatives: ["defilement", "d\xE9filer", "faire-d\xE9filer"],
+          normalized: "scroll"
+        },
         push: { primary: "pousser", normalized: "push" },
         replace: { primary: "remplacer", normalized: "replace" },
         process: { primary: "traiter", normalized: "process" },
@@ -9567,9 +9688,15 @@ var init_french = __esm({
         after: { primary: "apr\xE8s", normalized: "after" },
         // Common event names (for event handler patterns)
         click: { primary: "clic", alternatives: ["clique"], normalized: "click" },
-        // `resize` event (window-resize): dict emits redimensionner; register it so the
-        // event types as literal="resize" (matching en) instead of expression.
-        resize: { primary: "redimensionner", normalized: "resize" },
+        // `resize` event (window-resize): the noun `redimensionnement` is the
+        // attested event form ("lors du redimensionnement de la fen\u00eatre"). The dict
+        // still emits redimensionner, kept as an alternative so the event keeps
+        // typing as literal="resize" (matching en) instead of expression.
+        resize: {
+          primary: "redimensionnement",
+          alternatives: ["redimensionner"],
+          normalized: "resize"
+        },
         hover: { primary: "survol", alternatives: ["survoler"], normalized: "hover" },
         submit: { primary: "soumission", alternatives: ["soumettre"], normalized: "submit" },
         input: { primary: "saisie", alternatives: ["entr\xE9e"], normalized: "input" },
@@ -13352,9 +13479,17 @@ var init_turkish = __esm({
         on: { primary: "\xFCzerinde", alternatives: ["zaman"], normalized: "on" },
         trigger: { primary: "tetikle", normalized: "trigger" },
         send: { primary: "g\xF6nder", normalized: "send" },
-        // DOM focus
-        focus: { primary: "odak", alternatives: ["odaklanma"], normalized: "focus" },
-        blur: { primary: "bulan\u0131k", alternatives: ["bulan\u0131kl\u0131k", "bulanik"], normalized: "blur" },
+        // DOM focus. `odaklanma` (the act of focusing) leads over the static state
+        // noun `odak` \u2014 Turkish event prose says "odaklanma olay\u0131". `bulan\u0131k` was
+        // the optical blur (CSS filters, image processing), never the DOM event;
+        // native usage is `odak kayb\u0131` (loss of focus). 2026-07 terminology-review
+        // corrections; old forms stay as parse alternatives.
+        focus: { primary: "odaklanma", alternatives: ["odak"], normalized: "focus" },
+        blur: {
+          primary: "odak kayb\u0131",
+          alternatives: ["odak kaybi", "bulan\u0131k", "bulan\u0131kl\u0131k", "bulanik"],
+          normalized: "blur"
+        },
         // Phase 1 (v0.9.90): DOM / form state / debug
         empty: { primary: "bo\u015Falt", alternatives: ["bosalt", "bo\u015F"], normalized: "empty" },
         open: { primary: "a\xE7", alternatives: ["ac"], normalized: "open" },
@@ -13375,7 +13510,9 @@ var init_turkish = __esm({
         },
         hover: { primary: "\xFCzerine gelme", alternatives: ["\xFCzerinde gezinme"], normalized: "hover" },
         submit: { primary: "g\xF6nderme", normalized: "submit" },
-        input: { primary: "giri\u015F", alternatives: ["girdi", "giris"], normalized: "input" },
+        // `giri\u015f` reads as entry/login (giri\u015f yapma) and can imply an auth event;
+        // the data-input term is `girdi` ("Girdi (Input) Eventleri").
+        input: { primary: "girdi", alternatives: ["giri\u015F", "giris"], normalized: "input" },
         change: { primary: "de\u011Fi\u015Fiklik", alternatives: ["de\u011Fi\u015Fim", "degisim"], normalized: "change" },
         // `load` event: the i18n dict emits y\u00fckle for `load`. Without this keyword the
         // SOV reorder's mid-stream `y\u00fckle de` (on load) tokenized as the `install`
@@ -13385,7 +13522,13 @@ var init_turkish = __esm({
         load: { primary: "y\xFCkle", normalized: "load" },
         // Navigation
         go: { primary: "git", normalized: "go" },
-        scroll: { primary: "kayd\u0131r", alternatives: ["kaydir"], normalized: "scroll" },
+        // `kayd\u0131r` is the bare imperative; the attested event noun is `kayd\u0131rma`
+        // ("kayd\u0131rma olay\u0131"). The imperative stays as an alternative.
+        scroll: {
+          primary: "kayd\u0131rma",
+          alternatives: ["kaydirma", "kayd\u0131r", "kaydir"],
+          normalized: "scroll"
+        },
         push: { primary: "itele", alternatives: ["push"], normalized: "push" },
         replace: { primary: "de\u011Fi\u015Ftir_url", alternatives: ["degistir_url"], normalized: "replace" },
         process: { primary: "i\u015Fle", alternatives: ["isle"], normalized: "process" },
@@ -14338,6 +14481,49 @@ var init_chinese = __esm({
   }
 });
 
+// src/parser/utils/marker-resolution.ts
+function resolveMarkerForRole(roleSpec, profile) {
+  const overrideMarker = roleSpec.markerOverride?.[profile.code];
+  const defaultMarker = profile.roleMarkers[roleSpec.role];
+  if (overrideMarker !== void 0) {
+    const alternatives = legacyMarkerAlternatives(roleSpec, profile.code, overrideMarker);
+    return {
+      primary: overrideMarker,
+      ...alternatives && { alternatives },
+      position: defaultMarker?.position ?? "before",
+      isOverride: true
+    };
+  }
+  if (defaultMarker && defaultMarker.primary) {
+    const result = {
+      primary: defaultMarker.primary,
+      position: defaultMarker.position,
+      isOverride: false
+    };
+    if (defaultMarker.alternatives) {
+      result.alternatives = defaultMarker.alternatives;
+    }
+    return result;
+  }
+  return null;
+}
+function legacyMarkerAlternatives(roleSpec, languageCode, overrideMarker) {
+  const legacy = roleSpec.markerLegacy?.[languageCode];
+  if (!legacy?.length) return void 0;
+  const alternatives = [...new Set(legacy)].filter((a) => a && a !== overrideMarker);
+  return alternatives.length ? alternatives : void 0;
+}
+function schemaMarkerAlternatives(roleSpec, languageCode, marker) {
+  const legacy = roleSpec.markerLegacy?.[languageCode] ?? [];
+  const variants = roleSpec.methodCarrier ? [] : roleSpec.markerVariants?.[languageCode] ?? [];
+  const alternatives = [.../* @__PURE__ */ new Set([...legacy, ...variants])].filter((a) => a && a !== marker);
+  return alternatives.length ? alternatives : void 0;
+}
+var init_marker_resolution = __esm({
+  "src/parser/utils/marker-resolution.ts"() {
+  }
+});
+
 // src/patterns/put.ts
 function getPutPatternsBn() {
   return [
@@ -29137,49 +29323,6 @@ var init_role_positioning = __esm({
   }
 });
 
-// src/parser/utils/marker-resolution.ts
-function resolveMarkerForRole(roleSpec, profile) {
-  const overrideMarker = roleSpec.markerOverride?.[profile.code];
-  const defaultMarker = profile.roleMarkers[roleSpec.role];
-  if (overrideMarker !== void 0) {
-    const alternatives = legacyMarkerAlternatives(roleSpec, profile.code, overrideMarker);
-    return {
-      primary: overrideMarker,
-      ...alternatives && { alternatives },
-      position: defaultMarker?.position ?? "before",
-      isOverride: true
-    };
-  }
-  if (defaultMarker && defaultMarker.primary) {
-    const result = {
-      primary: defaultMarker.primary,
-      position: defaultMarker.position,
-      isOverride: false
-    };
-    if (defaultMarker.alternatives) {
-      result.alternatives = defaultMarker.alternatives;
-    }
-    return result;
-  }
-  return null;
-}
-function legacyMarkerAlternatives(roleSpec, languageCode, overrideMarker) {
-  const legacy = roleSpec.markerLegacy?.[languageCode];
-  if (!legacy?.length) return void 0;
-  const alternatives = [...new Set(legacy)].filter((a) => a && a !== overrideMarker);
-  return alternatives.length ? alternatives : void 0;
-}
-function schemaMarkerAlternatives(roleSpec, languageCode, marker) {
-  const legacy = roleSpec.markerLegacy?.[languageCode] ?? [];
-  const variants = roleSpec.methodCarrier ? [] : roleSpec.markerVariants?.[languageCode] ?? [];
-  const alternatives = [.../* @__PURE__ */ new Set([...legacy, ...variants])].filter((a) => a && a !== marker);
-  return alternatives.length ? alternatives : void 0;
-}
-var init_marker_resolution = __esm({
-  "src/parser/utils/marker-resolution.ts"() {
-  }
-});
-
 // src/generators/event-handlers-sov.ts
 function resolveRoleMarker(roleSpec, profile) {
   let marker;
@@ -29213,6 +29356,43 @@ function appendOptionalScope(tokens, extraction, commandSchema) {
   });
   extraction.scope = { fromRole: "scope" };
 }
+function appendOptionalViewTransition(tokens, extraction, commandSchema, languageCode) {
+  appendOptionalTailRole(tokens, extraction, commandSchema, languageCode, "manner", {
+    requireMarker: true
+  });
+}
+function appendOptionalRecipient(tokens, extraction, commandSchema, languageCode) {
+  appendOptionalTailRole(tokens, extraction, commandSchema, languageCode, "recipient", {
+    requireMarker: false
+  });
+}
+function appendOptionalTailRole(tokens, extraction, commandSchema, languageCode, role, opts) {
+  const spec = commandSchema.roles.find((r) => r.role === role && !r.required);
+  if (!spec) return;
+  const marker = spec.markerOverride?.[languageCode];
+  if (opts.requireMarker && !marker) return;
+  tokens.push({
+    type: "group",
+    optional: true,
+    tokens: [
+      ...(marker ? marker.split(/\s+/) : []).map(
+        (word) => ({ type: "literal", value: word })
+      ),
+      {
+        type: "role",
+        role,
+        optional: true,
+        expectedTypes: spec.expectedTypes,
+        // Load-bearing, same as on the generated command patterns: it exempts
+        // the trailing slot from the matcher's verb guard, keeps the uncaptured
+        // slot out of `scoreRoleCoverage`'s denominator, and (for `keyword`)
+        // normalizes the captured value type to the EN reference's `literal`.
+        ...spec.valueShape !== void 0 ? { valueShape: spec.valueShape } : {}
+      }
+    ]
+  });
+  extraction[role] = { fromRole: role };
+}
 function generateSOVEventHandlerPattern(commandSchema, profile, keyword, eventMarker, config) {
   const tokens = [];
   tokens.push({ type: "role", role: "event", optional: false });
@@ -29307,6 +29487,15 @@ function generateSOVPatientFirstEventHandlerPattern(commandSchema, profile, keyw
   tokens.push(
     ...swapsOperands ? eventHandlerPatientGroup(commandSchema, trailingMarker) : eventHandlerDestinationGroup(commandSchema, trailingMarker)
   );
+  const extraction = {
+    action: { value: commandSchema.action },
+    event: { fromRole: "event" },
+    [frontedRole]: { fromRole: frontedRole },
+    ...swapsOperands ? {} : eventHandlerDestinationExtraction(commandSchema),
+    ...eventHandlerSourceExtraction(commandSchema)
+  };
+  appendOptionalRecipient(tokens, extraction, commandSchema, profile.code);
+  appendOptionalViewTransition(tokens, extraction, commandSchema, profile.code);
   return {
     id: `${commandSchema.action}-event-${profile.code}-sov-patient-first`,
     language: profile.code,
@@ -29316,13 +29505,7 @@ function generateSOVPatientFirstEventHandlerPattern(commandSchema, profile, keyw
       format: `{patient} ${patientMarker?.primary || ""} {event} ${eventMarker.primary} ${keyword.primary}`,
       tokens
     },
-    extraction: {
-      action: { value: commandSchema.action },
-      event: { fromRole: "event" },
-      [frontedRole]: { fromRole: frontedRole },
-      ...swapsOperands ? {} : eventHandlerDestinationExtraction(commandSchema),
-      ...eventHandlerSourceExtraction(commandSchema)
-    }
+    extraction
   };
 }
 function generateSOVPatientFirstWithDestEventHandlerPattern(commandSchema, profile, keyword, eventMarker, config) {
@@ -29764,6 +29947,16 @@ function generateVSOVerbFirstEventHandlerPattern(commandSchema, profile, keyword
       });
     }
   }
+  const extraction = {
+    action: { value: commandSchema.action },
+    event: { fromRole: "event" },
+    [swapsOperands ? "destination" : "patient"]: {
+      fromRole: swapsOperands ? "destination" : "patient"
+    },
+    ...swapsOperands ? {} : eventHandlerDestinationExtraction(commandSchema),
+    ...eventHandlerSourceExtraction(commandSchema)
+  };
+  appendOptionalViewTransition(tokens, extraction, commandSchema, profile.code);
   return {
     id: `${commandSchema.action}-event-${profile.code}-vso-verb-first`,
     language: profile.code,
@@ -29774,15 +29967,7 @@ function generateVSOVerbFirstEventHandlerPattern(commandSchema, profile, keyword
       format: `${keyword.primary} {patient} ${destMarker?.primary || ""} {destination?} ${eventMarker.primary} {event}`,
       tokens
     },
-    extraction: {
-      action: { value: commandSchema.action },
-      event: { fromRole: "event" },
-      [swapsOperands ? "destination" : "patient"]: {
-        fromRole: swapsOperands ? "destination" : "patient"
-      },
-      ...swapsOperands ? {} : eventHandlerDestinationExtraction(commandSchema),
-      ...eventHandlerSourceExtraction(commandSchema)
-    }
+    extraction
   };
 }
 function generateVSOVerbFirstTwoRoleEventHandlerPattern(commandSchema, profile, keyword, eventMarker, config) {
@@ -30357,7 +30542,11 @@ function buildRoleToken(roleSpec, profile) {
     type: "role",
     role: roleSpec.role,
     optional: !roleSpec.required,
-    expectedTypes: roleSpec.expectedTypes
+    expectedTypes: roleSpec.expectedTypes,
+    // The matcher reads this too \u2014 a `'keyword'`-shaped slot holds a fixed
+    // keyword phrase (`using view transition`) and must not be skipped by the
+    // trailing-slot verb guard.
+    ...roleSpec.valueShape !== void 0 ? { valueShape: roleSpec.valueShape } : {}
   };
   const prefixLiteral = roleSpec.valuePrefixLiteral?.[profile.code];
   const pushPrefixed = () => {
@@ -30638,9 +30827,24 @@ var init_pick = __esm({
 });
 
 // src/patterns/languages/en/swap.ts
-var swapSimpleEnglish, swapElementEnglish, swapStrategyOfEnglish, swapStrategyEnglish, swapPatternsEn;
+var VIEW_TRANSITION_TAIL, swapSimpleEnglish, swapElementEnglish, swapStrategyOfEnglish, swapStrategyEnglish, swapPatternsEn;
 var init_swap = __esm({
   "src/patterns/languages/en/swap.ts"() {
+    VIEW_TRANSITION_TAIL = {
+      type: "group",
+      optional: true,
+      tokens: [
+        { type: "literal", value: "using" },
+        { type: "literal", value: "view" },
+        {
+          type: "role",
+          role: "manner",
+          optional: true,
+          expectedTypes: ["literal", "expression"],
+          valueShape: "keyword"
+        }
+      ]
+    };
     swapSimpleEnglish = {
       id: "swap-en-handcrafted",
       language: "en",
@@ -30648,11 +30852,12 @@ var init_swap = __esm({
       priority: 110,
       // Higher than generated patterns
       template: {
-        format: "swap {method} {destination}",
+        format: "swap {method} {destination} [using view {manner}]",
         tokens: [
           { type: "literal", value: "swap" },
           { type: "role", role: "method" },
-          { type: "role", role: "destination" }
+          { type: "role", role: "destination" },
+          VIEW_TRANSITION_TAIL
         ]
       },
       extraction: {
@@ -30666,12 +30871,13 @@ var init_swap = __esm({
       command: "swap",
       priority: 120,
       template: {
-        format: "swap {destination} with {patient}",
+        format: "swap {destination} with {patient} [using view {manner}]",
         tokens: [
           { type: "literal", value: "swap" },
           { type: "role", role: "destination" },
           { type: "literal", value: "with" },
-          { type: "role", role: "patient" }
+          { type: "role", role: "patient" },
+          VIEW_TRANSITION_TAIL
         ]
       },
       extraction: {}
@@ -30682,14 +30888,15 @@ var init_swap = __esm({
       command: "swap",
       priority: 140,
       template: {
-        format: "swap {method} of {destination} with {patient}",
+        format: "swap {method} of {destination} with {patient} [using view {manner}]",
         tokens: [
           { type: "literal", value: "swap" },
           { type: "role", role: "method" },
           { type: "literal", value: "of" },
           { type: "role", role: "destination" },
           { type: "literal", value: "with" },
-          { type: "role", role: "patient" }
+          { type: "role", role: "patient" },
+          VIEW_TRANSITION_TAIL
         ]
       },
       extraction: {}
@@ -30700,13 +30907,14 @@ var init_swap = __esm({
       command: "swap",
       priority: 130,
       template: {
-        format: "swap {method} {destination} with {patient}",
+        format: "swap {method} {destination} with {patient} [using view {manner}]",
         tokens: [
           { type: "literal", value: "swap" },
           { type: "role", role: "method" },
           { type: "role", role: "destination" },
           { type: "literal", value: "with" },
-          { type: "role", role: "patient" }
+          { type: "role", role: "patient" },
+          VIEW_TRANSITION_TAIL
         ]
       },
       extraction: {}
@@ -32443,6 +32651,7 @@ init_vietnamese();
 init_chinese();
 
 // src/parser/pattern-matcher.ts
+init_marker_resolution();
 init_command_schemas();
 
 // src/parser/utils/possessive-keywords.ts
@@ -32480,6 +32689,7 @@ init_base();
 // src/parser/semantic-parser.ts
 init_registry();
 init_command_schemas();
+init_marker_resolution();
 
 // src/parser/block-parser.ts
 init_registry();