@gjsify/adwaita-web 0.14.0 → 0.16.0

package/lib/types/adw-data-grid.spec.d.ts

@@ -0,0 +1 @@
+export declare const AdwDataGridTest: () => Promise<void>;

package/lib/types/adw-dialog.spec.d.ts

@@ -0,0 +1 @@
+export declare const AdwDialogTest: () => Promise<void>;

package/lib/types/adw-drop-down.spec.d.ts

@@ -0,0 +1 @@
+export declare const AdwDropDownTest: () => Promise<void>;

package/lib/types/elements/adw-data-grid.d.ts

@@ -0,0 +1,60 @@
+/** Horizontal alignment of a column's header + cells. */
+export type AdwDataGridAlign = 'start' | 'end' | 'center';
+/** Accounting row emphasis. `normal` is the default plain data row. */
+export type AdwDataGridRowVariant = 'normal' | 'section' | 'subtotal' | 'total';
+/** A column descriptor — what to read (`key`), how to label + align it. */
+export interface AdwDataGridColumn {
+    /** The row-object key this column renders. */
+    key: string;
+    /** Header text (defaults to `key`). */
+    label?: string;
+    /** 'start' | 'end' | 'center'. Defaults to 'start' (or 'end' when numeric). */
+    align?: AdwDataGridAlign;
+    /** Fixed CSS track size (e.g. '80px', '6rem') — pins the column width. */
+    width?: string;
+    /** Fractional track weight (→ `<flex>fr`) — lets the column grow. */
+    flex?: number;
+    /** Render cells in a monospace family (tabular figures apply regardless). */
+    monospace?: boolean;
+    /** Convenience: right-align + tabular-nums (numeric columns of figures). */
+    numeric?: boolean;
+}
+/** A row: cell values keyed by column key + optional accounting metadata. */
+export interface AdwDataGridRow {
+    /** Accounting emphasis. Default 'normal'. */
+    variant?: AdwDataGridRowVariant;
+    /** Make just this row clickable (overrides the element-level flag). */
+    interactive?: boolean;
+    /** Cell values keyed by column key (pre-formatted strings, or numbers). */
+    [key: string]: string | number | boolean | AdwDataGridRowVariant | undefined;
+}
+export declare class AdwDataGrid extends HTMLElement {
+    private _captionEl;
+    private _scrollEl;
+    private _tableEl;
+    private _columns;
+    private _rows;
+    private _initialized;
+    static get observedAttributes(): string[];
+    /** The column descriptors. Setting rebuilds the grid. */
+    get columns(): AdwDataGridColumn[];
+    set columns(value: ReadonlyArray<AdwDataGridColumn>);
+    /** The row objects. Setting rebuilds the body. */
+    get rows(): AdwDataGridRow[];
+    set rows(value: ReadonlyArray<AdwDataGridRow>);
+    /** The optional grid caption/title (reflected to the attribute). */
+    get caption(): string;
+    set caption(value: string);
+    /** Whether every `normal` row is clickable (element-level flag). */
+    get interactive(): boolean;
+    set interactive(value: boolean);
+    connectedCallback(): void;
+    attributeChangedCallback(name: string, _old: string | null, value: string | null): void;
+    private _parseJsonAttr;
+    private _renderCaption;
+    /** The CSS `grid-template-columns` value derived from the column descriptors. */
+    private _trackTemplate;
+    private _columnClasses;
+    private _render;
+    private _activate;
+}

package/lib/types/elements/adw-dialog.d.ts

