@smartsoft001/react 0.0.0-stage → 2.193.0

package/src/lib/services/modal/modal.service.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModalService = void 0;
+const store_1 = require("../../store");
+/**
+ * Opens a component in a modal dialog. The component receives `props` and can
+ * close the dialog, with a result, through `useModalService().dismiss(data)`
+ * or the `dismiss` prop it is given.
+ */
+class ModalService {
+    modals = new store_1.SmartStore([]);
+    nextId = 1;
+    async show(options) {
+        const id = this.nextId++;
+        let resolveDismiss;
+        const dismissed = new Promise((resolve) => {
+            resolveDismiss = resolve;
+        });
+        const dismiss = (data = null) => {
+            if (!this.modals.get().some((m) => m.id === id))
+                return;
+            this.modals.update((modals) => modals.filter((m) => m.id !== id));
+            resolveDismiss({ data });
+        };
+        this.modals.update((modals) => [...modals, { ...options, id, dismiss }]);
+        return { dismiss, onDidDismiss: () => dismissed };
+    }
+    /** Closes the modal opened last. */
+    async dismiss(data = null) {
+        const modals = this.modals.get();
+        modals[modals.length - 1]?.dismiss(data);
+    }
+}
+exports.ModalService = ModalService;
+//# sourceMappingURL=modal.service.js.map

package/src/lib/services/modal/modal.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modal.service.js","sourceRoot":"","sources":["../../../../../../../../packages/shared/react/src/lib/services/modal/modal.service.ts"],"names":[],"mappings":";;;AAEA,uCAAyC;AAoBzC;;;;GAIG;AACH,MAAa,YAAY;IACd,MAAM,GAAG,IAAI,kBAAU,CAAkB,EAAE,CAAC,CAAC;IAE9C,MAAM,GAAG,CAAC,CAAC;IAEnB,KAAK,CAAC,IAAI,CAAC,OAA6B;QACtC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,IAAI,cAAgD,CAAC;QACrD,MAAM,SAAS,GAAG,IAAI,OAAO,CAAgB,CAAC,OAAO,EAAE,EAAE;YACvD,cAAc,GAAG,OAAO,CAAC;QAC3B,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,CAAC,OAAY,IAAI,EAAE,EAAE;YACnC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;gBAAE,OAAO;YAExD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YAClE,cAAc,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3B,CAAC,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;QAEzE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;IACpD,CAAC;IAED,oCAAoC;IACpC,KAAK,CAAC,OAAO,CAAI,OAAiB,IAAI;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QAEjC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;CACF;AA9BD,oCA8BC"}

package/src/lib/services/storage/storage.service.d.ts

@@ -0,0 +1,13 @@
+/**
+ * JSON values in `localStorage`. Every call is guarded, so the service is safe
+ * to construct during server-side rendering and in a sandboxed browser, where
+ * the storage is missing or throws.
+ */
+export declare class StorageService {
+    private readonly storage;
+    constructor(storage?: Storage | null);
+    setItem(key: string, value: unknown): void;
+    getItem<T = any>(key: string): T | null;
+    removeItem(key: string): void;
+    clear(): void;
+}

