@africanies/angular-web-sdk 0.1.3 → 0.1.4

package/.nx/cache/4082520855419352840/dist/libs/africanies-theme/types/africanies-africanies-theme.d.ts

@@ -0,0 +1,166 @@
+import * as i0 from '@angular/core';
+
+/**
+ * Tailwind safelist side-effect for shipping-mode color utilities.
+ *
+ * WHY this file exists: JIT/content scanning only keeps class names that appear
+ * as *literal strings* in scanned sources. {@link ModeColorService} already
+ * returns these literals, but keeping a dedicated comment list makes the
+ * contract obvious for consumers who configure `safelist` or purge plugins.
+ *
+ * Do not rename these strings without updating ModeColorService and THEME.md.
+ *
+ * SFN (export / green):
+ * text-export bg-export bg-export-subtle bg-export-light border-export
+ * hover:bg-export-light hover:bg-export-subtle dark:bg-export/15 dark:hover:bg-export/15
+ * dark:bg-[color-mix(in_srgb,#1cbd5d_15%,#212529)]
+ *
+ * STN (import / orange):
+ * text-import bg-import bg-import-subtle bg-import-light border-import
+ * hover:bg-import-light hover:bg-import-subtle dark:bg-import/15 dark:hover:bg-import/15
+ * dark:bg-[color-mix(in_srgb,#f08829_15%,#212529)]
+ */
+declare const MODE_COLOR_SAFELIST: readonly ["text-export", "bg-export", "bg-export-subtle", "bg-export-light", "border-export", "hover:bg-export-light", "hover:bg-export-subtle", "dark:bg-export/15", "dark:hover:bg-export/15", "dark:bg-[color-mix(in_srgb,#1cbd5d_15%,#212529)]", "text-import", "bg-import", "bg-import-subtle", "bg-import-light", "border-import", "hover:bg-import-light", "hover:bg-import-subtle", "dark:bg-import/15", "dark:hover:bg-import/15", "dark:bg-[color-mix(in_srgb,#f08829_15%,#212529)]"];
+
+/**
+ * Tailwind class bundle for the active shipping mode (SFN export / STN import).
+ *
+ * Use these for **primary** product chrome: CTAs, selected controls, progress,
+ * and accent text. Semantic colors (danger / warning) stay mode-independent.
+ */
+interface ModeColorClasses {
+    /** Text color utility, e.g. `text-export`. */
+    text: string;
+    /** Solid background utility, e.g. `bg-export`. */
+    bg: string;
+    /** Soft background utility, e.g. `bg-export-subtle`. */
+    bgSubtle: string;
+    /** Border matching the mode accent, e.g. `border-export`. */
+    border: string;
+    /**
+     * Filled primary CTA — `variant="primary"` on buttons.
+     * Includes hover utility as a literal so Tailwind keeps it.
+     */
+    primary: string;
+    /**
+     * Transparent / text-only CTA — `variant="ghost-primary"` on buttons.
+     * Mode accent text + soft hover fill.
+     */
+    ghostPrimary: string;
+    /**
+     * Soft highlight for selected / active rows (works in dark mode).
+     * Dark uses a translucent tint — fine over solid surfaces, not for
+     * sticky overlays (see {@link softSolid}).
+     */
+    soft: string;
+    /**
+     * Opaque soft fill — same tint as {@link soft}, but dark mode mixes into
+     * ink so scrolled content cannot show through (sticky table headers/cells).
+     */
+    softSolid: string;
+    /**
+     * Soft hover highlight for menus and lists.
+     */
+    softHover: string;
+}
+/**
+ * Maps {@link ShippingModeService} to mode-accent Tailwind classes.
+ *
+ * - **SFN** → export green is primary
+ * - **STN** → import orange is primary
+ *
+ * WHY literal class strings: Tailwind's scanner cannot see dynamically built
+ * names like `` `text-${token}` ``. Returning full literals (`text-export`, …)
+ * keeps utilities in the compiled CSS. See {@link MODE_COLOR_SAFELIST}.
+ *
+ * @example
+ * ```html
+ * @let colors = modeColor.classes();
+ * <button type="button" [class]="colors.primary">Save</button>
+ * <span [class]="colors.text">Mode accent</span>
+ * ```
+ */
+declare class ModeColorService {
+    private readonly shippingMode;
+    /**
+     * Mode-dependent utility classes. Recomputes when shipping mode changes.
+     */
+    readonly classes: i0.Signal<ModeColorClasses>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ModeColorService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ModeColorService>;
+}
+
+/**
+ * Supported UI color schemes for {@link ThemeService}.
+ *
+ * Kept as a closed string union so storage values and DOM class toggles stay
+ * aligned — unknown persisted strings are ignored and fall back to system
+ * preference / light.
+ */
+type Theme = 'light' | 'dark';
+
+/**
+ * Application light/dark theme preference.
+ *
+ * WHY signals (not BehaviorSubject): theme is synchronous UI state read from
+ * templates and other services; a signal avoids RxJS subscription boilerplate
+ * and matches Angular 22 change detection. Persistence goes through
+ * {@link STORAGE_TOKEN} so tests can swap storage without touching `localStorage`.
+ *
+ * Applies the Tailwind `darkMode: 'class'` contract by toggling `dark` on
+ * `document.documentElement`, and sets `color-scheme` so native UI (date
+ * pickers, scrollbars, form controls) matches the app theme — class-based
+ * dark mode alone does not restyle browser chrome.
+ *
+ * @example
+ * ```ts
+ * // app.config.ts
+ * import { inject, provideAppInitializer } from '@angular/core';
+ * import { ThemeService } from '@africanies/africanies-theme';
+ *
+ * export const appConfig = {
+ *   providers: [
+ *     provideAppInitializer(() => {
+ *       inject(ThemeService); // applies stored / system theme once
+ *     }),
+ *   ],
+ * };
+ *
+ * // In a component
+ * const theme = inject(ThemeService);
+ * theme.toggle();
+ * theme.setTheme('dark');
+ * const current = theme.theme(); // 'light' | 'dark'
+ * ```
+ */
+declare class ThemeService {
+    private readonly storage;
+    private readonly document;
+    /**
+     * Current theme. Prefer reading via `theme()` in templates / computed values
+     * rather than caching the string, so dark-class consumers stay in sync.
+     */
+    readonly theme: i0.WritableSignal<Theme>;
+    constructor();
+    /**
+     * Sets and persists the theme, updating the `dark` class and `color-scheme`
+     * on `<html>`.
+     *
+     * @param theme - Absolute preference to store.
+     */
+    setTheme(theme: Theme): void;
+    /**
+     * Flips between light and dark.
+     *
+     * @returns The theme after the toggle.
+     */
+    toggle(): Theme;
+    private resolveInitialTheme;
+    private prefersDark;
+    private applyToDocument;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ThemeService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ThemeService>;
+}
+
+export { MODE_COLOR_SAFELIST, ModeColorService, ThemeService };
+export type { ModeColorClasses, Theme };