@@ -0,0 +1,51 @@
+/** Adaptive presentation of the dialog — mirrors Adw.DialogPresentationMode. */
+export type AdwDialogPresentationMode = 'auto' | 'floating' | 'bottom-sheet';
+export declare class AdwDialog extends HTMLElement {
+    private _initialized;
+    private _scrimEl;
+    private _boxEl;
+    private _headerEl;
+    private _titleEl;
+    private _closeBtn;
+    private _contentEl;
+    private _previouslyFocused;
+    static get observedAttributes(): string[];
+    /** Whether the dialog is currently revealed. */
+    get open(): boolean;
+    set open(value: boolean);
+    /** The header title (Adw.Dialog:title). Setting a title renders the header. */
+    get title(): string;
+    set title(value: string);
+    /** Whether the user can dismiss the dialog (scrim / Escape / close button). */
+    get canClose(): boolean;
+    set canClose(value: boolean);
+    /** The dialog's preferred/max content width in px (Adw.Dialog:content-width). */
+    get contentWidth(): number;
+    set contentWidth(value: number);
+    /** The dialog's max content height in px, or 0 for "unconstrained" (Adw.Dialog:content-height). */
+    get contentHeight(): number;
+    set contentHeight(value: number);
+    /** The adaptive presentation mode (Adw.Dialog:presentation-mode). */
+    get presentationMode(): AdwDialogPresentationMode;
+    set presentationMode(value: AdwDialogPresentationMode);
+    /** The content container — arbitrary child markup lives here after connect. */
+    get contentArea(): HTMLDivElement;
+    /** Reveal the dialog (mirrors Adw.Dialog.present). Auto-attaches if disconnected. */
+    present(parent?: Element): void;
+    /** Dismiss the dialog, respecting `can-close` (mirrors Adw.Dialog.close). */
+    close(): void;
+    /** Dismiss the dialog regardless of `can-close` (mirrors Adw.Dialog.force_close). */
+    forceClose(): void;
+    connectedCallback(): void;
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    /** A dismissal was requested: honour `can-close`, else raise close-attempt. */
+    private _attemptClose;
+    /** Focus trap + Escape while the box has focus. */
+    private _onBoxKeyDown;
+    private _focusables;
+    /** On present: remember focus, then move it into the dialog. */
+    private _onPresented;
+    /** On close: emit `closed` and return focus to where it was before present. */
+    private _onClosed;
+    private _render;
+}

package/lib/types/elements/adw-drop-down.d.ts

@@ -0,0 +1,63 @@
+/** A dropdown option — `value` is the stable id, `label` the shown text. */
+export interface AdwDropDownOption {
+    value: string;
+    label: string;
+}
+type RawOption = string | {
+    value?: unknown;
+    label?: unknown;
+};
+export declare class AdwDropDown extends HTMLElement {
+    private _buttonEl;
+    private _labelEl;
+    private _popoverEl;
+    private _listEl;
+    private _searchEl;
+    private _options;
+    private _itemButtons;
+    private _selected;
+    private _active;
+    private _initialized;
+    private _typeAheadBuffer;
+    private _typeAheadTimer;
+    private _onDocumentPointerDown;
+    private _onDocumentKeyDown;
+    static get observedAttributes(): string[];
+    /** The options list. Setting it rebuilds the popover and clamps the selection. */
+    get options(): AdwDropDownOption[];
+    set options(value: ReadonlyArray<RawOption>);
+    /** Alias of `options` (Gtk.DropDown's model is often called "items"). */
+    get items(): AdwDropDownOption[];
+    set items(value: ReadonlyArray<RawOption>);
+    /** The selected index. Out-of-range values are ignored (Gtk.DropDown:selected). */
+    get selected(): number;
+    set selected(value: number);
+    /** The selected option's value, or '' when empty (Gtk.DropDown:selected-item). */
+    get selectedValue(): string;
+    set selectedValue(value: string);
+    /** The selected option descriptor, or null when empty. */
+    get selectedItem(): AdwDropDownOption | null;
+    /** Whether the search entry is shown in the popover. */
+    get enableSearch(): boolean;
+    set enableSearch(value: boolean);
+    /** Whether the popover is currently open. */
+    get active(): boolean;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string, _old: string | null, value: string | null): void;
+    private _parseOptionsAttr;
+    private _selectIndex;
+    private _setActive;
+    private _onButtonKeyDown;
+    private _onPopoverKeyDown;
+    /** Type-ahead: accumulate keys, focus/select the next matching option. */
+    private _typeAhead;
+    /** Filter the visible items by a search query (case-insensitive substring). */
+    private _filter;
+    private _visibleItems;
+    private _renderAll;
+    private _updateLabel;
+    private _updateSelectedStates;
+    private _renderPopover;
+}
+export {};

