@happyvertical/smrt-svelte 0.55.7 → 0.55.8

package/dist/components/overview/widgets/ShortcutsWidget.svelte

@@ -0,0 +1,80 @@
+<script lang="ts">
+/**
+ * Shortcuts widget (#3727): the section-overview cards as a widget. It draws
+ * the cards a loader produced (see `shortcutsFromNav`), with the same look as
+ * `ShellSectionMenu layout="cards"`, so a section's default overview is just
+ * this widget.
+ */
+import { useI18n } from '@happyvertical/smrt-ui/i18n';
+import { M } from '../../../i18n/strings.overview.js';
+import ShellSectionIcon from '../../workspace/admin-shell/ShellSectionIcon.svelte';
+import { SHELL_DEFAULT_SECTION_ICON } from '../../workspace/admin-shell/shell-icons.js';
+import { safeHref } from '../markdown.js';
+import type { WidgetComponentProps } from '../types.js';
+import { isRecord, type ShortcutsWidgetData } from './data.js';
+
+let { data, iconComponent }: WidgetComponentProps<ShortcutsWidgetData> =
+  $props();
+
+const { t } = useI18n();
+const MAX_ITEMS = 48;
+
+interface Card {
+  id: string;
+  label: string;
+  href: string;
+  icon: string;
+  description?: string;
+}
+
+const cards = $derived.by((): Card[] => {
+  if (!isRecord(data) || !Array.isArray(data.items)) return [];
+  const out: Card[] = [];
+  for (const item of data.items.slice(0, MAX_ITEMS)) {
+    if (!isRecord(item) || typeof item.label !== 'string') continue;
+    const href = typeof item.href === 'string' ? safeHref(item.href) : null;
+    if (!href) continue;
+    out.push({
+      id: typeof item.id === 'string' ? item.id : href,
+      label: item.label,
+      href,
+      icon:
+        typeof item.icon === 'string' ? item.icon : SHELL_DEFAULT_SECTION_ICON,
+      description:
+        typeof item.description === 'string' ? item.description : undefined,
+    });
+  }
+  return out;
+});
+</script>
+
+{#if cards.length === 0}
+  <p class="smrt-shortcuts__empty">{t(M['ui.overview.shortcuts.empty'])}</p>
+{:else}
+  <ul class="smrt-shortcuts">
+    {#each cards as card (card.id)}
+      <li class="smrt-shortcuts__card">
+        <a class="smrt-shortcuts__link" href={card.href}>
+          <span class="smrt-shortcuts__icon">
+            <ShellSectionIcon name={card.icon} size={28} {iconComponent} />
+          </span>
+          <span class="smrt-shortcuts__title">{card.label}</span>
+          {#if card.description}<span class="smrt-shortcuts__desc">{card.description}</span>{/if}
+        </a>
+      </li>
+    {/each}
+  </ul>
+{/if}
+
+<style>
+  .smrt-shortcuts { display: grid; grid-template-columns: repeat(auto-fill, minmax(min(12rem, 100%), 1fr)); gap: var(--smrt-spacing-3); margin: 0; padding: 0; list-style: none; }
+  .smrt-shortcuts__card { position: relative; display: flex; min-inline-size: 0; border: 1px solid var(--smrt-color-outline-variant); border-radius: var(--smrt-radius-large, var(--smrt-radius-medium)); background: var(--smrt-color-surface); transition: background-color 120ms, border-color 120ms; }
+  .smrt-shortcuts__card:hover { background: var(--smrt-color-surface-container-high); border-color: var(--smrt-color-outline); }
+  .smrt-shortcuts__link { flex: 1 1 auto; display: flex; flex-direction: column; gap: var(--smrt-spacing-2); padding: var(--smrt-spacing-3); color: var(--smrt-color-on-surface); text-decoration: none; }
+  .smrt-shortcuts__link:focus-visible { outline: 2px solid var(--smrt-color-primary); outline-offset: 2px; border-radius: inherit; }
+  .smrt-shortcuts__icon { display: inline-grid; place-items: center; inline-size: 3rem; block-size: 3rem; border-radius: var(--smrt-radius-full, 9999px); background: var(--smrt-color-primary-container); color: var(--smrt-color-on-primary-container); }
+  .smrt-shortcuts__icon :global(.smrt-shell-section-icon) { inline-size: 28px; block-size: 28px; }
+  .smrt-shortcuts__title { font-weight: var(--smrt-typography-weight-medium, 500); overflow-wrap: anywhere; }
+  .smrt-shortcuts__desc { display: -webkit-box; -webkit-line-clamp: 2; line-clamp: 2; -webkit-box-orient: vertical; overflow: hidden; color: var(--smrt-color-on-surface-variant); font-size: var(--smrt-typography-body-medium-size, 0.875rem); }
+  .smrt-shortcuts__empty { margin: 0; color: var(--smrt-color-on-surface-variant); }
+</style>

package/dist/components/overview/widgets/ShortcutsWidget.svelte.d.ts

@@ -0,0 +1,6 @@
+import type { WidgetComponentProps } from '../types.js';
+import { type ShortcutsWidgetData } from './data.js';
+declare const ShortcutsWidget: import("svelte").Component<WidgetComponentProps<ShortcutsWidgetData>, {}, "">;
+type ShortcutsWidget = ReturnType<typeof ShortcutsWidget>;
+export default ShortcutsWidget;
+//# sourceMappingURL=ShortcutsWidget.svelte.d.ts.map

package/dist/components/overview/widgets/ShortcutsWidget.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShortcutsWidget.svelte.d.ts","sourceRoot":"","sources":["../../../../src/components/overview/widgets/ShortcutsWidget.svelte.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAY,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAqE/D,QAAA,MAAM,eAAe,+EAAwC,CAAC;AAC9D,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAC1D,eAAe,eAAe,CAAC"}

package/dist/components/overview/widgets/core.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The core widget definitions (#3727): metric, chart, record list, shortcuts
+ * and note. Data-backed widgets take their loader by structural injection, so
+ * this package depends on no data package: an app wires `load` to runtime
+ * reports, a collection query, or the planner's in-browser source.
+ *
+ * ```ts
+ * registerCoreWidgets(defaultWidgetRegistry, {
+ *   metric: (options, ctx) => countRecords(ctx, options),
+ *   chart: (options, ctx) => runReportChart(ctx, options),
+ * });
+ * ```
+ */
+import { type WidgetRegistry } from '../registry.js';
+import type { WidgetDefinition, WidgetLoad } from '../types.js';
+import type { ChartWidgetData, MetricWidgetData, RecordListWidgetData, ShortcutsWidgetData } from './data.js';
+/** Metric: one number from a model. Options: model, measure, field, filter. */
+export declare function createMetricWidget(load: WidgetLoad<MetricWidgetData>): WidgetDefinition<MetricWidgetData>;
+/** Chart: values grouped by a field over a period. */
+export declare function createChartWidget(load: WidgetLoad<ChartWidgetData>): WidgetDefinition<ChartWidgetData>;
+/** Record list: the latest or top records of a model. */
+export declare function createRecordListWidget(load: WidgetLoad<RecordListWidgetData>): WidgetDefinition<RecordListWidgetData>;
+/**
+ * Shortcuts: the section-overview cards. The default widget of a section
+ * overview; its loader typically wraps `shortcutsFromNav`.
+ */
+export declare function createShortcutsWidget(load: WidgetLoad<ShortcutsWidgetData>): WidgetDefinition<ShortcutsWidgetData>;
+/** Note: sanitized Markdown text. Needs no loader. */
+export declare function createNoteWidget(): WidgetDefinition;
+/** The loaders an app supplies; a widget without one is not registered. */
+export interface CoreWidgetLoaders {
+    metric?: WidgetLoad<MetricWidgetData>;
+    chart?: WidgetLoad<ChartWidgetData>;
+    records?: WidgetLoad<RecordListWidgetData>;
+    shortcuts?: WidgetLoad<ShortcutsWidgetData>;
+}
+/**
+ * Register the core widgets on `registry`: `note` always, each data-backed
+ * widget only when its loader is given. Returns a disposer for all of them.
+ */
+export declare function registerCoreWidgets(registry?: WidgetRegistry, loaders?: CoreWidgetLoaders, options?: {
+    replace?: boolean;
+}): () => void;
+//# sourceMappingURL=core.d.ts.map

package/dist/components/overview/widgets/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../src/components/overview/widgets/core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAyB,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,KAAK,EACV,gBAAgB,EAChB,UAAU,EAEX,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,WAAW,CAAC;AA2CnB,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,UAAU,CAAC,gBAAgB,CAAC,GACjC,gBAAgB,CAAC,gBAAgB,CAAC,CAgBpC;AAED,sDAAsD;AACtD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,UAAU,CAAC,eAAe,CAAC,GAChC,gBAAgB,CAAC,eAAe,CAAC,CA0CnC;AAED,yDAAyD;AACzD,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,UAAU,CAAC,oBAAoB,CAAC,GACrC,gBAAgB,CAAC,oBAAoB,CAAC,CAkCxC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,UAAU,CAAC,mBAAmB,CAAC,GACpC,gBAAgB,CAAC,mBAAmB,CAAC,CAmBvC;AAED,sDAAsD;AACtD,wBAAgB,gBAAgB,IAAI,gBAAgB,CAoBnD;AAED,2EAA2E;AAC3E,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,UAAU,CAAC,eAAe,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAC3C,SAAS,CAAC,EAAE,UAAU,CAAC,mBAAmB,CAAC,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,GAAE,cAAsC,EAChD,OAAO,GAAE,iBAAsB,EAC/B,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAClC,MAAM,IAAI,CAyBZ"}

package/dist/components/overview/widgets/core.js

@@ -0,0 +1,222 @@
+/**
+ * The core widget definitions (#3727): metric, chart, record list, shortcuts
+ * and note. Data-backed widgets take their loader by structural injection, so
+ * this package depends on no data package: an app wires `load` to runtime
+ * reports, a collection query, or the planner's in-browser source.
+ *
+ * ```ts
+ * registerCoreWidgets(defaultWidgetRegistry, {
+ *   metric: (options, ctx) => countRecords(ctx, options),
+ *   chart: (options, ctx) => runReportChart(ctx, options),
+ * });
+ * ```
+ */
+import { defaultWidgetRegistry } from '../registry.js';
+import ChartWidget from './ChartWidget.svelte';
+import MetricWidget from './MetricWidget.svelte';
+import NoteWidget from './NoteWidget.svelte';
+import RecordListWidget from './RecordListWidget.svelte';
+import ShortcutsWidget from './ShortcutsWidget.svelte';
+const titleField = {
+    key: 'title',
+    type: 'text',
+    label: 'ui.overview.opt.title',
+    help: 'ui.overview.opt.title_help',
+    maxLength: 80,
+};
+const modelField = {
+    key: 'model',
+    type: 'model',
+    label: 'ui.overview.opt.model',
+    help: 'ui.overview.opt.model_help',
+    required: true,
+};
+const filterField = {
+    key: 'filter',
+    type: 'identifier',
+    label: 'ui.overview.opt.filter',
+    help: 'ui.overview.opt.filter_help',
+};
+const fieldField = {
+    key: 'field',
+    type: 'identifier',
+    label: 'ui.overview.opt.field',
+    help: 'ui.overview.opt.field_help',
+};
+const measureField = (choices) => ({
+    key: 'measure',
+    type: 'enum',
+    label: 'ui.overview.opt.measure',
+    default: 'count',
+    choices: choices.map((value) => ({
+        value,
+        label: `ui.overview.opt.measure_${value}`,
+    })),
+});
+/** Metric: one number from a model. Options: model, measure, field, filter. */
+export function createMetricWidget(load) {
+    return {
+        type: 'metric',
+        title: 'ui.overview.widget.metric.title',
+        description: 'ui.overview.widget.metric.description',
+        icon: 'layers',
+        options: [
+            titleField,
+            modelField,
+            measureField(['count', 'sum', 'avg', 'min', 'max']),
+            fieldField,
+            filterField,
+        ],
+        component: MetricWidget,
+        load,
+    };
+}
+/** Chart: values grouped by a field over a period. */
+export function createChartWidget(load) {
+    return {
+        type: 'chart',
+        title: 'ui.overview.widget.chart.title',
+        description: 'ui.overview.widget.chart.description',
+        icon: 'repeat',
+        options: [
+            titleField,
+            modelField,
+            {
+                key: 'groupBy',
+                type: 'identifier',
+                label: 'ui.overview.opt.group_by',
+            },
+            measureField(['count', 'sum', 'avg']),
+            fieldField,
+            {
+                key: 'period',
+                type: 'enum',
+                label: 'ui.overview.opt.period',
+                default: '30d',
+                choices: ['7d', '30d', '90d', '12m', 'all'].map((value) => ({
+                    value,
+                    label: `ui.overview.opt.period_${value}`,
+                })),
+            },
+            {
+                key: 'style',
+                type: 'enum',
+                label: 'ui.overview.opt.style',
+                default: 'bar',
+                choices: [
+                    { value: 'bar', label: 'ui.overview.opt.style_bar' },
+                    { value: 'line', label: 'ui.overview.opt.style_line' },
+                ],
+            },
+            filterField,
+        ],
+        component: ChartWidget,
+        load,
+        defaultSpan: 2,
+    };
+}
+/** Record list: the latest or top records of a model. */
+export function createRecordListWidget(load) {
+    return {
+        type: 'records',
+        title: 'ui.overview.widget.records.title',
+        description: 'ui.overview.widget.records.description',
+        icon: 'fileText',
+        options: [
+            titleField,
+            modelField,
+            { key: 'sort', type: 'identifier', label: 'ui.overview.opt.sort' },
+            {
+                key: 'direction',
+                type: 'enum',
+                label: 'ui.overview.opt.direction',
+                default: 'desc',
+                choices: [
+                    { value: 'desc', label: 'ui.overview.opt.direction_desc' },
+                    { value: 'asc', label: 'ui.overview.opt.direction_asc' },
+                ],
+            },
+            {
+                key: 'limit',
+                type: 'integer',
+                label: 'ui.overview.opt.limit',
+                default: 5,
+                min: 1,
+                max: 20,
+            },
+            filterField,
+        ],
+        component: RecordListWidget,
+        load,
+        defaultSpan: 2,
+    };
+}
+/**
+ * Shortcuts: the section-overview cards. The default widget of a section
+ * overview; its loader typically wraps `shortcutsFromNav`.
+ */
+export function createShortcutsWidget(load) {
+    return {
+        type: 'shortcuts',
+        title: 'ui.overview.widget.shortcuts.title',
+        description: 'ui.overview.widget.shortcuts.description',
+        icon: 'home',
+        options: [
+            titleField,
+            {
+                key: 'section',
+                type: 'identifier',
+                label: 'ui.overview.opt.section',
+                help: 'ui.overview.opt.section_help',
+            },
+        ],
+        component: ShortcutsWidget,
+        load,
+        defaultSpan: 4,
+    };
+}
+/** Note: sanitized Markdown text. Needs no loader. */
+export function createNoteWidget() {
+    return {
+        type: 'note',
+        title: 'ui.overview.widget.note.title',
+        description: 'ui.overview.widget.note.description',
+        icon: 'fileText',
+        options: [
+            titleField,
+            {
+                key: 'body',
+                type: 'markdown',
+                label: 'ui.overview.opt.body',
+                help: 'ui.overview.opt.body_help',
+                default: '',
+                maxLength: 4000,
+            },
+        ],
+        component: NoteWidget,
+        defaultSpan: 2,
+    };
+}
+/**
+ * Register the core widgets on `registry`: `note` always, each data-backed
+ * widget only when its loader is given. Returns a disposer for all of them.
+ */
+export function registerCoreWidgets(registry = defaultWidgetRegistry, loaders = {}, options = {}) {
+    const disposers = [registry.register(createNoteWidget(), options)];
+    if (loaders.metric) {
+        disposers.push(registry.register(createMetricWidget(loaders.metric), options));
+    }
+    if (loaders.chart) {
+        disposers.push(registry.register(createChartWidget(loaders.chart), options));
+    }
+    if (loaders.records) {
+        disposers.push(registry.register(createRecordListWidget(loaders.records), options));
+    }
+    if (loaders.shortcuts) {
+        disposers.push(registry.register(createShortcutsWidget(loaders.shortcuts), options));
+    }
+    return () => {
+        for (const dispose of disposers)
+            dispose();
+    };
+}

package/dist/components/overview/widgets/data.d.ts

@@ -0,0 +1,76 @@
+/**
+ * The data each core widget renders (#3727), and the pure helpers a loader
+ * uses to produce it. The shapes are structural on purpose: a loader can be
+ * backed by runtime reports, a collection query or the planner's in-browser
+ * source without this package depending on any of them.
+ */
+import type { WidgetValueFormat } from '../format.js';
+/** `metric`: one number. `money` values are integer minor units. */
+export interface MetricWidgetData {
+    value: number;
+    format?: WidgetValueFormat;
+    /** ISO 4217 code for `money`. */
+    currency?: string;
+    /** Caption under the number (default: the widget title only). */
+    label?: string;
+    /** Percent change against the previous period (12.5 means +12.5%). */
+    change?: number | null;
+    href?: string;
+}
+/** `chart`: values grouped by label. Shaped like one measure of a runtime report. */
+export interface ChartWidgetData {
+    points: {
+        label: string;
+        value: number;
+    }[];
+    format?: WidgetValueFormat;
+    currency?: string;
+    href?: string;
+}
+/** `records`: the rows to list. The loader chooses the title field. */
+export interface RecordListWidgetData {
+    rows: {
+        id: string;
+        title: string;
+        subtitle?: string;
+        meta?: string;
+        href?: string;
+    }[];
+    /** Total matching records, when more than `rows`. */
+    total?: number;
+    /** Link to the full list. */
+    href?: string;
+}
+/** `shortcuts`: cards that link to pages. */
+export interface ShortcutsWidgetData {
+    items: {
+        id: string;
+        label: string;
+        href: string;
+        icon?: string;
+        description?: string;
+    }[];
+}
+/** The part of a shell nav model section `shortcutsFromNav` reads. */
+export interface ShortcutNavSection {
+    id: string;
+    items: readonly {
+        id: string;
+        label: string;
+        hidden?: boolean;
+        item: {
+            href: string;
+            icon?: string;
+            description?: string;
+        };
+    }[];
+}
+/**
+ * Cards for one navigation section: its visible entries with the user's
+ * renames, as `resolveShellNavModel(...)` (or `useShellLayout().sections`)
+ * reports them. Entries with an unsafe href are skipped. With no
+ * `sectionId`, every section's entries are listed.
+ */
+export declare function shortcutsFromNav(sections: readonly ShortcutNavSection[], sectionId?: string): ShortcutsWidgetData;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=data.d.ts.map

package/dist/components/overview/widgets/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../../../src/components/overview/widgets/data.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGtD,oEAAoE;AACpE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qFAAqF;AACrF,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3C,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,uEAAuE;AACvE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,EAAE,CAAC;IACJ,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,EAAE,CAAC;CACL;AAED,sEAAsE;AACtE,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS;QACd,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,IAAI,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC7D,EAAE,CAAC;CACL;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,SAAS,kBAAkB,EAAE,EACvC,SAAS,CAAC,EAAE,MAAM,GACjB,mBAAmB,CAoBrB;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE"}

package/dist/components/overview/widgets/data.js

@@ -0,0 +1,40 @@
+/**
+ * The data each core widget renders (#3727), and the pure helpers a loader
+ * uses to produce it. The shapes are structural on purpose: a loader can be
+ * backed by runtime reports, a collection query or the planner's in-browser
+ * source without this package depending on any of them.
+ */
+import { safeHref } from '../markdown.js';
+/**
+ * Cards for one navigation section: its visible entries with the user's
+ * renames, as `resolveShellNavModel(...)` (or `useShellLayout().sections`)
+ * reports them. Entries with an unsafe href are skipped. With no
+ * `sectionId`, every section's entries are listed.
+ */
+export function shortcutsFromNav(sections, sectionId) {
+    const items = [];
+    for (const section of sections) {
+        if (sectionId && section.id !== sectionId)
+            continue;
+        for (const entry of section.items) {
+            if (entry.hidden)
+                continue;
+            const href = safeHref(entry.item.href);
+            if (!href)
+                continue;
+            items.push({
+                id: entry.id,
+                label: entry.label,
+                href,
+                ...(entry.item.icon ? { icon: entry.item.icon } : {}),
+                ...(entry.item.description
+                    ? { description: entry.item.description }
+                    : {}),
+            });
+        }
+    }
+    return { items };
+}
+export function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}