@happyvertical/smrt-svelte 0.55.7 → 0.55.8

package/dist/components/command-palette/rank.d.ts

@@ -0,0 +1,20 @@
+import type { PaletteItem, PaletteProvider, PaletteResult, PaletteSection } from './types.js';
+/** Default rows per group. */
+export declare const DEFAULT_MAX_PER_GROUP = 8;
+export interface RankInput {
+    /** In registration order. */
+    providers: readonly PaletteProvider[];
+    /** `items()` output by provider id. */
+    local: Readonly<Record<string, readonly PaletteItem[]>>;
+    /** `search()` output by provider id (for the current or previous query). */
+    remote: Readonly<Record<string, readonly PaletteItem[]>>;
+    query: string;
+    maxPerGroup?: number;
+}
+/** Providers by `order`, then registration order. */
+export declare function orderProviders(providers: readonly PaletteProvider[]): PaletteProvider[];
+/** Group, match and rank. A group with no rows is omitted. */
+export declare function buildPaletteSections(input: RankInput): PaletteSection[];
+/** The rows of `sections` in display order. */
+export declare function flattenSections(sections: readonly PaletteSection[]): PaletteResult[];
+//# sourceMappingURL=rank.d.ts.map

package/dist/components/command-palette/rank.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rank.d.ts","sourceRoot":"","sources":["../../../src/components/command-palette/rank.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAEV,WAAW,EACX,eAAe,EACf,aAAa,EACb,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,8BAA8B;AAC9B,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,MAAM,WAAW,SAAS;IACxB,6BAA6B;IAC7B,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;IACtC,uCAAuC;IACvC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC,CAAC,CAAC;IACxD,4EAA4E;IAC5E,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC,CAAC,CAAC;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAmBD,qDAAqD;AACrD,wBAAgB,cAAc,CAC5B,SAAS,EAAE,SAAS,eAAe,EAAE,GACpC,eAAe,EAAE,CAQnB;AAED,8DAA8D;AAC9D,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,GAAG,cAAc,EAAE,CA4DvE;AAED,+CAA+C;AAC/C,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,SAAS,cAAc,EAAE,GAClC,aAAa,EAAE,CAEjB"}

package/dist/components/command-palette/rank.js

@@ -0,0 +1,74 @@
+/**
+ * Turns provider output into the grouped, ranked rows the palette renders.
+ * Pure: the controller feeds it the current local items, remote results and
+ * query. No DOM, no Svelte.
+ */
+import { matchItem, matchText } from './match.js';
+/** Default rows per group. */
+export const DEFAULT_MAX_PER_GROUP = 8;
+function resultFor(provider, item, score, titleRanges) {
+    return {
+        key: `${provider.id}:${item.id}`,
+        providerId: provider.id,
+        group: item.group ?? provider.label,
+        item,
+        score,
+        titleRanges,
+        selectable: !item.disabled,
+    };
+}
+/** Providers by `order`, then registration order. */
+export function orderProviders(providers) {
+    return providers
+        .map((provider, index) => ({ provider, index }))
+        .sort((a, b) => (a.provider.order ?? 0) - (b.provider.order ?? 0) || a.index - b.index)
+        .map(({ provider }) => provider);
+}
+/** Group, match and rank. A group with no rows is omitted. */
+export function buildPaletteSections(input) {
+    const query = input.query.trim();
+    const maxPerGroup = input.maxPerGroup ?? DEFAULT_MAX_PER_GROUP;
+    const sections = [];
+    const sectionFor = (label) => {
+        let section = sections.find((candidate) => candidate.id === label);
+        if (!section) {
+            section = { id: label, label, results: [] };
+            sections.push(section);
+        }
+        return section;
+    };
+    const seen = new Set();
+    for (const provider of orderProviders(input.providers)) {
+        const limit = provider.limit ?? maxPerGroup;
+        const matched = [];
+        for (const item of input.local[provider.id] ?? []) {
+            const match = matchItem(query, item);
+            if (!match)
+                continue;
+            matched.push(resultFor(provider, item, match.score + (item.boost ?? 0), match.titleRanges));
+        }
+        // Stable: equal scores keep the provider's own order.
+        matched.sort((a, b) => b.score - a.score);
+        const searched = [];
+        if (query.length > 0) {
+            for (const item of input.remote[provider.id] ?? []) {
+                searched.push(resultFor(provider, item, item.boost ?? 0, matchText(query, item.title)?.ranges ?? []));
+            }
+        }
+        let taken = 0;
+        for (const result of [...matched, ...searched]) {
+            if (taken >= limit)
+                break;
+            if (seen.has(result.key))
+                continue;
+            seen.add(result.key);
+            sectionFor(result.group).results.push(result);
+            taken += 1;
+        }
+    }
+    return sections.filter((section) => section.results.length > 0);
+}
+/** The rows of `sections` in display order. */
+export function flattenSections(sections) {
+    return sections.flatMap((section) => [...section.results]);
+}