package/lib/types/elements/adw-menu-button.d.ts

@@ -0,0 +1,34 @@
+/** A menu entry. `id` defaults to `label` on activation; `icon` is optional. */
+export interface AdwMenuItem {
+    id?: string;
+    label: string;
+    icon?: string;
+}
+export declare class AdwMenuButton extends HTMLElement {
+    private _buttonEl;
+    private _popoverEl;
+    private _items;
+    private _menuTitle;
+    private _active;
+    private _initialized;
+    private _itemButtons;
+    private _onDocumentPointerDown;
+    private _onDocumentKeyDown;
+    static get observedAttributes(): string[];
+    /** Whether the popover menu is currently open. */
+    get active(): boolean;
+    /** The menu entries. Setting rebuilds the popover. */
+    get menuItems(): AdwMenuItem[];
+    set menuItems(value: AdwMenuItem[]);
+    /** The optional popover heading. */
+    get menuTitle(): string;
+    set menuTitle(value: string);
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string): void;
+    private _parseMenuAttr;
+    private _setActive;
+    private _onMenuKeyDown;
+    private _render;
+    private _renderMenu;
+}

package/lib/types/elements/adw-view-stack.d.ts

@@ -0,0 +1,37 @@
+/** A page descriptor exposed via `pages` (consumed by a bound switcher bar). */
+export interface AdwViewStackPageInfo {
+    /** Stable id used by visibleChildName + switcher binding. */
+    name: string;
+    /** Human-facing title shown by a bound switcher. */
+    title: string;
+    /** Symbolic icon name (no `-symbolic` suffix), or '' for none. */
+    icon: string;
+    /** The page's content container (the visibility-toggled node). */
+    element: HTMLElement;
+}
+export declare class AdwViewStack extends HTMLElement {
+    private _pages;
+    private _visibleIndex;
+    private _initialized;
+    static get observedAttributes(): string[];
+    /** All pages in declaration/add order. A bound switcher reads this. */
+    get pages(): readonly AdwViewStackPageInfo[];
+    /** Zero-based index of the visible page. Out-of-range/same values no-op. */
+    get visibleChildIndex(): number;
+    set visibleChildIndex(value: number);
+    /** Name of the visible page, or '' when the stack is empty. */
+    get visibleChildName(): string;
+    set visibleChildName(name: string);
+    /** The visible page's content element, or null when empty. */
+    get visibleChild(): HTMLElement | null;
+    connectedCallback(): void;
+    attributeChangedCallback(name: string, _old: string | null, value: string | null): void;
+    /**
+     * Append a page. The FIRST page added becomes visible automatically; later
+     * pages are added hidden. Mirrors Adw.ViewStack.add()/the NS twin's add().
+     */
+    add(content: HTMLElement, name: string, title?: string, icon?: string): AdwViewStackPageInfo;
+    /** Convenience alias mirroring Adw.ViewStack.add_titled() (no icon). */
+    addTitled(content: HTMLElement, name: string, title: string): AdwViewStackPageInfo;
+    private _apply;
+}

package/lib/types/elements/adw-view-switcher-bar.d.ts

