mgv-backoffice 1.48.0 → 1.49.0

package/README.md

@@ -2051,6 +2051,23 @@ first paint:
 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
 ```
 
+## Added in 1.49.0
+
+| Export | Purpose |
+| --- | --- |
+| `BaseTextarea` | Multi-line input with BaseInput's skin. |
+| `BaseRating` | Read-only star rating: `rating`, optional `count`. |
+| `BaseRowButton` | Compact table-row action: `variant` `outline` / `primary` / `danger`. |
+| `BaseBooleanIcon` | Icon-only yes/no flag; label in the tooltip. |
+| `BasePhotoViewer` | Full-screen viewer: `photos`, `v-model` index, `@close`; `closeLabel`, `previousLabel`, `nextLabel`. |
+| `useRefreshOnReturn(fn, afterMs?)` | Re-runs `fn` when the tab returns after being hidden (default 30s). |
+| `fmtTime`, `toLocalInput`, `fromLocalInput` | Backend time and `datetime-local` helpers. |
+
+Existing components gained: `BaseSelect` `icon` slot and numeric `modelValue`,
+`BaseStatCard` `value` slot and `violet` accent, `BaseDetailList` scoped `value`
+slot, `BaseSidebarUser` `avatarUrl`, dark-mode colours on `BaseBadge`. `BaseField`
+links its label to the slotted control automatically when `labelFor` is not set.
+
 ## Design system
 
 `dist/style.css` ships the shared "Night Terminal" look, so importing it is all a

package/dist/components/BaseBooleanIcon.vue.d.ts

@@ -0,0 +1,14 @@
+type __VLS_Props = {
+    value?: boolean | null;
+    trueLabel?: string;
+    falseLabel?: string;
+    emptyText?: string;
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    value: boolean | null;
+    emptyText: string;
+    trueLabel: string;
+    falseLabel: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/BaseDetailList.vue.d.ts

@@ -5,9 +5,21 @@ interface Props {
     columns?: 1 | 2 | 3;
     emptyText?: string;
 }
-declare const __VLS_export: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {
+declare var __VLS_1: {
+    item: DetailItem;
+};
+type __VLS_Slots = {} & {
+    value?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {
     emptyText: string;
     columns: 1 | 2 | 3;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+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 (): {
+        $slots: S;
+    };
+};

package/dist/components/BasePhotoViewer.vue.d.ts

@@ -0,0 +1,24 @@
+import { ViewerPhoto } from '../types/photoViewer';
+type __VLS_Props = {
+    photos: ViewerPhoto[];
+    closeLabel?: string;
+    previousLabel?: string;
+    nextLabel?: string;
+};
+type __VLS_ModelProps = {
+    modelValue: number;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare const __VLS_export: import('vue').DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    close: () => any;
+    "update:modelValue": (value: number) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    onClose?: (() => any) | undefined;
+    "onUpdate:modelValue"?: ((value: number) => any) | undefined;
+}>, {
+    closeLabel: string;
+    previousLabel: string;
+    nextLabel: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/BaseRating.vue.d.ts

@@ -0,0 +1,9 @@
+type __VLS_Props = {
+    rating: number;
+    count?: number | null;
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    count: number | null;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/BaseRowButton.vue.d.ts

@@ -0,0 +1,18 @@
+type __VLS_Props = {
+    variant?: 'outline' | 'primary' | 'danger';
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    variant: "outline" | "primary" | "danger";
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+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 (): {
+        $slots: S;
+    };
+};

package/dist/components/BaseSelect.vue.d.ts

@@ -1,5 +1,5 @@
 interface Props {
-    modelValue?: string | null;
+    modelValue?: string | number | null;
     /** 'sm' = px-2 py-1.5 (default, the usual select height); 'md' = px-3 py-2. */
     size?: 'sm' | 'md';
     /** Full-width (w-full). Set false for inline selects. */
@@ -7,15 +7,27 @@ interface Props {
     /** Render underscores in option text as spaces (BLUE_SKY → BLUE SKY). Values are untouched. */
     humanize?: boolean;
 }
-declare const __VLS_export: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+declare var __VLS_6: {
+    iconClass: string;
+};
+type __VLS_Slots = {} & {
+    icon?: (props: typeof __VLS_6) => any;
+};
+declare const __VLS_base: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
     "update:modelValue": (value: any) => any;
 }, string, import('vue').PublicProps, Readonly<Props> & Readonly<{
     "onUpdate:modelValue"?: ((value: any) => any) | undefined;
 }>, {
     size: "sm" | "md";
     block: boolean;
-    modelValue: string | null;
+    modelValue: string | number | null;
     humanize: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+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 (): {
+        $slots: S;
+    };
+};

package/dist/components/BaseSidebarUser.vue.d.ts

@@ -2,6 +2,8 @@ import { RouteLocationRaw } from 'vue-router';
 interface Props {
     name: string;
     email?: string;
+    /** Photo shown instead of the initials. */
+    avatarUrl?: string | null;
     /** Profile route; makes the name/email block a link. */
     to?: RouteLocationRaw;
     showLogout?: boolean;
@@ -15,6 +17,7 @@ declare const __VLS_export: import('vue').DefineComponent<Props, {}, {}, {}, {},
 }>, {
     email: string;
     to: RouteLocationRaw;
+    avatarUrl: string | null;
     showLogout: boolean;
     logoutLabel: string;
     profileLabel: string;

package/dist/components/BaseStatCard.vue.d.ts

@@ -1,5 +1,5 @@
 import { RouteLocationRaw } from 'vue-router';
-type Accent = 'emerald' | 'sky' | 'amber' | 'red' | 'slate';
+type Accent = 'emerald' | 'sky' | 'amber' | 'violet' | 'red' | 'slate';
 interface Props {
     title: string;
     value?: string | number;
@@ -9,13 +9,15 @@ interface Props {
     /** Makes the card a router link. */
     to?: RouteLocationRaw;
 }
-declare var __VLS_8: {}, __VLS_10: {
+declare var __VLS_8: {}, __VLS_10: {}, __VLS_12: {
     iconClass: string;
 };
 type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_8) => any;
+    value?: (props: typeof __VLS_8) => any;
 } & {
-    icon?: (props: typeof __VLS_10) => any;
+    default?: (props: typeof __VLS_10) => any;
+} & {
+    icon?: (props: typeof __VLS_12) => any;
 };
 declare const __VLS_base: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {
     to: RouteLocationRaw;

package/dist/components/BaseTextarea.vue.d.ts

@@ -0,0 +1,12 @@
+interface Props {
+    modelValue?: string | null;
+}
+declare const __VLS_export: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    "update:modelValue": (value: string) => any;
+}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
+}>, {
+    modelValue: string | null;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/composables/useRefreshOnReturn.d.ts

@@ -0,0 +1,7 @@
+/** How long the tab must be hidden before coming back reloads the page's data; quick switches keep it. */
+export declare const REFRESH_AFTER_AWAY_MS = 30000;
+/**
+ * Calls `refresh` when the browser tab becomes visible again after `afterMs` or more hidden, since server data
+ * changes while the user is elsewhere. The first load is left to the component.
+ */
+export declare function useRefreshOnReturn(refresh: () => unknown, afterMs?: number): void;

package/dist/index.d.ts

@@ -59,6 +59,13 @@ export { default as BaseSidebarUser } from './components/BaseSidebarUser.vue';
 export { default as BaseAuthLayout } from './components/BaseAuthLayout.vue';
 export { default as BaseBooleanBadge } from './components/BaseBooleanBadge.vue';
 export { default as BaseDetailList } from './components/BaseDetailList.vue';
+export { default as BaseTextarea } from './components/BaseTextarea.vue';
+export { default as BaseRating } from './components/BaseRating.vue';
+export { default as BaseRowButton } from './components/BaseRowButton.vue';
+export { default as BaseBooleanIcon } from './components/BaseBooleanIcon.vue';
+export { default as BasePhotoViewer } from './components/BasePhotoViewer.vue';
+export type { ViewerPhoto } from './types/photoViewer';
+export { useRefreshOnReturn, REFRESH_AFTER_AWAY_MS } from './composables/useRefreshOnReturn';
 export type { DetailItem } from './types/detail';
 export { useTheme, initTheme } from './composables/useTheme';
 export type { UseThemeOptions } from './composables/useTheme';
@@ -107,7 +114,7 @@ export { methodBadgeSolid, methodBadgeBright, methodBadgeTinted, statusBadgeSoli
 export { rowKeyMissing, rowValueMissing } from './utils/kvRows';
 export type { KeyValueRowLike } from './utils/kvRows';
 export { sanitizeHtml, isSafeHref } from './utils/sanitizeHtml';
-export { fmtNumber, fmtDate, fmtDateTime, fmtDateTimeMs, fmtDateShort, fmtCalendarDate, fmtCalendarDateTime, fmtMsAsSeconds, fmtBytes, fmtPrice, fmtPct, fmtUsd, fmtMoney, currencySymbol, fmtCurrencyAmount, fmtDuration, formatJson, stringifyValue, } from './utils/format';
+export { fmtNumber, fmtDate, fmtDateTime, fmtDateTimeMs, fmtDateShort, fmtCalendarDate, fmtCalendarDateTime, fmtMsAsSeconds, fmtBytes, fmtPrice, fmtPct, fmtUsd, fmtMoney, currencySymbol, fmtCurrencyAmount, fmtDuration, formatJson, fmtTime, toLocalInput, fromLocalInput, stringifyValue, } from './utils/format';
 export { isValidAbsoluteUrl, isValidJson, isValidXml, isValidBase64, } from './utils/validate';
 export { buildSpecParams, firstInvalidNumericSpec } from './utils/specForm';
 export { humanizeEnum, humanizeTextVNodes } from './utils/humanize';

package/dist/types/photoViewer.d.ts

@@ -0,0 +1,6 @@
+/** One photo in a BasePhotoViewer. */
+export interface ViewerPhoto {
+    src: string;
+    label: string;
+    caption?: string | null;
+}