package/src/lib/services/storage/storage.service.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageService = void 0;
+/**
+ * JSON values in `localStorage`. Every call is guarded, so the service is safe
+ * to construct during server-side rendering and in a sandboxed browser, where
+ * the storage is missing or throws.
+ */
+class StorageService {
+    storage;
+    constructor(storage = defaultStorage()) {
+        this.storage = storage;
+    }
+    setItem(key, value) {
+        if (typeof value === 'undefined' || value === null) {
+            this.removeItem(key);
+            return;
+        }
+        try {
+            this.storage?.setItem(key, JSON.stringify(value));
+        }
+        catch (e) {
+            console.error('Error saving to localStorage', e);
+        }
+    }
+    getItem(key) {
+        try {
+            const item = this.storage?.getItem(key);
+            return item ? JSON.parse(item) : null;
+        }
+        catch (e) {
+            console.error('Error getting data from localStorage', e);
+            return null;
+        }
+    }
+    removeItem(key) {
+        try {
+            this.storage?.removeItem(key);
+        }
+        catch (e) {
+            console.error('Error removing data from localStorage', e);
+        }
+    }
+    clear() {
+        try {
+            this.storage?.clear();
+        }
+        catch (e) {
+            console.error('Error clearing localStorage', e);
+        }
+    }
+}
+exports.StorageService = StorageService;
+function defaultStorage() {
+    try {
+        return typeof localStorage === 'undefined' ? null : localStorage;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=storage.service.js.map

package/src/lib/services/storage/storage.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.service.js","sourceRoot":"","sources":["../../../../../../../../packages/shared/react/src/lib/services/storage/storage.service.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,MAAa,cAAc;IACI;IAA7B,YAA6B,UAA0B,cAAc,EAAE;QAA1C,YAAO,GAAP,OAAO,CAAmC;IAAG,CAAC;IAE3E,OAAO,CAAC,GAAW,EAAE,KAAc;QACjC,IAAI,OAAO,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,CAAC,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,OAAO,CAAU,GAAW;QAC1B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;YAExC,OAAO,IAAI,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,sCAAsC,EAAE,CAAC,CAAC,CAAC;YACzD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,UAAU,CAAC,GAAW;QACpB,IAAI,CAAC;YACH,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,CAAC,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC;YACH,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;QACxB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,CAAC,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;CACF;AA1CD,wCA0CC;AAED,SAAS,cAAc;IACrB,IAAI,CAAC;QACH,OAAO,OAAO,YAAY,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/src/lib/services/style/style.service.d.ts

@@ -0,0 +1,15 @@
+import { IStyle } from '../../models/style';
+/**
+ * Writes the application's style settings (colours, font, button metrics,
+ * breakpoints) as CSS custom properties on an element, the way the Angular
+ * `StyleService` did. Settings accumulate across calls to `set`.
+ */
+export declare class StyleService {
+    private style;
+    private element;
+    init(element: HTMLElement | null, style?: IStyle): void;
+    set(style?: IStyle): void;
+    get(): IStyle;
+    private execute;
+    private setProperty;
+}

package/src/lib/services/style/style.service.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StyleService = void 0;
+const COLORS = [
+    'primary',
+    'secondary',
+    'tertiary',
+    'success',
+    'warning',
+    'danger',
+    'dark',
+    'medium',
+    'light',
+];
+const COLOR_SUFFIXES = [
+    '',
+    '-rgb',
+    '-contrast',
+    '-contrast-rgb',
+    '-shade',
+    '-tint',
+];
+/**
+ * Writes the application's style settings (colours, font, button metrics,
+ * breakpoints) as CSS custom properties on an element, the way the Angular
+ * `StyleService` did. Settings accumulate across calls to `set`.
+ */
+class StyleService {
+    style = {};
+    element = null;
+    init(element, style) {
+        this.element = element;
+        this.set(style);
+    }
+    set(style) {
+        this.style = { ...this.style, ...(style ?? {}) };
+        this.execute();
+    }
+    get() {
+        return this.style;
+    }
+    execute() {
+        for (const name of COLORS) {
+            for (const suffix of COLOR_SUFFIXES) {
+                const type = `color-${name}${suffix}`;
+                this.setProperty(`--smart-color-${name}${suffix}`, type);
+                this.setProperty(`--ion-color-${name}${suffix}`, type);
+            }
+        }
+        this.setProperty('--ion-font-family', 'font');
+        this.setProperty('--default-font-weight', 'font-weight');
+        this.setProperty('--default-font-style', 'font-style');
+        this.setProperty('--smart-button-height', 'button-height');
+        this.setProperty('--smart-button-min-width', 'button-min-width');
+        this.setProperty('--smart-button-padding-right', 'button-padding-right');
+        this.setProperty('--smart-button-padding-left', 'button-padding-left');
+        this.setProperty('--smart-button-padding-top', 'button-padding-top');
+        this.setProperty('--smart-button-padding-bottom', 'button-padding-bottom');
+        this.setProperty('--smart-button-icon-size', 'button-icon-size');
+        this.setProperty('--phone-breakpoint', 'phone-breakpoint');
+        this.setProperty('--tablet-breakpoint', 'tablet-breakpoint');
+    }
+    setProperty(property, type) {
+        const value = this.style[type];
+        if (!this.element || !value)
+            return;
+        this.element.style.setProperty(property, value);
+    }
+}
+exports.StyleService = StyleService;
+//# sourceMappingURL=style.service.js.map

package/src/lib/services/style/style.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.service.js","sourceRoot":"","sources":["../../../../../../../../packages/shared/react/src/lib/services/style/style.service.ts"],"names":[],"mappings":";;;AAEA,MAAM,MAAM,GAAG;IACb,SAAS;IACT,WAAW;IACX,UAAU;IACV,SAAS;IACT,SAAS;IACT,QAAQ;IACR,MAAM;IACN,QAAQ;IACR,OAAO;CACR,CAAC;AAEF,MAAM,cAAc,GAAG;IACrB,EAAE;IACF,MAAM;IACN,WAAW;IACX,eAAe;IACf,QAAQ;IACR,OAAO;CACR,CAAC;AAEF;;;;GAIG;AACH,MAAa,YAAY;IACf,KAAK,GAAW,EAAE,CAAC;IACnB,OAAO,GAAuB,IAAI,CAAC;IAE3C,IAAI,CAAC,OAA2B,EAAE,KAAc;QAC9C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC;IAED,GAAG,CAAC,KAAc;QAChB,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED,GAAG;QACD,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAEO,OAAO;QACb,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;YAC1B,KAAK,MAAM,MAAM,IAAI,cAAc,EAAE,CAAC;gBACpC,MAAM,IAAI,GAAG,SAAS,IAAI,GAAG,MAAM,EAAe,CAAC;gBAEnD,IAAI,CAAC,WAAW,CAAC,iBAAiB,IAAI,GAAG,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC;gBACzD,IAAI,CAAC,WAAW,CAAC,eAAe,IAAI,GAAG,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,WAAW,CAAC,uBAAuB,EAAE,aAAa,CAAC,CAAC;QACzD,IAAI,CAAC,WAAW,CAAC,sBAAsB,EAAE,YAAY,CAAC,CAAC;QAEvD,IAAI,CAAC,WAAW,CAAC,uBAAuB,EAAE,eAAe,CAAC,CAAC;QAC3D,IAAI,CAAC,WAAW,CAAC,0BAA0B,EAAE,kBAAkB,CAAC,CAAC;QACjE,IAAI,CAAC,WAAW,CAAC,8BAA8B,EAAE,sBAAsB,CAAC,CAAC;QACzE,IAAI,CAAC,WAAW,CAAC,6BAA6B,EAAE,qBAAqB,CAAC,CAAC;QACvE,IAAI,CAAC,WAAW,CAAC,4BAA4B,EAAE,oBAAoB,CAAC,CAAC;QACrE,IAAI,CAAC,WAAW,CAAC,+BAA+B,EAAE,uBAAuB,CAAC,CAAC;QAC3E,IAAI,CAAC,WAAW,CAAC,0BAA0B,EAAE,kBAAkB,CAAC,CAAC;QAEjE,IAAI,CAAC,WAAW,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,CAAC;QAC3D,IAAI,CAAC,WAAW,CAAC,qBAAqB,EAAE,mBAAmB,CAAC,CAAC;IAC/D,CAAC;IAEO,WAAW,CAAC,QAAgB,EAAE,IAAe;QACnD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE/B,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK;YAAE,OAAO;QAEpC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;CACF;AAnDD,oCAmDC"}

package/src/lib/services/toast/toast.service.d.ts

@@ -0,0 +1,35 @@
+import { SmartStore } from '../../store';
+export interface IToastButton {
+    text: string;
+    position: 'start' | 'end';
+    handler: () => void;
+}
+export interface IToastOptions {
+    title?: string;
+    message: string;
+    /** Milliseconds before the toast closes itself (default 2000). */
+    duration?: number;
+    buttons?: Array<IToastButton>;
+}
+export interface IToast extends IToastOptions {
+    id: number;
+    type: 'error' | 'info';
+}
+/**
+ * Short messages shown at the bottom of the screen. `SmartProvider` renders
+ * the queue; any code with the service can push to it. While an error lock is
+ * held (`addLockError`), error toasts are swallowed, e.g. during a sign-out
+ * that makes every pending request fail.
+ */
+export declare class ToastService {
+    readonly toasts: SmartStore<IToast[]>;
+    private lockError;
+    private nextId;
+    private readonly timers;
+    addLockError(): void;
+    removeLockError(): void;
+    error(config: IToastOptions): Promise<void>;
+    info(config: IToastOptions): Promise<void>;
+    dismiss(id: number): void;
+    private push;
+}

package/src/lib/services/toast/toast.service.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToastService = void 0;
+const store_1 = require("../../store");
+/**
+ * Short messages shown at the bottom of the screen. `SmartProvider` renders
+ * the queue; any code with the service can push to it. While an error lock is
+ * held (`addLockError`), error toasts are swallowed, e.g. during a sign-out
+ * that makes every pending request fail.
+ */
+class ToastService {
+    toasts = new store_1.SmartStore([]);
+    lockError = 0;
+    nextId = 1;
+    timers = new Map();
+    addLockError() {
+        ++this.lockError;
+    }
+    removeLockError() {
+        this.lockError = Math.max(0, this.lockError - 1);
+    }
+    async error(config) {
+        if (this.lockError)
+            return;
+        this.push('error', config);
+    }
+    async info(config) {
+        this.push('info', config);
+    }
+    dismiss(id) {
+        const timer = this.timers.get(id);
+        if (timer)
+            clearTimeout(timer);
+        this.timers.delete(id);
+        this.toasts.update((toasts) => toasts.filter((t) => t.id !== id));
+    }
+    push(type, config) {
+        const id = this.nextId++;
+        this.toasts.update((toasts) => [...toasts, { ...config, id, type }]);
+        this.timers.set(id, setTimeout(() => this.dismiss(id), config.duration ?? 2000));
+    }
+}
+exports.ToastService = ToastService;
+//# sourceMappingURL=toast.service.js.map

package/src/lib/services/toast/toast.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast.service.js","sourceRoot":"","sources":["../../../../../../../../packages/shared/react/src/lib/services/toast/toast.service.ts"],"names":[],"mappings":";;;AAAA,uCAAyC;AAqBzC;;;;;GAKG;AACH,MAAa,YAAY;IACd,MAAM,GAAG,IAAI,kBAAU,CAAW,EAAE,CAAC,CAAC;IAEvC,SAAS,GAAG,CAAC,CAAC;IACd,MAAM,GAAG,CAAC,CAAC;IACF,MAAM,GAAG,IAAI,GAAG,EAAyC,CAAC;IAE3E,YAAY;QACV,EAAE,IAAI,CAAC,SAAS,CAAC;IACnB,CAAC;IAED,eAAe;QACb,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAqB;QAC/B,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAE3B,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAqB;QAC9B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,CAAC,EAAU;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAElC,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAE/B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACvB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACpE,CAAC;IAEO,IAAI,CAAC,IAAoB,EAAE,MAAqB;QACtD,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAEzB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACrE,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,EAAE,EACF,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,CAC5D,CAAC;IACJ,CAAC;CACF;AA3CD,oCA2CC"}

package/src/lib/store/index.d.ts

@@ -0,0 +1 @@
+export * from './store';

package/src/lib/store/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./store"), exports);
+//# sourceMappingURL=index.js.map

package/src/lib/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../packages/shared/react/src/lib/store/index.ts"],"names":[],"mappings":";;;AAAA,kDAAwB"}

package/src/lib/store/store.d.ts

@@ -0,0 +1,19 @@
+/**
+ * A tiny external store: one value, replaced immutably, observed through
+ * `subscribe`. The services that hold UI state (toasts, alerts, modals, menu,
+ * app buttons) and the CRUD feature state are built on it, and React reads
+ * them with `useStore`, so a change re-renders exactly the components that
+ * read it, the way a signal or an NgRx selector did in the Angular library.
+ */
+export declare class SmartStore<T> {
+    private state;
+    private readonly listeners;
+    constructor(initial: T);
+    get(): T;
+    set(next: T): void;
+    update(updater: (current: T) => T): void;
+    subscribe: (listener: () => void) => (() => void);
+}
+/** Reads `store` (or a slice of it) and re-renders when it changes. */
+export declare function useStore<T>(store: SmartStore<T>): T;
+export declare function useStore<T, S>(store: SmartStore<T>, selector: (state: T) => S): S;

package/src/lib/store/store.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SmartStore = void 0;
+exports.useStore = useStore;
+const react_1 = require("react");
+/**
+ * A tiny external store: one value, replaced immutably, observed through
+ * `subscribe`. The services that hold UI state (toasts, alerts, modals, menu,
+ * app buttons) and the CRUD feature state are built on it, and React reads
+ * them with `useStore`, so a change re-renders exactly the components that
+ * read it, the way a signal or an NgRx selector did in the Angular library.
+ */
+class SmartStore {
+    state;
+    listeners = new Set();
+    constructor(initial) {
+        this.state = initial;
+    }
+    get() {
+        return this.state;
+    }
+    set(next) {
+        if (Object.is(next, this.state))
+            return;
+        this.state = next;
+        for (const listener of [...this.listeners])
+            listener();
+    }
+    update(updater) {
+        this.set(updater(this.state));
+    }
+    subscribe = (listener) => {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    };
+}
+exports.SmartStore = SmartStore;
+function useStore(store, selector) {
+    const getSnapshot = (0, react_1.useCallback)(() => (selector ? selector(store.get()) : store.get()), [store, selector]);
+    return (0, react_1.useSyncExternalStore)(store.subscribe, getSnapshot, getSnapshot);
+}
+//# sourceMappingURL=store.js.map

package/src/lib/store/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../../../../../packages/shared/react/src/lib/store/store.ts"],"names":[],"mappings":";;;AAgDA,4BAUC;AA1DD,iCAA0D;AAE1D;;;;;;GAMG;AACH,MAAa,UAAU;IACb,KAAK,CAAI;IACA,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;IAEnD,YAAY,OAAU;QACpB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC;IACvB,CAAC;IAED,GAAG;QACD,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,GAAG,CAAC,IAAO;QACT,IAAI,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO;QAExC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAElB,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;YAAE,QAAQ,EAAE,CAAC;IACzD,CAAC;IAED,MAAM,CAAC,OAA0B;QAC/B,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAChC,CAAC;IAED,SAAS,GAAG,CAAC,QAAoB,EAAgB,EAAE;QACjD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE7B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC,CAAC;IACJ,CAAC,CAAC;CACH;AA/BD,gCA+BC;AAQD,SAAgB,QAAQ,CACtB,KAAoB,EACpB,QAA0B;IAE1B,MAAM,WAAW,GAAG,IAAA,mBAAW,EAC7B,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EACtD,CAAC,KAAK,EAAE,QAAQ,CAAC,CAClB,CAAC;IAEF,OAAO,IAAA,4BAAoB,EAAC,KAAK,CAAC,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;AACzE,CAAC"}

package/src/lib/utils/class-names.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Joins class names, skipping empty values. The components build their
+ * Tailwind classes from arrays of explicit literals, as in the Angular
+ * library, so the class scanner finds every one.
+ */
+export declare function cn(...values: Array<string | false | null | undefined | Array<string | false | null | undefined>>): string;

package/src/lib/utils/class-names.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cn = cn;
+/**
+ * Joins class names, skipping empty values. The components build their
+ * Tailwind classes from arrays of explicit literals, as in the Angular
+ * library, so the class scanner finds every one.
+ */
+function cn(...values) {
+    const result = [];
+    for (const value of values) {
+        if (!value)
+            continue;
+        if (Array.isArray(value)) {
+            for (const item of value)
+                if (item)
+                    result.push(item);
+        }
+        else {
+            result.push(value);
+        }
+    }
+    return result.join(' ');
+}
+//# sourceMappingURL=class-names.js.map

package/src/lib/utils/class-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-names.js","sourceRoot":"","sources":["../../../../../../../packages/shared/react/src/lib/utils/class-names.ts"],"names":[],"mappings":";;AAKA,gBAkBC;AAvBD;;;;GAIG;AACH,SAAgB,EAAE,CAChB,GAAG,MAEF;IAED,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK;YAAE,SAAS;QAErB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,KAAK,MAAM,IAAI,IAAI,KAAK;gBAAE,IAAI,IAAI;oBAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxD,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC"}

package/src/lib/utils/hooks.d.ts

@@ -0,0 +1,10 @@
+/** The label of a model field, translated (`smartModelLabel`). */
+export declare function useModelLabel(instance: unknown, key: string, type?: unknown): string;
+/** A label function bound to the provider, for lists of fields. */
+export declare function useModelLabelFn(): (instance: unknown, key: string, type?: unknown) => string;
+/** A header function bound to the provider (`smartListHeader`). */
+export declare function useListHeaderFn(): (data: unknown, key: string, type?: unknown) => string;
+/** The download URL of an attachment (`smartFileUrl`). */
+export declare function useFileUrl(file: {
+    id: any;
+} | null | undefined): string;

package/src/lib/utils/hooks.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useModelLabel = useModelLabel;
+exports.useModelLabelFn = useModelLabelFn;
+exports.useListHeaderFn = useListHeaderFn;
+exports.useFileUrl = useFileUrl;
+const react_1 = require("react");
+const model_1 = require("./model");
+const smart_context_1 = require("../providers/smart-context");
+/** The label of a model field, translated (`smartModelLabel`). */
+function useModelLabel(instance, key, type) {
+    const { translate, modelLabelProvider } = (0, smart_context_1.useSmart)();
+    return (0, model_1.getModelLabel)(instance, key, type, {
+        translate,
+        labelProvider: modelLabelProvider,
+    });
+}
+/** A label function bound to the provider, for lists of fields. */
+function useModelLabelFn() {
+    const { translate, modelLabelProvider } = (0, smart_context_1.useSmart)();
+    return (0, react_1.useCallback)((instance, key, type) => (0, model_1.getModelLabel)(instance, key, type, {
+        translate,
+        labelProvider: modelLabelProvider,
+    }), [translate, modelLabelProvider]);
+}
+/** A header function bound to the provider (`smartListHeader`). */
+function useListHeaderFn() {
+    const { translate, modelLabelProvider } = (0, smart_context_1.useSmart)();
+    return (0, react_1.useCallback)((data, key, type) => (0, model_1.getListHeader)(data, key, type, {
+        translate,
+        labelProvider: modelLabelProvider,
+    }), [translate, modelLabelProvider]);
+}
+/** The download URL of an attachment (`smartFileUrl`). */
+function useFileUrl(file) {
+    const { fileService } = (0, smart_context_1.useSmart)();
+    if (!file || !fileService)
+        return '';
+    return fileService.getUrl(file.id);
+}
+//# sourceMappingURL=hooks.js.map

package/src/lib/utils/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../../../../../packages/shared/react/src/lib/utils/hooks.ts"],"names":[],"mappings":";;AAMA,sCAWC;AAGD,0CAeC;AAGD,0CAeC;AAGD,gCAMC;AA9DD,iCAAoC;AAEpC,mCAAuD;AACvD,8DAAsD;AAEtD,kEAAkE;AAClE,SAAgB,aAAa,CAC3B,QAAiB,EACjB,GAAW,EACX,IAAc;IAEd,MAAM,EAAE,SAAS,EAAE,kBAAkB,EAAE,GAAG,IAAA,wBAAQ,GAAE,CAAC;IAErD,OAAO,IAAA,qBAAa,EAAC,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE;QACxC,SAAS;QACT,aAAa,EAAE,kBAAkB;KAClC,CAAC,CAAC;AACL,CAAC;AAED,mEAAmE;AACnE,SAAgB,eAAe;IAK7B,MAAM,EAAE,SAAS,EAAE,kBAAkB,EAAE,GAAG,IAAA,wBAAQ,GAAE,CAAC;IAErD,OAAO,IAAA,mBAAW,EAChB,CAAC,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,CACtB,IAAA,qBAAa,EAAC,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE;QACjC,SAAS;QACT,aAAa,EAAE,kBAAkB;KAClC,CAAC,EACJ,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAChC,CAAC;AACJ,CAAC;AAED,mEAAmE;AACnE,SAAgB,eAAe;IAK7B,MAAM,EAAE,SAAS,EAAE,kBAAkB,EAAE,GAAG,IAAA,wBAAQ,GAAE,CAAC;IAErD,OAAO,IAAA,mBAAW,EAChB,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,CAClB,IAAA,qBAAa,EAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE;QAC7B,SAAS;QACT,aAAa,EAAE,kBAAkB;KAClC,CAAC,EACJ,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAChC,CAAC;AACJ,CAAC;AAED,0DAA0D;AAC1D,SAAgB,UAAU,CAAC,IAAoC;IAC7D,MAAM,EAAE,WAAW,EAAE,GAAG,IAAA,wBAAQ,GAAE,CAAC;IAEnC,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW;QAAE,OAAO,EAAE,CAAC;IAErC,OAAO,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACrC,CAAC"}

package/src/lib/utils/html.d.ts

@@ -0,0 +1,29 @@
+declare const TRUSTED: unique symbol;
+/**
+ * HTML the application vouches for, rendered as is. The React counterpart of
+ * returning `SafeHtml` from `DomSanitizer.bypassSecurityTrustHtml`.
+ */
+export interface SmartTrustedHtml {
+    readonly [TRUSTED]: true;
+    readonly html: string;
+}
+/** Marks `html` as trusted, so the components skip sanitising it. */
+export declare function trustHtml(html: string): SmartTrustedHtml;
+export declare function isTrustedHtml(value: unknown): value is SmartTrustedHtml;
+/**
+ * Removes everything active from `html`: scripts, event handlers, iframes,
+ * SVG and MathML, inline `style` attributes and `javascript:` URLs, keeping
+ * the formatting and safe links. This is the protection Angular's sanitizer
+ * gave the text details; React renders HTML verbatim, so the components call
+ * this before `dangerouslySetInnerHTML`.
+ *
+ * Without a DOM (server rendering) the markup cannot be parsed safely, so the
+ * tags are dropped and the text is escaped.
+ */
+export declare function sanitizeHtml(html: string | null | undefined): string;
+/** The `__html` to render a value with: trusted as is, anything else sanitised. */
+export declare function toInnerHtml(value: unknown): {
+    __html: string;
+};
+export declare function escapeHtml(value: string): string;
+export {};

package/src/lib/utils/html.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trustHtml = trustHtml;
+exports.isTrustedHtml = isTrustedHtml;
+exports.sanitizeHtml = sanitizeHtml;
+exports.toInnerHtml = toInnerHtml;
+exports.escapeHtml = escapeHtml;
+const tslib_1 = require("tslib");
+const dompurify_1 = tslib_1.__importDefault(require("dompurify"));
+const utils_1 = require("@smartsoft001/utils");
+const TRUSTED = Symbol.for('smartsoft:trusted-html');
+/** Marks `html` as trusted, so the components skip sanitising it. */
+function trustHtml(html) {
+    return { [TRUSTED]: true, html };
+}
+function isTrustedHtml(value) {
+    return (!!value &&
+        typeof value === 'object' &&
+        value[TRUSTED] === true);
+}
+/**
+ * Removes everything active from `html`: scripts, event handlers, iframes,
+ * SVG and MathML, inline `style` attributes and `javascript:` URLs, keeping
+ * the formatting and safe links. This is the protection Angular's sanitizer
+ * gave the text details; React renders HTML verbatim, so the components call
+ * this before `dangerouslySetInnerHTML`.
+ *
+ * Without a DOM (server rendering) the markup cannot be parsed safely, so the
+ * tags are dropped and the text is escaped.
+ */
+function sanitizeHtml(html) {
+    if (!html)
+        return '';
+    if (typeof window === 'undefined' || !dompurify_1.default.isSupported) {
+        return escapeHtml(utils_1.RemoveHtmlService.create(html));
+    }
+    return dompurify_1.default.sanitize(html, {
+        USE_PROFILES: { html: true },
+        FORBID_TAGS: ['style', 'iframe', 'form', 'object', 'embed'],
+        FORBID_ATTR: ['style'],
+    });
+}
+/** The `__html` to render a value with: trusted as is, anything else sanitised. */
+function toInnerHtml(value) {
+    if (isTrustedHtml(value))
+        return { __html: value.html };
+    return {
+        __html: sanitizeHtml(value === null || value === undefined ? '' : String(value)),
+    };
+}
+function escapeHtml(value) {
+    return value
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+//# sourceMappingURL=html.js.map

package/src/lib/utils/html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","sourceRoot":"","sources":["../../../../../../../packages/shared/react/src/lib/utils/html.ts"],"names":[],"mappings":";;AAgBA,8BAEC;AAED,sCAMC;AAYD,oCAYC;AAGD,kCAQC;AAED,gCAOC;;AAtED,kEAAkC;AAElC,+CAAwD;AAExD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;AAWrD,qEAAqE;AACrE,SAAgB,SAAS,CAAC,IAAY;IACpC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAsB,CAAC;AACvD,CAAC;AAED,SAAgB,aAAa,CAAC,KAAc;IAC1C,OAAO,CACL,CAAC,CAAC,KAAK;QACP,OAAO,KAAK,KAAK,QAAQ;QACxB,KAAiC,CAAC,OAAO,CAAC,KAAK,IAAI,CACrD,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,YAAY,CAAC,IAA+B;IAC1D,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAErB,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,CAAC,mBAAS,CAAC,WAAW,EAAE,CAAC;QAC5D,OAAO,UAAU,CAAC,yBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,mBAAS,CAAC,QAAQ,CAAC,IAAI,EAAE;QAC9B,YAAY,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;QAC5B,WAAW,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC;QAC3D,WAAW,EAAE,CAAC,OAAO,CAAC;KACvB,CAAC,CAAC;AACL,CAAC;AAED,mFAAmF;AACnF,SAAgB,WAAW,CAAC,KAAc;IACxC,IAAI,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;IAExD,OAAO;QACL,MAAM,EAAE,YAAY,CAClB,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAC3D;KACF,CAAC;AACJ,CAAC;AAED,SAAgB,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK;SACT,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5B,CAAC"}

package/src/lib/utils/index.d.ts

@@ -0,0 +1,4 @@
+export * from './class-names';
+export * from './hooks';
+export * from './html';
+export * from './model';

package/src/lib/utils/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./class-names"), exports);
+tslib_1.__exportStar(require("./hooks"), exports);
+tslib_1.__exportStar(require("./html"), exports);
+tslib_1.__exportStar(require("./model"), exports);
+//# sourceMappingURL=index.js.map

package/src/lib/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../packages/shared/react/src/lib/utils/index.ts"],"names":[],"mappings":";;;AAAA,wDAA8B;AAC9B,kDAAwB;AACxB,iDAAuB;AACvB,kDAAwB"}

package/src/lib/utils/model.d.ts

@@ -0,0 +1,28 @@
+import { FieldTypeDef } from '@smartsoft001/models';
+import { SmartTranslateFn } from '../i18n/translate';
+import { ICellPipe } from '../models/interfaces';
+import { IModelLabelProvider } from '../providers/model-label.provider';
+/** `smartEnumToList`: the keys of an enum object. */
+export declare function enumToList(value: any): Array<string>;
+/** `smartRemoveHtml` */
+export declare function removeHtml(value: string | undefined | null): string;
+/** `smartSlug` */
+export declare function slug(value: string | undefined | null): string;
+/** `smartModelLabel`: the label of a field, from the provider or `MODEL.<key>`. */
+export declare function getModelLabel(instance: unknown, key: string, type: unknown, deps: {
+    translate: SmartTranslateFn;
+    labelProvider?: IModelLabelProvider | null;
+}): string;
+/** `smartListHeader`: the header of a list column. */
+export declare function getListHeader<T>(data: T, key: string, type: unknown, deps: {
+    translate: SmartTranslateFn;
+    labelProvider?: IModelLabelProvider | null;
+}): string;
+/**
+ * `smartListCell`: the value of a list cell, run through the cell pipe and
+ * the translations, with the field type of the column.
+ */
+export declare function getListCell<T extends Record<string, any>>(obj: T, key: string, pipe: ICellPipe<T> | null | undefined, type: any, translate: SmartTranslateFn): {
+    value?: any;
+    type?: FieldTypeDef | null;
+};