@@ -0,0 +1,27 @@
+import type { AdwViewStack } from './adw-view-stack.js';
+export declare class AdwViewSwitcherBar extends HTMLElement {
+    private _barEl;
+    private _buttons;
+    private _stack;
+    private _revealed;
+    private _initialized;
+    private _onStackNotify;
+    static get observedAttributes(): string[];
+    /** The bound stack element, or null when unbound. */
+    get stack(): AdwViewStack | null;
+    set stack(value: AdwViewStack | string | null);
+    /** Whether the bar is revealed (shown). Hidden when false. */
+    get revealed(): boolean;
+    set revealed(value: boolean);
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string, _old: string | null, value: string | null): void;
+    /** Bind to a stack element (or null). Unbinds the previous one and rebuilds. */
+    setStack(stack: AdwViewStack | null): void;
+    /** Rebuild the buttons — call after adding pages to the bound stack. */
+    refresh(): void;
+    private _resolveStack;
+    private _rebuild;
+    private _syncActive;
+    private _applyRevealed;
+}

package/lib/types/index.d.ts

@@ -2,6 +2,8 @@ import '@gjsify/adwaita-fonts';
 export { AdwAvatar } from './elements/adw-avatar.js';
 export { AdwBanner } from './elements/adw-banner.js';
 export { AdwCard } from './elements/adw-card.js';
+export { AdwDataGrid } from './elements/adw-data-grid.js';
+export type { AdwDataGridAlign, AdwDataGridColumn, AdwDataGridRow, AdwDataGridRowVariant, } from './elements/adw-data-grid.js';
 export { AdwClamp } from './elements/adw-clamp.js';
 export { AdwSpinner } from './elements/adw-spinner.js';
 export { AdwStatusPage } from './elements/adw-status-page.js';
@@ -31,9 +33,18 @@ export { AdwCarousel, AdwCarouselIndicatorDots, AdwCarouselIndicatorLines } from
 export { AdwTabPage, AdwTabView } from './elements/adw-tab-view.js';
 export { AdwViewSwitcher, AdwViewSwitcherPage } from './elements/adw-view-switcher.js';
 export { AdwInlineViewSwitcher, AdwViewStackPage } from './elements/adw-inline-view-switcher.js';
+export { AdwViewStack } from './elements/adw-view-stack.js';
+export type { AdwViewStackPageInfo } from './elements/adw-view-stack.js';
+export { AdwViewSwitcherBar } from './elements/adw-view-switcher-bar.js';
+export { AdwMenuButton } from './elements/adw-menu-button.js';
+export type { AdwMenuItem } from './elements/adw-menu-button.js';
+export { AdwDropDown } from './elements/adw-drop-down.js';
+export type { AdwDropDownOption } from './elements/adw-drop-down.js';
 export { AdwNavigationPage, AdwNavigationView } from './elements/adw-navigation-view.js';
 export { AdwBottomSheet, AdwBottomSheetContent, AdwBottomSheetSheet } from './elements/adw-bottom-sheet.js';
 export { AdwSidebar, AdwSidebarItem, AdwSidebarSection } from './elements/adw-sidebar.js';
 export { AdwAboutDialog } from './elements/adw-about-dialog.js';
 export { AdwAlertDialog, AdwAlertResponse } from './elements/adw-alert-dialog.js';
 export { AdwPreferencesDialog, AdwPreferencesPage } from './elements/adw-preferences-dialog.js';
+export { AdwDialog } from './elements/adw-dialog.js';
+export type { AdwDialogPresentationMode } from './elements/adw-dialog.js';

package/lib/types/source-view/adw-source-view.d.ts

