@getaster/elements 0.0.0-stage → 0.1.0-preview.1

package/dist/tile-grid/tile-grid.d.ts

@@ -0,0 +1,64 @@
+import { type Collection, type Entity, type KeyText, type Selection } from "@getaster/data";
+import { AsterElement, type View } from "../base/element.ts";
+import { type MenuItem } from "../menu/menu.ts";
+export interface TileState {
+    readonly key: KeyText;
+    /** Position in the collection, not in the subset of loaded tiles. */
+    readonly index: number;
+    readonly selected: boolean;
+    readonly focused: boolean;
+    readonly hidden: ReadonlySet<string>;
+    /** One-based pick order, only in ordered selection mode. */
+    readonly selectionOrder: number | undefined;
+}
+export interface TileContent {
+    readonly title: string;
+    readonly description?: string;
+    readonly image?: string;
+    readonly imageAlt?: string;
+    readonly icon?: View;
+}
+export type TileRenderer = (entity: Entity, state: TileState) => View;
+export type TilePresenter = (entity: Entity, state: TileState) => TileContent;
+export interface TileOpenDetail {
+    readonly key: KeyText;
+}
+/** A collection layout grid, with optional uniform-row windowing and paging. */
+export declare class TileGrid extends AsterElement {
+    #private;
+    get collection(): Collection | undefined;
+    set collection(v: Collection | undefined);
+    get selection(): Selection | undefined;
+    /** Allows this view to change selection; borrowed selection state remains visible. */
+    get selectable(): boolean;
+    set selectable(value: boolean);
+    set selection(v: Selection | undefined);
+    get label(): string;
+    set label(v: string);
+    get publish(): string;
+    set publish(v: string);
+    get presentTile(): TilePresenter | undefined;
+    set presentTile(v: TilePresenter | undefined);
+    get renderTile(): TileRenderer | undefined;
+    set renderTile(v: TileRenderer | undefined);
+    get actions(): ((entity: Entity, state: TileState) => readonly MenuItem[]) | undefined;
+    set actions(v: ((entity: Entity, state: TileState) => readonly MenuItem[]) | undefined);
+    get empty(): View;
+    set empty(v: View);
+    get layout(): "uniform" | "content";
+    set layout(v: "uniform" | "content");
+    /** Window uniform rows and load their pages. Content layout remains owner-loaded. */
+    get virtualized(): boolean;
+    set virtualized(v: boolean);
+    get activeKey(): KeyText | undefined;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    focus(options?: FocusOptions): void;
+    tileFor(key: KeyText | undefined): HTMLElement | undefined;
+    /** Reveals a loaded key, even when its tile is outside the current window. */
+    focusTile(key: KeyText): void;
+    /** Loads and focuses a logical position. Returns false on failure or stale navigation. */
+    focusIndex(index: number): Promise<boolean>;
+    protected render(): View;
+    protected updated(): void;
+}