package/.nx/cache/run.json

@@ -1,73 +1,73 @@
 {
   "run": {
-    "command": "nx run-many -t build --projects=africanies-models,africanies-storage,africanies-core,africanies-theme,africanies-icons,africanies-ui",
-    "startTime": "2026-08-27T08:54:06.112Z",
-    "endTime": "2026-08-27T08:54:20.564Z",
+    "command": "nx run-many -t lint --parallel=3 --exclude=playground",
+    "startTime": "2026-08-28T14:48:23.575Z",
+    "endTime": "2026-08-28T14:48:30.782Z",
     "inner": false
   },
   "tasks": [
     {
-      "taskId": "africanies-models:build:production",
-      "target": "build",
+      "taskId": "africanies-models:lint",
+      "target": "lint",
       "projectName": "africanies-models",
-      "hash": "14416694322692463866",
-      "startTime": "2026-08-27T08:54:06.174Z",
-      "endTime": "2026-08-27T08:54:06.199Z",
+      "hash": "783228502946611950",
+      "startTime": "2026-08-28T14:48:24.443Z",
+      "endTime": "2026-08-28T14:48:24.443Z",
       "params": "",
       "cacheStatus": "local-cache-hit",
       "status": 0
     },
     {
-      "taskId": "africanies-storage:build:production",
-      "target": "build",
+      "taskId": "africanies-storage:lint",
+      "target": "lint",
       "projectName": "africanies-storage",
-      "hash": "15255861479705594703",
-      "startTime": "2026-08-27T08:54:06.174Z",
-      "endTime": "2026-08-27T08:54:06.199Z",
+      "hash": "7412642469886599413",
+      "startTime": "2026-08-28T14:48:24.443Z",
+      "endTime": "2026-08-28T14:48:24.443Z",
       "params": "",
       "cacheStatus": "local-cache-hit",
       "status": 0
     },
     {
-      "taskId": "africanies-icons:build:production",
-      "target": "build",
-      "projectName": "africanies-icons",
-      "hash": "6664915487114632770",
-      "startTime": "2026-08-27T08:54:06.174Z",
-      "endTime": "2026-08-27T08:54:06.199Z",
+      "taskId": "africanies-core:lint",
+      "target": "lint",
+      "projectName": "africanies-core",
+      "hash": "8648260256613557249",
+      "startTime": "2026-08-28T14:48:24.443Z",
+      "endTime": "2026-08-28T14:48:24.443Z",
       "params": "",
       "cacheStatus": "local-cache-hit",
       "status": 0
     },
     {
-      "taskId": "africanies-core:build:production",
-      "target": "build",
-      "projectName": "africanies-core",
-      "hash": "17491371155400585077",
-      "startTime": "2026-08-27T08:54:06.213Z",
-      "endTime": "2026-08-27T08:54:10.890Z",
+      "taskId": "africanies-icons:lint",
+      "target": "lint",
+      "projectName": "africanies-icons",
+      "hash": "17394769338046050914",
+      "startTime": "2026-08-28T14:48:24.443Z",
+      "endTime": "2026-08-28T14:48:24.443Z",
       "params": "",
-      "cacheStatus": "cache-miss",
+      "cacheStatus": "local-cache-hit",
       "status": 0
     },
     {
-      "taskId": "africanies-theme:build:production",
-      "target": "build",
+      "taskId": "africanies-theme:lint",
+      "target": "lint",
       "projectName": "africanies-theme",
-      "hash": "12276756491762927325",
-      "startTime": "2026-08-27T08:54:10.903Z",
-      "endTime": "2026-08-27T08:54:14.610Z",
+      "hash": "16279119293212733518",
+      "startTime": "2026-08-28T14:48:24.444Z",
+      "endTime": "2026-08-28T14:48:28.867Z",
       "params": "",
       "cacheStatus": "cache-miss",
       "status": 0
     },
     {
-      "taskId": "africanies-ui:build:production",
-      "target": "build",
+      "taskId": "africanies-ui:lint",
+      "target": "lint",
       "projectName": "africanies-ui",
-      "hash": "3314955264390318442",
-      "startTime": "2026-08-27T08:54:14.621Z",
-      "endTime": "2026-08-27T08:54:20.551Z",
+      "hash": "7126777490381568487",
+      "startTime": "2026-08-28T14:48:24.444Z",
+      "endTime": "2026-08-28T14:48:30.779Z",
       "params": "",
       "cacheStatus": "cache-miss",
       "status": 0

package/.nx/cache/terminalOutputs/16279119293212733518

@@ -0,0 +1,6 @@
+The `@nx/eslint:lint` executor is deprecated and will be removed in Nx v24. Run `nx g @nx/eslint:convert-to-inferred` to migrate to the `@nx/eslint/plugin` inferred targets. See https://nx.dev/docs/guides/tasks--caching/convert-to-inferred for details.
+
+Linting "africanies-theme"...
+
+✔ All files pass linting
+

package/.nx/cache/terminalOutputs/17499961385238663835

@@ -0,0 +1,21 @@
+> nx run africanies-ui:build:production
+
+
+
+------------------------------------------------------------------------------
+Building entry point '@africanies/africanies-ui'
+------------------------------------------------------------------------------
+[?2026h⠋ Compiling with Angular sources in partial compilation mode.[?2026l[?2026h⠙ Compiling with Angular sources in partial compilation mode.[?2026l[?2026h⠙ Compiling with Angular sources in partial compilation mode.[?2026l[?2026h⠹ Compiling with Angular sources in partial compilation mode.[?2026l[?2026h⠸ Compiling with Angular sources in partial compilation mode.[?2026l[?2026h⠼ Compiling with Angular sources in partial compilation mode.[?2026l[?2026h⠴ Compiling with Angular sources in partial compilation mode.[?2026l[?2026h⠦ Compiling with Angular sources in partial compilation mode.[?2026l[?2026h⠧ Compiling with Angular sources in partial compilation mode.[?2026l[?2026h⠇ Compiling with Angular sources in partial compilation mode.[?2026l[?2026h⠏ Compiling with Angular sources in partial compilation mode.[?2026l[?2026h⠋ Compiling with Angular sources in partial compilation mode.[?2026l[?2026h⠙ Compiling with Angular sources in partial compilation mode.[?2026l[?2026h⠹ Compiling with Angular sources in partial compilation mode.[?2026l[?2026h⠸ Compiling with Angular sources in partial compilation mode.[?2026l[?2026h⠼ Compiling with Angular sources in partial compilation mode.[?2026l[?2026h⠼ Compiling with Angular sources in partial compilation mode.[?2026l[?2026h⠴ Compiling with Angular sources in partial compilation mode.[?2026l[?2026h⠦ Compiling with Angular sources in partial compilation mode.[?2026l✔ Compiling with Angular sources in partial compilation mode.
+✔ Generating FESM and DTS bundles
+[?2026h⠋ Copying assets[?2026l✔ Copying assets
+[?2026h⠋ Writing package manifest[?2026l✔ Writing package manifest
+✔ Built @africanies/africanies-ui
+
+------------------------------------------------------------------------------
+Built Angular Package
+- from: /Applications/AngularJS/angular-web-sdk/libs/africanies-ui
+- to:   /Applications/AngularJS/angular-web-sdk/dist/libs/africanies-ui
+------------------------------------------------------------------------------
+
+Build at: 2026-08-28T14:47:31.636Z - Time: 22305ms
+

package/.nx/cache/terminalOutputs/4082520855419352840

@@ -0,0 +1,21 @@
+> nx run africanies-theme:build:production
+
+
+
+------------------------------------------------------------------------------
+Building entry point '@africanies/africanies-theme'
+------------------------------------------------------------------------------
+[?2026h⠋ Compiling with Angular sources in partial compilation mode.[?2026l✔ Compiling with Angular sources in partial compilation mode.
+✔ Generating FESM and DTS bundles
+[?2026h⠋ Copying assets[?2026l✔ Copying assets
+[?2026h⠋ Writing package manifest[?2026l✔ Writing package manifest
+✔ Built @africanies/africanies-theme
+
+------------------------------------------------------------------------------
+Built Angular Package
+- from: /Applications/AngularJS/angular-web-sdk/libs/africanies-theme
+- to:   /Applications/AngularJS/angular-web-sdk/dist/libs/africanies-theme
+------------------------------------------------------------------------------
+
+Build at: 2026-08-28T14:47:06.848Z - Time: 2417ms
+

package/.nx/cache/terminalOutputs/7126777490381568487

@@ -0,0 +1,32 @@
+The `@nx/eslint:lint` executor is deprecated and will be removed in Nx v24. Run `nx g @nx/eslint:convert-to-inferred` to migrate to the `@nx/eslint/plugin` inferred targets. See https://nx.dev/docs/guides/tasks--caching/convert-to-inferred for details.
+
+Linting "africanies-ui"...
+
+/Applications/AngularJS/angular-web-sdk/libs/africanies-ui/src/lib/action-menu/action-menu.component.ts
+  349:3  warning  Missing JSDoc @param "event" declaration  jsdoc/require-param
+  349:3  warning  Missing JSDoc @param "item" declaration   jsdoc/require-param
+
+/Applications/AngularJS/angular-web-sdk/libs/africanies-ui/src/lib/carrier/delivery-vendor-select.ts
+   3:3  warning  'deliveryVendorLabel' is defined but never used  @typescript-eslint/no-unused-vars
+  11:1  warning  Missing JSDoc @returns declaration               jsdoc/require-returns
+  22:1  warning  Missing JSDoc @returns declaration               jsdoc/require-returns
+  38:1  warning  Missing JSDoc @returns declaration               jsdoc/require-returns
+
+/Applications/AngularJS/angular-web-sdk/libs/africanies-ui/src/lib/layout/header-weather.spec.ts
+  150:54  warning  Forbidden non-null assertion  @typescript-eslint/no-non-null-assertion
+  154:28  warning  Forbidden non-null assertion  @typescript-eslint/no-non-null-assertion
+
+/Applications/AngularJS/angular-web-sdk/libs/africanies-ui/src/lib/layout/header-weather.ts
+  212:1  warning  Missing JSDoc @param "fetchFn" declaration  jsdoc/require-param
+  212:1  warning  Missing JSDoc @returns declaration          jsdoc/require-returns
+
+/Applications/AngularJS/angular-web-sdk/libs/africanies-ui/src/lib/table/table.component.ts
+  640:3  warning  Missing JSDoc @returns declaration  jsdoc/require-returns
+
+✖ 11 problems (0 errors, 11 warnings)
+  0 errors and 3 warnings potentially fixable with the `--fix` option.
+
+✖ 11 problems (0 errors, 11 warnings)
+
+  0 errors and 3 warnings are potentially fixable with the `--fix` option.
+