@@ -0,0 +1,75 @@
+import { EditorView } from '@codemirror/view';
+export declare class AdwSourceView extends HTMLElement {
+    private _view?;
+    private _editorHost;
+    private _copyButton;
+    private _initialized;
+    private _suppressChangeEvent;
+    private _code;
+    private _editable;
+    private _selectable;
+    private _lineNumbers;
+    private _lineNumberStart;
+    private _hexAddresses;
+    private _language;
+    private _copyable;
+    private _copyButtonIcon;
+    private _copyButtonTooltip;
+    private readonly _editableComp;
+    private readonly _lineNumbersComp;
+    private readonly _selectableComp;
+    private readonly _languageComp;
+    private readonly _copyComp;
+    static get observedAttributes(): string[];
+    /** The document text. Programmatic assignment does NOT emit `code-changed`. */
+    get code(): string;
+    set code(value: string);
+    /** Whether the user can edit the buffer (drives readOnly + active-line). */
+    get editable(): boolean;
+    set editable(value: boolean);
+    /** Inverse of `editable` — mirrors the native widget's readonly prop. */
+    get readonly(): boolean;
+    set readonly(value: boolean);
+    /** Whether the content is selectable by the user. */
+    get selectable(): boolean;
+    set selectable(value: boolean);
+    /** Whether the gutter is shown. */
+    get lineNumbers(): boolean;
+    set lineNumbers(value: boolean);
+    /** First gutter value: decimal offset, or the base ADDRESS in hex mode. */
+    get lineNumberStart(): number | undefined;
+    set lineNumberStart(value: number | undefined);
+    /** Render the gutter as 4-digit hex addresses (monitor / hexdump panes). */
+    get hexAddresses(): boolean;
+    set hexAddresses(value: boolean);
+    /** `6502` / `6502-assembler` enables highlighting; anything else = plain. */
+    get language(): string;
+    set language(value: string);
+    /** Whether the floating copy button is shown. */
+    get copyable(): boolean;
+    set copyable(value: boolean);
+    /** Icon name for the copy button (`edit-copy`/`copy` render an inline SVG). */
+    get copyButtonIcon(): string;
+    set copyButtonIcon(value: string);
+    /** Accessible label / tooltip for the copy button. */
+    get copyButtonTooltip(): string;
+    set copyButtonTooltip(value: string);
+    /** Whether the editor fills its host's height (vs. auto-sizing to content). */
+    get fillHeight(): boolean;
+    set fillHeight(value: boolean);
+    /** The live CodeMirror EditorView (null until connected). Escape hatch. */
+    get view(): EditorView | null;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string, _old: string | null, value: string | null): void;
+    private _baseExtensions;
+    private _editableExtension;
+    private _lineNumbersExtension;
+    private _selectableExtension;
+    private _languageExtension;
+    private _copyExtension;
+    private _reconfigure;
+    private _onCopyButtonClick;
+    private _renderCopyIcon;
+    private _readDeclarativeAttributes;
+}

package/lib/types/source-view/asm6502.d.ts

@@ -0,0 +1,28 @@
+import { type StreamParser, type StringStream } from '@codemirror/language';
+import { type Extension } from '@codemirror/state';
+import { type Tag } from '@lezer/highlight';
+/** The 56 official NMOS 6502 mnemonics (uppercased for case-insensitive match). */
+export declare const OPCODES: ReadonlySet<string>;
+/** The registers that appear as bare operands (`ASL A`, `LDA $00,X`). */
+export declare const REGISTERS: ReadonlySet<string>;
+/** Assembler pseudo-ops. `define`/`dcb` are the easy6502 dialect; the rest are
+ *  common cross-assembler directives (with the leading dot handled separately). */
+export declare const DIRECTIVE_WORDS: ReadonlySet<string>;
+/**
+ * Classify an identifier-shaped token. Pure + side-effect-free so it is unit
+ * testable without a CodeMirror stream. `atLineStart` decides whether an
+ * unknown word is a label DEFINITION (column 0) or a symbol REFERENCE.
+ */
+export declare function classifyWord(word: string, atLineStart: boolean): string;
+/**
+ * Tokenize one token from the stream. Exported for unit tests (feed it a
+ * `StringStream`). Returns a token-class name (see file header) or `null` for
+ * whitespace/unclassified punctuation.
+ */
+export declare function token6502(stream: StringStream): string | null;
+/** Maps this mode's token-class names to @lezer/highlight tags. */
+export declare const asm6502TokenTable: Record<string, Tag>;
+/** The StreamParser powering the 6502 mode. */
+export declare const asm6502Parser: StreamParser<unknown>;
+/** The 6502 assembly language extension for a CodeMirror EditorState. */
+export declare function asm6502(): Extension;

package/lib/types/source-view/hex.d.ts

