# Migrating to `lr-*` Migration decisions come from the pinned, schema-validated component inventory. A matching name does not by itself prove API compatibility. The codemod changes only `exact` and `rewritten` mappings; `warning-required`, `conceptual-only`, `unsupported`, and unknown tags stay unchanged and receive location-aware warnings. The version-matched CLI ships with the package and runs without a repository checkout. Replace `` with the installed Lyra major/minor/patch you are targeting: ```bash npx --package @aceshooting/lyra-ui@ lyra-ui-migrate --check --report=lyra-migration.json src ``` `--check` never writes source files and exits nonzero while rewrites or warnings remain, which makes it suitable for CI after an applied migration. The supported upstream identities are `@awesome.me/webawesome` and `@awesome.me/webawesome-pro` for Web Awesome, plus `@shoelace-style/shoelace`. The tool scans HTML, standalone CSS, JavaScript, TypeScript, JSX, Vue, Svelte, MDX, and Markdown. It rewrites inventory-declared tags, members, defaults, and supported side-effect registration imports. Imports with bindings remain manual because exported names cannot be inferred safely. An aliased component value that uses a rewritten member blocks that mapping across the scanned target set, preventing a registration import from changing while an old member remains. A root Web Awesome or Shoelace registration import changes only when that package identity and tier prove the registration closure and no manual component use exists anywhere in the scanned target set. Root-included targets use `@aceshooting/lyra-ui/all.js`; root-excluded targets receive granular registration imports. An automatic-looking tag with no matching side-effect registration in the scanned target set stays unchanged with `REGISTRATION_CLOSURE_REQUIRED`; include the registration-owning entry file in the scan instead of accepting an inert `lr-*` result. Targets with optional runtime peers also emit an `OPTIONAL_PEER_REQUIRED` report entry naming each package that must be installed. Migrated Web Awesome and Shoelace icon tags emit `BEHAVIOR_REVIEW_REQUIRED` because Lyra's dependency-free default library contains only `add`, `check`, `close`, `search`, `menu`, `chevron-left`, `chevron-right`, `chevron-down`, `calendar`, `command`, and `trash`. Replace other names explicitly or provide their vocabulary with `registerIconLibrary('default', { resolver })`. Re-running the tool is idempotent; comments, prose, partial strings, and unrelated packages are left alone. The JSON migration report records every rewrite and warning with its file, line, column, origin, tag/member, action, target, and warning code. Run without `--check` only after inspecting that report and the target component reference in `llms/components/.md`. `dir` and `lang` are platform-global HTML passthrough attributes, not component-member drift. Web Awesome's `did-ssr` is its runtime hydration marker, not an authored member to recreate or rename on a Lyra component. The inventory records these exclusions explicitly. ## Migrating Lyra 7 defaults The local defaults profile is opt-in and separate from Web Awesome/Shoelace migration. It never renames an `lr-*` tag or import; it only inserts an absent attribute that preserves a changed Lyra 7 default. Boolean `true` is emitted as canonical attribute presence, including the positive inverse `without-arrow` spelling. ```bash npx --package @aceshooting/lyra-ui@ lyra-ui-migrate --origin=lyra-v7 --check --report=lyra-v7-migration.json src ``` Opaque framework spreads and DOM aliases block that component profile across the scanned target set with a warning. Expand or classify them before applying, then rerun to verify byte idempotence. | Origin | Component | Inserted only when absent | |---|---|---| | `lyra-v7` | `` | `placement="bottom-start"`, `distance="4"`, presence `without-arrow` | | `lyra-v7` | `` | `strategy="fixed"`, `placement="bottom-start"`, `distance="4"`, presence `flip`, presence `shift` | | `lyra-v7` | `` | `distance="6"`, presence `without-arrow` | ## Classification summary | Ecosystem | Exact | Rewritten | Warning required | Conceptual only | Unsupported | Automatic | Manual | |---|---:|---:|---:|---:|---:|---:|---:| | Web Awesome | 34 | 38 | 15 | 0 | 0 | 72 | 15 | | Shoelace | 18 | 28 | 12 | 0 | 0 | 46 | 12 | | **Total** | **52** | **66** | **27** | **0** | **0** | **118** | **27** | ## Web Awesome (87) The pinned Web Awesome manifest is authoritative for this inventory; only rows marked automatic are codemod inputs. | From | Lyra target or candidate | Classification | Disposition | |---|---|---|---| | `` | `` | `warning-required` | Manual: Lyra snapshots each expand/collapse event detail into a frozen readonly value at dispatch time rather than exposing a live mutable item reference; migrated handlers that mutate the event detail in place must be reviewed. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Native disclosure and coordinated accordion panels. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-error → lr-error; events: wa-load → lr-load. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-cancel → lr-cancel; events: wa-finish → lr-finish; events: wa-start → lr-start. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-error → lr-error. | | `` | `` | `rewritten` | Automatic: tag/import plus insert appearance=accent; insert variant=brand. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Typed `` subclasses with tag-specific defaults and the full writable `LyraChartType` vocabulary — same optional peer deps as ``. | | `` | `` | `warning-required` | Manual: lr-breadcrumb's `label` accepts an accessible-name override; it is now optional with no declared default (was `string = ''`) so an explicit empty string can suppress the localized fallback without a never-set value doing the same. The rename carries no attribute/property name change, only this default-value divergence. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Responsive navigation trail. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Typed `` subclasses with tag-specific defaults and the full writable `LyraChartType` vocabulary — same optional peer deps as ``. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-invalid → lr-invalid. Equivalent surface representation: name defaults null ≡ ; no source rewrite. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Responsive semantic grouping for related action controls. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Dismissible inline status, warning, and error message surface. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Generic bordered content container (`header`/`media`/`footer`/`actions` slots) — a direct `` counterpart to `wa-card`. | | `` | `` | `warning-required` | Manual: Lyra accepts arbitrary HTMLElement slides, so its slide-change detail is wider than the upstream carousel-item class; in v9 the slides member is a read-only live composition count rather than a writable reflected attribute. Migrated handlers that rely on item-specific members or write slides require review. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Optional semantic slide wrapper for carousel content. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Core Chart.js wrapper (`LyraChartSeries`-based, plus raw `config` passthrough) with bounded `appendData()` streaming and `exportData('csv'. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-invalid → lr-invalid. Equivalent surface representation: name defaults null ≡ ; no source rewrite. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Form-associated group of checkboxes with array values and group validation. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-after-hide → lr-after-hide; events: wa-after-show → lr-after-show; events: wa-hide → lr-hide; events: wa-invalid → lr-invalid; events: wa-show → lr-show. Equivalent surface representation: name defaults null ≡ ; no source rewrite. | | `` | `` | `warning-required` | Manual: Lyra snapshots each input/change event's value into a frozen readonly value at dispatch time, and since 16.0.0 narrows it through the picker value generic, so the detail reads as string when multiple is false rather than the upstream union; migrated handlers that mutate the event detail in place, or that rely on the union being present on a single-select combobox, must be reviewed. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Before/after slotted surfaces with a keyboard-accessible range divider. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-copy → lr-copy; events: wa-error → lr-error. | | `` | `` | `warning-required` | Manual: Lyra snapshots collection inputs and event details synchronously into frozen readonly values, and removes the redundant wa-data-request alias in favor of the typed request event. Migrated code that mutates arrays or event details in place, assigns derived collections, or listens for the removed alias must be reviewed. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-after-hide → lr-after-hide; events: wa-after-show → lr-after-show; events: wa-clear → lr-clear; events: wa-hide → lr-hide; events: wa-invalid → lr-invalid; events: wa-show → lr-show. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-focus-day → lr-focus-day; events: wa-view-change → lr-view-change. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-after-hide → lr-after-hide; events: wa-after-show → lr-after-show; events: wa-hide → lr-hide; events: wa-show → lr-show. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-after-hide → lr-after-hide; events: wa-after-show → lr-after-show; events: wa-hide → lr-hide; events: wa-show → lr-show. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Horizontal or vertical semantic separator. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Typed `` subclasses with tag-specific defaults and the full writable `LyraChartType` vocabulary — same optional peer deps as ``. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-after-hide → lr-after-hide; events: wa-after-show → lr-after-show; events: wa-hide → lr-hide; events: wa-show → lr-show. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-after-hide → lr-after-hide; events: wa-after-show → lr-after-show; events: wa-hide → lr-hide; events: wa-select → lr-select; events: wa-show → lr-show. | | `` | `` | `rewritten` | Automatic: tag/import plus attributes: submenuOpen → submenu-open. | | `` | `` | `warning-required` | Manual: Lyra exposes dragging and fileCount as getter-only derived state. Migrated code that assigned either upstream field must instead drive them through drag interaction or the selected-files input contract. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-error → lr-error; events: wa-load → lr-load. | | `` | `` | `warning-required` | Manual: Lyra intentionally sanitizes included markup and keeps a same-origin default; uses that depend on cross-origin or script-executing behavior require an explicit security warning rather than a silent rename. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-clear → lr-clear; events: wa-invalid → lr-invalid. Equivalent surface representation: name defaults null ≡ ; no source rewrite. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-intersect → lr-intersect. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-invalid → lr-invalid. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Typed `` subclasses with tag-specific defaults and the full writable `LyraChartType` vocabulary — same optional peer deps as ``. | | `` | `` | `warning-required` | Manual: The source and target light-DOM Markdown content models and optional-peer runtime requirements are not mechanically equivalent; migration leaves the use unchanged and reports the required review. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-mutation → lr-mutation. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-invalid → lr-invalid. Equivalent surface representation: name defaults null ≡ ; no source rewrite. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Filterable single/multi select, form-associated; options separate live `selected` from attribute-backed/reset `defaultSelected`; `xs`–`xl` sizing; async rich rows and retained selection payloads via `source`/`selectedRows`; virtual scrolling with `max-render`. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-clear → lr-clear; events: wa-complete → lr-complete; events: wa-invalid → lr-invalid. Equivalent surface representation: name defaults null ≡ ; no source rewrite. | | `` | `` | `warning-required` | Manual: Lyra returns a finite 0 for null and for an element in a detached document with no viewport; Web Awesome 3.11 returns null for null and measures detached-document geometry against the ambient page viewport. | | `` | `` | `warning-required` | Manual: The page-change events are covered by deterministic member rewrites. `label` is now optional with no declared default (was `string = ''`) so an explicit empty string can suppress the localized fallback without a never-set value doing the same -- a default-value divergence with no rewrite rule to express it, so migrating consumers get a warning instead of a silent rename. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Typed `` subclasses with tag-specific defaults and the full writable `LyraChartType` vocabulary — same optional peer deps as ``. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Typed `` subclasses with tag-specific defaults and the full writable `LyraChartType` vocabulary — same optional peer deps as ``. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-after-hide → lr-after-hide; events: wa-after-show → lr-after-show; events: wa-hide → lr-hide; events: wa-show → lr-show. Equivalent surface representation: for defaults null ≡ ; no source rewrite. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-reposition → lr-reposition. Equivalent surface representation: autoSizeBoundary is analyzer-inferred for property-only autoSizeBoundary; flipBoundary is analyzer-inferred for property-only flipBoundary; shiftBoundary is analyzer-inferred for property-only shiftBoundary; no source rewrite. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Determinate or indeterminate progress indicators. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Determinate or indeterminate progress indicators. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Canvas QR renderer; needs the optional peer `qrcode`. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Typed `` subclasses with tag-specific defaults and the full writable `LyraChartType` vocabulary — same optional peer deps as ``. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Equivalent surface representation: name defaults null ≡ ; no source rewrite. Form-associated single-choice controls with roving arrow-key navigation and group validation; Lyra's group `name` defaults empty while Shoelace defaults to `option`, so the codemod inserts `name="option"` (set it for a manual rename). | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-invalid → lr-invalid. Equivalent surface representation: name defaults null ≡ ; no source rewrite. | | `` | `` | `warning-required` | Manual: Lyra returns frozen readonly selection snapshots instead of mutable arrays. The migrator also reports the exercised behavior differences: host and multi-item layout, bounded unique selection, forwarded-slot candidates, and autoplay semantics. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-hover → lr-hover; events: wa-invalid → lr-invalid. Equivalent surface representation: name defaults null ≡ ; getSymbol is analyzer-inferred for property-only getSymbol; no source rewrite. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Locale-aware formatting primitives. | | `` | `` | `warning-required` | Manual: Lyra freezes the entries array into an immutable snapshot at dispatch time; migrated code that mutates the array in place must create its own copy. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Typed `` subclasses with tag-specific defaults and the full writable `LyraChartType` vocabulary — same optional peer deps as ``. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Responsive overflow surface with optional navigation controls. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-after-hide → lr-after-hide; events: wa-after-show → lr-after-show; events: wa-clear → lr-clear; events: wa-hide → lr-hide; events: wa-invalid → lr-invalid; events: wa-show → lr-show. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Loading placeholder (pulse/sheen). | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-invalid → lr-invalid. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Zero-dependency inline SVG. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Localized indeterminate busy indicator with reduced-motion support. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-reposition → lr-reposition. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-invalid → lr-invalid. Equivalent surface representation: name defaults null ≡ ; no source rewrite. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Tab strip with `placement` (logical `start`/`end` turn it vertical) and `activation="auto"`/`"manual"`; composed from the upstream ``/`` child pairs. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-tab-hide → lr-tab-hide; events: wa-tab-show → lr-tab-show. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Tab strip with `placement` (logical `start`/`end` turn it vertical) and `activation="auto"`/`"manual"`; composed from the upstream ``/`` child pairs. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-remove → lr-remove. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-invalid → lr-invalid. Equivalent surface representation: name defaults null ≡ ; no source rewrite. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-after-hide → lr-after-hide; events: wa-after-show → lr-after-show; events: wa-clear → lr-clear; events: wa-hide → lr-hide; events: wa-invalid → lr-invalid; events: wa-show → lr-show. | | `` | `` | `warning-required` | Manual: Lyra's create() overloads reference the Lyra*-prefixed LyraToastOptions/LyraToastCreateOptions type names (renamed from the unprefixed spellings in 9.0.0) instead of the upstream's own ToastCreateOptions text; the method's actual parameter count, order, and runtime shape are unchanged, only the printed TypeScript type names differ. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-after-hide → lr-after-hide; events: wa-after-show → lr-after-show; events: wa-hide → lr-hide; events: wa-show → lr-show. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-after-hide → lr-after-hide; events: wa-after-show → lr-after-show; events: wa-hide → lr-hide; events: wa-show → lr-show. Equivalent surface representation: for defaults null ≡ ; no source rewrite. | | `` | `` | `warning-required` | Manual: Lyra freezes each selection snapshot and exposes it as readonly so listeners cannot mutate component-owned selection state. Migrated handlers that modify the event array in place must create their own copy. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-after-collapse → lr-after-collapse; events: wa-after-expand → lr-after-expand; events: wa-collapse → lr-collapse; events: wa-expand → lr-expand; events: wa-lazy-change → lr-lazy-change; events: wa-lazy-load → lr-lazy-load. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Lyra adds load(), validates media and thumbnail URLs, preserves consumer source/track nodes, caps thumbnail VTT input, and rejects unsupported fullscreen requests. These fail-closed additions do not change the documented safe-use contract. | | `` | `` | `rewritten` | Automatic: tag/import plus events: wa-video-change → lr-video-change. | | `` | `` | `warning-required` | Manual: Lyra always renders a sandbox with an `allow-same-origin` default, rejects active and non-embeddable URL schemes, and drops `allow-same-origin` when paired with `allow-scripts`; migration leaves the use unchanged and reports the security-sensitive difference. | ## Shoelace (58) Shoelace relationships are classified independently; a same-suffix tag is never treated as proof of compatibility. | From | Lyra target or candidate | Classification | Disposition | |---|---|---|---| | `` | `` | `warning-required` | Manual: Pinned runtime evidence shows Shoelace emits non-cancelable state-change lifecycle notifications while Lyra provides synchronous pre-state veto events; automatic migration therefore requires review of listener timing and preventDefault() behavior. | | `` | `` | `rewritten` | Automatic: tag/import plus events: sl-error → lr-error; events: sl-load → lr-load. | | `` | `` | `rewritten` | Automatic: tag/import plus events: sl-cancel → lr-cancel; events: sl-finish → lr-finish; events: sl-start → lr-start. | | `` | `` | `rewritten` | Automatic: tag/import plus events: sl-error → lr-error. | | `` | `` | `rewritten` | Automatic: tag/import plus insert variant=primary. | | `` | `` | `warning-required` | Manual: lr-breadcrumb's `label` accepts an accessible-name override; it is now optional with no declared default (was `string = ''`) so an explicit empty string can suppress the localized fallback without a never-set value doing the same. The rename carries no attribute/property name change, only this default-value divergence. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Responsive navigation trail. | | `` | `` | `rewritten` | Automatic: tag/import plus events: sl-blur → blur; events: sl-focus → focus; events: sl-invalid → lr-invalid. Equivalent surface representation: href defaults ≡ undefined; size defaults medium ≡ m; variant defaults default ≡ neutral; no source rewrite. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Responsive semantic grouping for related action controls. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Review appearance tokens and dismiss events. | | `` | `` | `warning-required` | Manual: Lyra accepts arbitrary HTMLElement slides, so its slide-change detail is wider than the upstream carousel-item class; migrated handlers that rely on item-specific members require review. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Optional semantic slide wrapper for carousel content. | | `` | `` | `warning-required` | Manual: Lyra uses the checked attribute as the reset default while Shoelace reflects the live checked state; migration leaves the use unchanged and reports the reflection-sensitive CSS, observer, serialization, and property-write difference. | | `` | `` | `rewritten` | Automatic: tag/import plus events: sl-blur → blur; events: sl-change → lr-change; events: sl-focus → focus; events: sl-input → lr-input; events: sl-invalid → lr-invalid. Equivalent surface representation: form defaults ≡ null; size defaults medium ≡ m; no source rewrite. | | `` | `` | `rewritten` | Automatic: tag/import plus events: sl-copy → lr-copy; events: sl-error → lr-error. | | `` | `` | `rewritten` | Automatic: tag/import plus events: sl-after-hide → lr-after-hide; events: sl-after-show → lr-after-show; events: sl-hide → lr-hide; events: sl-show → lr-show. | | `` | `` | `warning-required` | Manual: Pinned runtime evidence shows Shoelace emits non-cancelable state-change lifecycle notifications while Lyra provides synchronous pre-state veto events; automatic migration therefore requires review of listener timing and preventDefault() behavior. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Horizontal or vertical semantic separator. | | `` | `` | `warning-required` | Manual: Pinned runtime evidence shows Shoelace emits non-cancelable state-change lifecycle notifications while Lyra provides synchronous pre-state veto events; automatic migration therefore requires review of listener timing and preventDefault() behavior. | | `` | `` | `warning-required` | Manual: Pinned runtime evidence shows Shoelace emits non-cancelable state-change lifecycle notifications while Lyra provides synchronous pre-state veto events; automatic migration therefore requires review of listener timing and preventDefault() behavior. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. | | `` | `` | `rewritten` | Automatic: tag/import plus events: sl-error → lr-error; events: sl-load → lr-load. | | `` | `` | `rewritten` | Automatic: tag/import plus events: sl-blur → blur; events: sl-focus → focus. | | `` | `` | `rewritten` | Automatic: tag/import plus events: sl-change → change. | | `` | `` | `warning-required` | Manual: Lyra intentionally sanitizes included markup and keeps a same-origin default; uses that depend on cross-origin or script-executing behavior require an explicit security warning rather than a silent rename. | | `` | `` | `rewritten` | Automatic: tag/import plus events: sl-blur → blur; events: sl-change → lr-change; events: sl-clear → lr-clear; events: sl-focus → focus; events: sl-input → lr-input; events: sl-invalid → lr-invalid. Equivalent surface representation: form defaults ≡ null; size defaults medium ≡ m; no source rewrite. | | `` | `` | `rewritten` | Automatic: tag/import plus events: sl-select → lr-select. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Focusable action row owned by ``, including checkbox items, nested submenus, and the canonical parent `lr-select` event. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Non-interactive section heading inside ``; `role="presentation"`, never a focus stop. | | `` | `` | `rewritten` | Automatic: tag/import plus events: sl-mutation → lr-mutation. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. `defaultSelected`/the `selected` attribute is the reset default; live `selected` is property-only. Review option and value events. | | `` | `` | `rewritten` | Automatic: tag/import plus events: sl-reposition → lr-reposition. Equivalent surface representation: autoSizeBoundary is analyzer-inferred for property-only autoSizeBoundary; flipBoundary is analyzer-inferred for property-only flipBoundary; shiftBoundary is analyzer-inferred for property-only shiftBoundary; no source rewrite. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Built-in status copy is localized through Lyra's runtime. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Determinate or indeterminate progress indicators. | | `` | `` | `rewritten` | Automatic: tag/import plus insert background=white; insert fill=black. | | `` | `` | `rewritten` | Automatic: tag/import plus events: sl-blur → blur; events: sl-focus → focus. Equivalent surface representation: size defaults medium ≡ m; no source rewrite. | | `` | `` | `rewritten` | Automatic: tag/import plus events: sl-blur → blur; events: sl-focus → focus. Equivalent surface representation: size defaults medium ≡ m; no source rewrite. | | `` | `` | `rewritten` | Automatic: tag/import plus events: sl-change → lr-change; events: sl-input → lr-input; events: sl-invalid → lr-invalid; insert name=option. Equivalent surface representation: form defaults ≡ null; size defaults medium ≡ m; no source rewrite. | | `` | `` | `rewritten` | Automatic: tag/import plus events: sl-blur → blur; events: sl-change → lr-change; events: sl-focus → focus; events: sl-input → lr-input; events: sl-invalid → lr-invalid; insert tooltip=top. Equivalent surface representation: form defaults ≡ null; name defaults ≡ null; no source rewrite. | | `` | `` | `rewritten` | Automatic: tag/import plus events: sl-change → lr-change; events: sl-hover → lr-hover. Equivalent surface representation: getSymbol is analyzer-inferred for property-only getSymbol; no source rewrite. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Locale-aware formatting primitives. | | `` | `` | `warning-required` | Manual: Lyra freezes the entries array into an immutable snapshot at dispatch time; migrated code that mutates the array in place must create its own copy. | | `` | `` | `rewritten` | Automatic: tag/import plus events: sl-after-hide → lr-after-hide; events: sl-after-show → lr-after-show; events: sl-blur → blur; events: sl-change → lr-change; events: sl-clear → lr-clear; events: sl-focus → focus; events: sl-hide → lr-hide; events: sl-input → lr-input; events: sl-invalid → lr-invalid; events: sl-show → lr-show. Equivalent surface representation: form defaults ≡ null; size defaults medium ≡ m; getTag is analyzer-inferred for property-only getTag; no source rewrite. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Loading placeholder (pulse/sheen). | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Built-in status copy is localized through Lyra's runtime. | | `` | `` | `warning-required` | Manual: The published Shoelace manifest exports SNAP_NONE without documenting its callable signature; Lyra exports the same helper with an explicit typed parameter, so the tag rewrite remains available but consumers that call the helper require review. Lyra also renamed its own SnapFunction export to LyraSplitPanelSnapFunction (a Lyra-original type, not part of the Shoelace public surface) as part of the 9.0.0 Lyra*-prefix harmonization. | | `` | `` | `rewritten` | Automatic: tag/import plus events: sl-blur → blur; events: sl-change → lr-change; events: sl-focus → focus; events: sl-input → lr-input; events: sl-invalid → lr-invalid. Equivalent surface representation: form defaults ≡ null; size defaults medium ≡ m; no source rewrite. | | `` | `` | `rewritten` | Automatic: tag/import plus events: sl-close → lr-close. | | `` | `` | `rewritten` | Automatic: tag/import plus events: sl-tab-hide → lr-tab-hide; events: sl-tab-show → lr-tab-show. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Tab strip with `placement` (logical `start`/`end` turn it vertical) and `activation="auto"`/`"manual"`; composed from the upstream ``/`` child pairs. | | `` | `` | `rewritten` | Automatic: tag/import plus events: sl-remove → lr-remove. Equivalent surface representation: size defaults medium ≡ m; no source rewrite. | | `` | `` | `rewritten` | Automatic: tag/import plus events: sl-blur → blur; events: sl-change → lr-change; events: sl-focus → focus; events: sl-input → lr-input; events: sl-invalid → lr-invalid. Equivalent surface representation: form defaults ≡ null; size defaults medium ≡ m; no source rewrite. | | `` | `` | `warning-required` | Manual: Pinned runtime evidence shows Shoelace emits non-cancelable state-change lifecycle notifications while Lyra provides synchronous pre-state veto events; automatic migration therefore requires review of listener timing and preventDefault() behavior. | | `` | `` | `warning-required` | Manual: Lyra freezes each selection snapshot and exposes it as readonly so listeners cannot mutate component-owned selection state. Migrated handlers that modify the event array in place must create their own copy. | | `` | `` | `rewritten` | Automatic: tag/import plus events: sl-after-collapse → lr-after-collapse; events: sl-after-expand → lr-after-expand; events: sl-collapse → lr-collapse; events: sl-expand → lr-expand; events: sl-lazy-change → lr-lazy-change; events: sl-lazy-load → lr-lazy-load. | | `` | `` | `exact` | Automatic: tag and supported side-effect registration import. Hides content from sight while leaving it in the accessibility tree; reveals itself while focus is inside, which is what makes it usable for skip links. |