package/dist/components/command-palette/types.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Command palette contracts (#3713).
+ *
+ * The palette is a thin shell over a *provider* contract: anything that wants
+ * to appear in "find anything" registers a {@link PaletteProvider}. The shell
+ * ships two (see `providers.ts`): navigation from the shell nav model, and a
+ * model-driven pair derived from the SMRT manifest. Packages and recipes add
+ * their own through the same contract.
+ */
+/** What an item does when chosen, for grouping hints and screen readers. */
+export type PaletteItemKind = 'command' | 'navigation' | 'create' | 'record' | (string & {});
+/** Passed to {@link PaletteItem.run}. */
+export interface PaletteRunContext {
+    /** The text typed when the item was chosen. */
+    query: string;
+    /** The provider that owns the item. */
+    providerId: string;
+    /** Navigate with the palette's `navigate` seam (same as an `href` item). */
+    navigate: (href: string) => void | Promise<void>;
+}
+/** One selectable row. */
+export interface PaletteItem {
+    /** Stable id, unique within its provider. */
+    id: string;
+    /** Primary text; matched against the query and highlighted. */
+    title: string;
+    /** Secondary line, e.g. the model an item belongs to. Matched at lower weight. */
+    subtitle?: string;
+    /** Extra match terms that are not shown ("invoice" for "Billing"). */
+    keywords?: readonly string[];
+    /** Overrides the provider's group heading for this item. */
+    group?: string;
+    /** A shell icon name (`SHELL_ICON_PATHS`); unknown names draw no icon. */
+    icon?: string;
+    /** Free-form tag, exposed as `data-kind` and read by assistants. */
+    kind?: PaletteItemKind;
+    /** Navigates here when chosen and no `run` is set. */
+    href?: string;
+    /** Runs when chosen. Takes precedence over `href`. */
+    run?: (context: PaletteRunContext) => void | Promise<void>;
+    /** A hotkey hint shown at the end of the row (display only), e.g. `Mod+N`. */
+    shortcut?: string;
+    /**
+     * Shown but not selectable. A string is the reason, announced and shown as
+     * the row tooltip.
+     */
+    disabled?: boolean | string;
+    /** Static ranking bias added to the match score (default 0). */
+    boost?: number;
+}
+/** Passed to {@link PaletteProvider.items}. */
+export interface PaletteItemsContext {
+    /** Aborted when the palette closes before the items arrive. */
+    signal: AbortSignal;
+}
+/** Passed to {@link PaletteProvider.search}. */
+export interface PaletteSearchContext {
+    /** Aborted when the query changes or the palette closes. */
+    signal: AbortSignal;
+    /** The most rows the palette will show for this provider. */
+    limit: number;
+}
+/**
+ * A source of palette rows. A provider offers either or both of:
+ *
+ * - `items` - a set the palette matches locally (commands, navigation). Read
+ *   every time the palette opens, so it can follow app state.
+ * - `search` - results for a typed query, fetched by the provider (records).
+ *   Called after a short debounce, with a signal that aborts on the next
+ *   keystroke. Results are shown as returned; the palette does not re-filter.
+ *
+ * Authorization stays with the provider: return only what the user may see.
+ * The palette is not a security boundary.
+ */
+export interface PaletteProvider {
+    /** Stable id; registering the same id again replaces the earlier provider. */
+    id: string;
+    /** Group heading for this provider's rows. */
+    label: string;
+    /** Lower sorts first (default 0); ties keep registration order. */
+    order?: number;
+    items?(context: PaletteItemsContext): readonly PaletteItem[] | Promise<readonly PaletteItem[]>;
+    search?(query: string, context: PaletteSearchContext): readonly PaletteItem[] | Promise<readonly PaletteItem[]>;
+    /** Shortest trimmed query `search` is called with (default 2). */
+    minQueryLength?: number;
+    /** Rows shown for this provider (default: the palette's `maxPerGroup`). */
+    limit?: number;
+}
+/** A character range `[start, end)` in a string. */
+export type MatchRange = readonly [start: number, end: number];
+/** A row the palette renders. */
+export interface PaletteResult {
+    /** `${providerId}:${item.id}`; unique in the palette. */
+    key: string;
+    providerId: string;
+    /** Group heading the row sits under. */
+    group: string;
+    item: PaletteItem;
+    /** Match score; higher is better. 0 for rows that were not text-matched. */
+    score: number;
+    /** Ranges of `item.title` that matched the query. */
+    titleRanges: readonly MatchRange[];
+    /** Whether the row can be chosen. */
+    selectable: boolean;
+}
+/** A heading and its rows. */
+export interface PaletteSection {
+    /** Stable: the group heading. */
+    id: string;
+    label: string;
+    results: readonly PaletteResult[];
+}
+/** Where an error came from. */
+export interface PaletteErrorContext {
+    providerId: string;
+    phase: 'items' | 'search' | 'run';
+    item?: PaletteItem;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/components/command-palette/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/command-palette/types.ts"],"names":[],"mappings":"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"}

package/dist/components/command-palette/types.js

@@ -0,0 +1,10 @@
+/**
+ * Command palette contracts (#3713).
+ *
+ * The palette is a thin shell over a *provider* contract: anything that wants
+ * to appear in "find anything" registers a {@link PaletteProvider}. The shell
+ * ships two (see `providers.ts`): navigation from the shell nav model, and a
+ * model-driven pair derived from the SMRT manifest. Packages and recipes add
+ * their own through the same contract.
+ */
+export {};

package/dist/components/command-palette/use-provider.svelte.d.ts

@@ -0,0 +1,14 @@
+import type { CommandPaletteController } from './controller.svelte.js';
+import type { PaletteProvider } from './types.js';
+/**
+ * Register a palette provider for the calling component's lifetime. Pass a
+ * getter to follow reactive state: the provider re-registers (replacing the
+ * earlier one, same `id`) whenever what it reads changes. A silent no-op when
+ * there is no palette on context, so a recipe's component works with or
+ * without one. Call during component initialization.
+ *
+ * @param source The provider, or a function returning it (or null for none).
+ * @param controller Override the palette from context.
+ */
+export declare function useCommandPaletteProvider(source: PaletteProvider | (() => PaletteProvider | null), controller?: CommandPaletteController | null): void;
+//# sourceMappingURL=use-provider.svelte.d.ts.map

package/dist/components/command-palette/use-provider.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-provider.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/command-palette/use-provider.svelte.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,eAAe,GAAG,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,EACxD,UAAU,GAAE,wBAAwB,GAAG,IAA6B,GACnE,IAAI,CAQN"}

package/dist/components/command-palette/use-provider.svelte.js

@@ -0,0 +1,23 @@
+import { untrack } from 'svelte';
+import { tryUseCommandPalette } from './context.js';
+/**
+ * Register a palette provider for the calling component's lifetime. Pass a
+ * getter to follow reactive state: the provider re-registers (replacing the
+ * earlier one, same `id`) whenever what it reads changes. A silent no-op when
+ * there is no palette on context, so a recipe's component works with or
+ * without one. Call during component initialization.
+ *
+ * @param source The provider, or a function returning it (or null for none).
+ * @param controller Override the palette from context.
+ */
+export function useCommandPaletteProvider(source, controller = tryUseCommandPalette()) {
+    if (!controller)
+        return;
+    $effect(() => {
+        const provider = typeof source === 'function' ? source() : source;
+        if (!provider)
+            return;
+        // Registering reads and writes the registry; keep that out of this effect.
+        return untrack(() => controller.registerProvider(provider));
+    });
+}