@gjsify/adwaita-web 0.14.0 → 0.15.1

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

@@ -31,6 +31,11 @@ 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 { 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';

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;