@revenexx/studio-shared 0.3.3 → 0.4.1

package/dist/runtime/components/Dashboard/DashboardWidgetFrame.vue

@@ -1,7 +1,10 @@
 <script setup>
+import { Progress } from "@revenexx/studio";
 import { CloseCircle, MenuDots, Settings } from "#solar-icons";
 import { computed } from "vue";
 import WidgetIcon from "./DashboardWidgetIcon.vue";
+import { provideWidgetHeader } from "../../composables/useWidgetHeader";
+import { figuresText, provideWidgetFigures } from "../../composables/useWidgetFigures";
 import { widgetTitle } from "../../lib/widgetRegistry";
 const props = defineProps({
   definition: { type: Object, required: false },
@@ -13,14 +16,17 @@ defineEmits(["configure", "remove"]);
 const t = useT();
 const heading = computed(() => widgetTitle(props.definition, t, props.title));
 const bare = computed(() => props.definition?.bare === true);
+const status = provideWidgetHeader();
+const figures = provideWidgetFigures();
+const figuresAttr = computed(() => figuresText(figures.value) || void 0);
 </script>
 
 <template>
-  <div class="relative h-full min-h-0" :class="editing ? 'select-none' : ''">
+  <div class="relative h-full min-h-0" :class="editing ? 'select-none' : ''" data-dashboard-widget :data-widget-title="heading" :data-widget-figures="figuresAttr">
     <!-- Bare widgets keep the card surface they already had; the frame stays
          out of the way so the migration is a move, not a redesign. -->
     <template v-if="bare">
-      <div class="h-full min-h-0 overflow-hidden">
+      <div class="h-full min-h-0 overflow-hidden" data-widget-body>
         <slot />
       </div>
     </template>
@@ -35,8 +41,13 @@ const bare = computed(() => props.definition?.bare === true);
                 {{ heading }}
               </h3>
             </div>
+            <div v-if="status" class="flex min-w-0 items-center gap-1.5 text-xs text-muted-foreground" aria-live="polite">
+              <span class="truncate">{{ status.text }}</span>
+              <Progress v-if="status.busy && status.progress != null" :model-value="status.progress" class="h-1 w-16 shrink-0" />
+              <span v-else-if="status.busy" class="size-3 shrink-0 animate-spin rounded-full border-2 border-primary/25 border-t-primary" aria-hidden="true" />
+            </div>
           </div>
-          <div class="min-h-0 flex-1 overflow-auto">
+          <div class="min-h-0 flex-1 overflow-auto" data-widget-body>
             <slot />
           </div>
         </div>

package/dist/runtime/components/Dashboard/DashboardWidgetFrame.vue.d.ts

@@ -5,20 +5,21 @@ type __VLS_Props = {
     editing?: boolean;
     configurable?: boolean;
 };
-declare var __VLS_1: {}, __VLS_6: {};
+declare var __VLS_1: {}, __VLS_13: {};
 type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_1) => any;
 } & {
-    default?: (props: typeof __VLS_6) => any;
+    default?: (props: typeof __VLS_13) => any;
 };
-declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     remove: () => any;
     configure: () => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onRemove?: (() => any) | undefined;
     onConfigure?: (() => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
 export default _default;
 type __VLS_WithSlots<T, S> = T & {
     new (): {

package/dist/runtime/components/Dashboard/DashboardWidgetHost.d.vue.ts

@@ -2,5 +2,6 @@ import type { DashboardWidget } from '../../types/dashboard.js';
 type __VLS_Props = {
     widget: DashboardWidget;
 };
-declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/components/Dashboard/DashboardWidgetHost.vue.d.ts

@@ -2,5 +2,6 @@ import type { DashboardWidget } from '../../types/dashboard.js';
 type __VLS_Props = {
     widget: DashboardWidget;
 };
-declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/components/Dashboard/DashboardWidgetIcon.d.vue.ts

@@ -2,7 +2,8 @@ type __VLS_Props = {
     name?: string;
     size?: number;
 };
-declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     size: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/components/Dashboard/DashboardWidgetIcon.vue.d.ts

@@ -2,7 +2,8 @@ type __VLS_Props = {
     name?: string;
     size?: number;
 };
-declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     size: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/components/Dashboard/DashboardWidgetLibrary.d.vue.ts

@@ -11,7 +11,7 @@ type __VLS_Props = {
      */
     installedApps?: string[];
 };
-declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:open": (value: boolean) => any;
     add: (definition: WidgetDefinition) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
@@ -20,4 +20,5 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {
 }>, {
     installedApps: string[];
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/components/Dashboard/DashboardWidgetLibrary.vue.d.ts

@@ -11,7 +11,7 @@ type __VLS_Props = {
      */
     installedApps?: string[];
 };
-declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:open": (value: boolean) => any;
     add: (definition: WidgetDefinition) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
@@ -20,4 +20,5 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {
 }>, {
     installedApps: string[];
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/components/Dashboard/DashboardWidgetPreview.d.vue.ts

@@ -16,7 +16,8 @@ type __VLS_Props = {
     shape: WidgetPreviewShape;
     dimmed?: boolean;
 };
-declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     dimmed: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/components/Dashboard/DashboardWidgetPreview.vue.d.ts

@@ -16,7 +16,8 @@ type __VLS_Props = {
     shape: WidgetPreviewShape;
     dimmed?: boolean;
 };
-declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     dimmed: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/components/DataTable/ColumnsMenu.d.vue.ts

@@ -4,11 +4,12 @@ type __VLS_Props = {
     /** Set of currently visible column keys. */
     visible: Set<string>;
 };
-declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     toggle: (key: string) => any;
     reorder: (from: number, to: number) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onToggle?: ((key: string) => any) | undefined;
     onReorder?: ((from: number, to: number) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/components/DataTable/ColumnsMenu.vue.d.ts

@@ -4,11 +4,12 @@ type __VLS_Props = {
     /** Set of currently visible column keys. */
     visible: Set<string>;
 };
-declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     toggle: (key: string) => any;
     reorder: (from: number, to: number) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onToggle?: ((key: string) => any) | undefined;
     onReorder?: ((from: number, to: number) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/components/DataTable/DataTable.d.vue.ts

@@ -1,15 +1,7 @@
 import type { Facet, FacetSelection } from '../../lib/facets.js';
 import type { DataTableColumn, DataTableFilter, DataTableRail, DataTableSavedViews, DataTableState, DataTableViewMode, RowKey, SortState } from './types.js';
-declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
-    props: __VLS_PrettifyLocal<Pick<Partial<{}> & Omit<{
-        readonly "onUpdate:sort"?: ((value: SortState) => any) | undefined;
-        readonly "onUpdate:page"?: ((value: number) => any) | undefined;
-        readonly "onUpdate:viewMode"?: ((value: string) => any) | undefined;
-        readonly "onUpdate:railOpen"?: ((value: boolean) => any) | undefined;
-        readonly "onUpdate:facetSelection"?: ((value: FacetSelection) => any) | undefined;
-        readonly onRowClick?: ((row: T) => any) | undefined;
-        readonly onStateChange?: ((state: DataTableState) => any) | undefined;
-    } & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, never>, "onUpdate:sort" | "onUpdate:page" | "onUpdate:viewMode" | "onUpdate:railOpen" | "onUpdate:facetSelection" | "onRowClick" | "onStateChange"> & ({
+declare const __VLS_export: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: import("vue").PublicProps & __VLS_PrettifyLocal<({
         data: T[];
         columns: DataTableColumn<T>[];
         rowKey: RowKey<T>;
@@ -82,6 +74,12 @@ declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>
         scrollBody?: boolean | "fit" | {
             maxHeight?: string;
         };
+        /**
+         * Extra room `'fit'` keeps free under the table — for a bar the host floats
+         * over the bottom of the list while rows are selected, so it never covers
+         * the pagination row (Re-QA 18.10.).
+         */
+        reserveBottom?: number;
         pagination?: boolean | {
             pageSize?: number;
         };
@@ -95,11 +93,68 @@ declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>
         emptyText?: string;
         groupBy?: ((row: T) => string[]) | null;
         groupEmptyLabel?: string;
+        /** The row whose record is open beside the table (a DetailSheet), marked so
+         *  reading down the list keeps the place visible (PE-690). */
+        activeRowKey?: string | number | null;
+        /**
+         * A row's own tint — a quantity tier set apart under the SKU it belongs to.
+         * Replaces the row's default ground rather than stacking on it: two
+         * translucent backgrounds on one element are whichever Tailwind emitted last.
+         */
+        rowClass?: ((row: T) => string | null | undefined) | null;
+        /**
+         * Rows the operator orders by dragging (PE-952). Draws a handle in a leading
+         * column; a drop — or the arrow keys on a focused handle — emits `rowMove`
+         * with the new order. The table writes nothing: what a position MEANS, and
+         * which rows have to be written for it, is the surface's to decide.
+         */
+        reorderable?: boolean;
+        /**
+         * Why the handles are off right now, or null when they are on. The surface
+         * knows the cases this component cannot see — a sort that is not the
+         * sequence, a write still in flight. The table adds its own: a search, a
+         * filter or a grouping, under any of which "the row above" is not the row
+         * above in the sequence.
+         */
+        reorderDisabled?: string | null;
+        /**
+         * Below 768px every row is drawn as a card — title, status badge, two lines
+         * of key facts — instead of a grid two columns of which fit (R4, Charge 2).
+         * Off for a table that is already narrow by nature.
+         */
+        mobileCards?: boolean;
+        /** `localStorage` key the row-height choice is remembered under (D4). */
+        densityKey?: string;
+        /**
+         * Which table the rows-per-page choice is remembered for (PE-1052). Falls
+         * back to the saved views' `storageKey`; with neither, the size is not kept.
+         */
+        pageSizeKey?: string | null;
+        /**
+         * A table set INTO a card on a detail page (Michael 14.10.): no frame or
+         * corners of its own, the grey head row running edge to edge, and the
+         * search row plain white — the tinted toolbar is a list page's chrome, and
+         * inside a card it read as a second box with too little contrast.
+         */
+        embedded?: boolean;
+        /**
+         * Draw the control row at all. A detail-page card hides it until the
+         * operator asks (the filter toggle in the card head, Michael 14.10.), so a
+         * table of three rows is three rows and not a toolbar with a table under it.
+         */
+        toolbar?: boolean;
     } & {
+        query?: string;
         sort?: SortState;
         page?: number;
         viewMode?: string;
         railOpen?: boolean;
+        /**
+         * Row height (D4, Charge 2). Standard is 44px with a second line only in the
+         * identifying column; compact is 36px and one line everywhere. The reader's
+         * choice, remembered across lists — it is about their screen, not one list.
+         */
+        density?: "standard" | "compact";
         /**
          * The committed facet selection. Two-way so a chip removed under the toolbar,
          * a facet picked in the surface's pinned rail and the panel's own Apply all
@@ -107,38 +162,66 @@ declare const _default: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>
          * URL without this component holding a second copy to drift from.
          */
         facetSelection?: FacetSelection;
-    }) & Partial<{}>> & import("vue").PublicProps;
-    expose(exposed: import("vue").ShallowUnwrapRef<{}>): void;
+    }) & {
+        onRowClick?: ((row: T) => any) | undefined;
+        onStateChange?: ((state: DataTableState) => any) | undefined;
+        onOrderChange?: ((keys: (string | number)[]) => any) | undefined;
+        onRowMove?: ((move: {
+            key: string | number;
+            from: number;
+            to: number;
+            keys: (string | number)[];
+        }) => any) | undefined;
+        "onUpdate:query"?: ((value: string) => any) | undefined;
+        "onUpdate:sort"?: ((value: SortState) => any) | undefined;
+        "onUpdate:page"?: ((value: number) => any) | undefined;
+        "onUpdate:viewMode"?: ((value: string) => any) | undefined;
+        "onUpdate:railOpen"?: ((value: boolean) => any) | undefined;
+        "onUpdate:density"?: ((value: "compact" | "standard") => any) | undefined;
+        "onUpdate:facetSelection"?: ((value: FacetSelection) => any) | undefined;
+    }> & (typeof globalThis extends {
+        __VLS_PROPS_FALLBACK: infer P;
+    } ? P : {});
+    expose: (exposed: import("vue").ShallowUnwrapRef<{
+        visibleColumns: any;
+    }>) => void;
     attrs: any;
     slots: {
-        [x: string]: ((props: {}) => any) | undefined;
-    } & {
-        [x: string]: ((props: {
-            row: any;
-        }) => any) | undefined;
-    } & {
-        'filter-menu'?: (props: {}) => any;
-    } & {
-        scope?: (props: {}) => any;
-    } & {
-        'toolbar-left'?: (props: {}) => any;
-    } & {
-        'toolbar-right'?: (props: {}) => any;
-    } & {
-        actions?: (props: {}) => any;
-    } & {
+        [name: `header-${string}`]: (props: Record<string, never>) => unknown;
+        [name: `cell-${string}`]: (props: {
+            row: T;
+        }) => unknown;
+        'filter-menu'?: (props: Record<string, never>) => unknown;
+        scope?: (props: Record<string, never>) => unknown;
+        'toolbar-left'?: (props: Record<string, never>) => unknown;
+        'toolbar-right'?: (props: Record<string, never>) => unknown;
+        actions?: (props: Record<string, never>) => unknown;
         view?: (props: {
-            rows: any;
-            loading: any;
-        }) => any;
-    } & {
-        empty?: (props: {}) => any;
+            rows: T[];
+            loading: boolean;
+        }) => unknown;
+        empty?: (props: {
+            query: string;
+            filters: {
+                label: string;
+                values: string[];
+            }[];
+            clear: () => void;
+        }) => unknown;
     };
-    emit: (((evt: "rowClick", row: T) => void) & ((evt: "stateChange", state: DataTableState) => void)) & (((evt: "update:sort", value: SortState) => void) & ((evt: "update:page", value: number) => void) & ((evt: "update:viewMode", value: string) => void) & ((evt: "update:railOpen", value: boolean) => void) & ((evt: "update:facetSelection", value: FacetSelection) => void));
+    emit: (((evt: "rowClick", row: T) => void) & ((evt: "stateChange", state: DataTableState) => void) & ((evt: "orderChange", keys: (string | number)[]) => void) & ((evt: "rowMove", move: {
+        key: string | number;
+        from: number;
+        to: number;
+        keys: (string | number)[];
+    }) => void)) & (((event: "update:query", value: string) => void) & ((event: "update:sort", value: SortState) => void) & ((event: "update:page", value: number) => void) & ((event: "update:viewMode", value: string) => void) & ((event: "update:railOpen", value: boolean) => void) & ((event: "update:density", value: "compact" | "standard") => void) & ((event: "update:facetSelection", value: FacetSelection) => void));
 }>) => import("vue").VNode & {
-    __ctx?: Awaited<typeof __VLS_setup>;
+    __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };
+declare const _default: typeof __VLS_export;
 export default _default;
-type __VLS_PrettifyLocal<T> = {
+type __VLS_PrettifyLocal<T> = (T extends any ? {
     [K in keyof T]: T[K];
-} & {};
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};