@@ -0,0 +1,27 @@
+/** Bytes represented per visual line in the hex monitor / hexdump gutter. */
+export declare const HEX_ADDRESS_STRIDE = 16;
+/**
+ * Format a 1-based CodeMirror line number as a 4-digit uppercase hex address,
+ * the way the native GtkSourceView hex gutter renders monitor/hexdump rows:
+ * each row advances the address by `stride` bytes from `start`.
+ *
+ * @param lineNo 1-based line number (CodeMirror's `formatNumber` contract).
+ * @param start  base address of the first row (e.g. 0x0600 for a 6502 program).
+ * @param stride bytes per row (default 16 — one hexdump row).
+ */
+export declare function formatHexAddress(lineNo: number, start: number, stride?: number): string;
+/**
+ * Format a 1-based CodeMirror line number for the normal (decimal) gutter,
+ * offset by `start` so a pane can begin numbering at an arbitrary value —
+ * the web twin of the native renderer's `line + startValue`.
+ *
+ * @param lineNo 1-based line number.
+ * @param start  value shown on the first line (default 1 → identity).
+ */
+export declare function formatLineNumber(lineNo: number, start?: number): string;
+/**
+ * Strip every whitespace character from `text` — the copy-without-spaces
+ * transform the native hex monitor applies so a copied address/byte run pastes
+ * as a compact hex string. Mirrors `text.replace(/\s/g, '')` in the GTK widget.
+ */
+export declare function stripWhitespace(text: string): string;

package/lib/types/source-view/index.d.ts

@@ -0,0 +1,4 @@
+export { AdwSourceView } from './adw-source-view.js';
+export { asm6502, asm6502Parser, asm6502TokenTable, classifyWord, token6502, OPCODES, REGISTERS, DIRECTIVE_WORDS, } from './asm6502.js';
+export { adwaitaEditorTheme, adwaitaHighlightStyle, ensureSourceViewStyleInjected, SOURCE_VIEW_CSS, SOURCE_VIEW_STYLE_ID, } from './theme.js';
+export { formatHexAddress, formatLineNumber, stripWhitespace, HEX_ADDRESS_STRIDE } from './hex.js';

package/lib/types/source-view/theme.d.ts

@@ -0,0 +1,15 @@
+import { HighlightStyle } from '@codemirror/language';
+/** The CodeMirror EditorView theme mapping `.cm-*` chrome to Adwaita tokens. */
+export declare const adwaitaEditorTheme: import("@codemirror/state").Extension;
+/** Syntax highlighting mapping tags → the `--adw-src-*` palette variables. */
+export declare const adwaitaHighlightStyle: HighlightStyle;
+/** Element id of the injected stylesheet (idempotency guard). */
+export declare const SOURCE_VIEW_STYLE_ID = "adw-source-view-style";
+/** The chrome stylesheet: container, copy button, LTR pin, syntax palette. */
+export declare const SOURCE_VIEW_CSS = "\n.adw-source-view {\n    --adw-src-comment: #5e5c64;\n    --adw-src-keyword: #1c71d8;\n    --adw-src-number: #c64600;\n    --adw-src-string: #26a269;\n    --adw-src-label: #813d9c;\n    --adw-src-register: #007e8a;\n    --adw-src-directive: #a51d2d;\n    --adw-src-operator: rgba(0, 0, 6, 0.55);\n    --adw-src-selection: color-mix(in srgb, var(--accent-bg-color, #3584e4) 26%, transparent);\n    --adw-src-gutter-bg: var(--view-bg-color, #ffffff);\n    --adw-src-gutter-fg: rgba(0, 0, 6, 0.35);\n    --adw-src-active-line: color-mix(in srgb, var(--view-fg-color, #00000a) 4%, transparent);\n\n    /* Source code is inherently LTR \u2014 pin the whole widget so the gutter,\n       scrollbar and copy button never mirror under an RTL page. */\n    direction: ltr;\n    position: relative;\n    display: block;\n    box-sizing: border-box;\n    overflow: hidden;\n    border-radius: var(--card-radius, 12px);\n    background-color: var(--view-bg-color, #ffffff);\n    color: var(--view-fg-color, rgba(0, 0, 6, 0.8));\n}\n\n.adw-source-view .cm-editor {\n    border-radius: inherit;\n    max-height: 100%;\n}\n\n.adw-source-view.adw-source-view--fill,\n.adw-source-view.adw-source-view--fill .cm-editor {\n    height: 100%;\n}\n\n.adw-source-view .cm-editor.cm-focused {\n    outline: none;\n}\n\n.adw-source-view__copy {\n    position: absolute;\n    top: 6px;\n    right: 6px;\n    z-index: 2;\n    display: inline-flex;\n    align-items: center;\n    justify-content: center;\n    width: 30px;\n    height: 30px;\n    padding: 0;\n    border: none;\n    border-radius: var(--button-radius, 9px);\n    background-color: color-mix(in srgb, var(--view-bg-color, #ffffff) 82%, transparent);\n    color: var(--view-fg-color, rgba(0, 0, 6, 0.75));\n    opacity: 0.72;\n    cursor: pointer;\n    transition: opacity 0.15s ease, background-color 0.15s ease;\n    -webkit-backdrop-filter: blur(6px);\n    backdrop-filter: blur(6px);\n}\n\n.adw-source-view__copy:hover {\n    opacity: 1;\n    background-color: var(--button-hover-color, rgba(0, 0, 6, 0.13));\n}\n\n.adw-source-view__copy:active {\n    background-color: var(--button-active-color, rgba(0, 0, 6, 0.19));\n}\n\n.adw-source-view__copy:focus-visible {\n    opacity: 1;\n    outline: 2px solid var(--accent-color, #1c71d8);\n    outline-offset: 1px;\n}\n\n.adw-source-view__copy[hidden] {\n    display: none;\n}\n\n.adw-source-view__copy svg {\n    width: 16px;\n    height: 16px;\n    display: block;\n}\n\n.adw-source-view__copy .adw-icon {\n    width: 16px;\n    height: 16px;\n    background-color: currentColor;\n    -webkit-mask-repeat: no-repeat;\n    mask-repeat: no-repeat;\n    -webkit-mask-position: center;\n    mask-position: center;\n}\n\n@media (prefers-color-scheme: dark) {\n    :root:not(.theme-light) .adw-source-view {\n    --adw-src-comment: #9a9996;\n    --adw-src-keyword: #78aeed;\n    --adw-src-number: #ffa348;\n    --adw-src-string: #8ff0a4;\n    --adw-src-label: #dc8add;\n    --adw-src-register: #33d1c9;\n    --adw-src-directive: #f66151;\n    --adw-src-operator: rgba(255, 255, 255, 0.55);\n    --adw-src-gutter-fg: rgba(255, 255, 255, 0.35);\n    --adw-src-active-line: color-mix(in srgb, #ffffff 6%, transparent);\n    }\n}\n\n:root.theme-dark .adw-source-view {\n    --adw-src-comment: #9a9996;\n    --adw-src-keyword: #78aeed;\n    --adw-src-number: #ffa348;\n    --adw-src-string: #8ff0a4;\n    --adw-src-label: #dc8add;\n    --adw-src-register: #33d1c9;\n    --adw-src-directive: #f66151;\n    --adw-src-operator: rgba(255, 255, 255, 0.55);\n    --adw-src-gutter-fg: rgba(255, 255, 255, 0.35);\n    --adw-src-active-line: color-mix(in srgb, #ffffff 6%, transparent);\n}\n";
+/**
+ * Inject the chrome stylesheet once (browser-only, idempotent). Matches the
+ * self-injection pattern of `@gjsify/adwaita-web`'s main entry, so importing
+ * the source-view subpath is enough to style it under any bundler.
+ */
+export declare function ensureSourceViewStyleInjected(): void;