@africanies/angular-web-sdk 0.1.7 → 0.1.8

package/.nx/cache/4082520855419352840/dist/libs/africanies-theme/README.md

@@ -1,46 +0,0 @@
-# @africanies/africanies-theme
-
-AFRICANIES design tokens (Tailwind preset), light/dark {@link ThemeService}, and shipping-mode accent helpers ({@link ModeColorService}).
-
-## Install
-
-```bash
-npm install @africanies/africanies-theme @africanies/africanies-storage @africanies/africanies-core
-```
-
-## Tailwind
-
-```js
-// tailwind.config.js
-module.exports = {
-  presets: [require('@africanies/africanies-theme/tailwind-preset')],
-  content: [
-    './src/**/*.{html,ts}',
-    './node_modules/@africanies/africanies-ui/**/*.{js,mjs}',
-  ],
-};
-```
-
-> The preset file is published as `tailwind-preset.cjs` (package is ESM) but resolved via the `./tailwind-preset` export above.
-
-See [THEME.md](./THEME.md) for the full palette, provisional typography scale, and legacy `$border-gray` mapping notes.
-
-## ThemeService
-
-```ts
-import { inject, provideAppInitializer } from '@angular/core';
-import { ThemeService } from '@africanies/africanies-theme';
-
-provideAppInitializer(() => {
-  inject(ThemeService);
-});
-```
-
-## ModeColorService
-
-```ts
-const modeColor = inject(ModeColorService);
-const { text, bg, bgSubtle } = modeColor.classes();
-```
-
-Class strings are literals so Tailwind does not purge them.

package/.nx/cache/4082520855419352840/dist/libs/africanies-theme/fesm2022/africanies-africanies-theme.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"africanies-africanies-theme.mjs","sources":["../../../../libs/africanies-theme/src/lib/mode-color.safelist.ts","../../../../libs/africanies-theme/src/lib/mode-color.service.ts","../../../../libs/africanies-theme/src/lib/theme.service.ts","../../../../libs/africanies-theme/src/africanies-africanies-theme.ts"],"sourcesContent":["/**\n * Tailwind safelist side-effect for shipping-mode color utilities.\n *\n * WHY this file exists: JIT/content scanning only keeps class names that appear\n * as *literal strings* in scanned sources. {@link ModeColorService} already\n * returns these literals, but keeping a dedicated comment list makes the\n * contract obvious for consumers who configure `safelist` or purge plugins.\n *\n * Do not rename these strings without updating ModeColorService and THEME.md.\n *\n * SFN (export / green):\n * text-export bg-export bg-export-subtle bg-export-light border-export\n * hover:bg-export-light hover:bg-export-subtle dark:bg-export/15 dark:hover:bg-export/15\n * dark:bg-[color-mix(in_srgb,#1cbd5d_15%,#212529)]\n *\n * STN (import / orange):\n * text-import bg-import bg-import-subtle bg-import-light border-import\n * hover:bg-import-light hover:bg-import-subtle dark:bg-import/15 dark:hover:bg-import/15\n * dark:bg-[color-mix(in_srgb,#f08829_15%,#212529)]\n */\nexport const MODE_COLOR_SAFELIST = [\n  'text-export',\n  'bg-export',\n  'bg-export-subtle',\n  'bg-export-light',\n  'border-export',\n  'hover:bg-export-light',\n  'hover:bg-export-subtle',\n  'dark:bg-export/15',\n  'dark:hover:bg-export/15',\n  'dark:bg-[color-mix(in_srgb,#1cbd5d_15%,#212529)]',\n  'text-import',\n  'bg-import',\n  'bg-import-subtle',\n  'bg-import-light',\n  'border-import',\n  'hover:bg-import-light',\n  'hover:bg-import-subtle',\n  'dark:bg-import/15',\n  'dark:hover:bg-import/15',\n  'dark:bg-[color-mix(in_srgb,#f08829_15%,#212529)]',\n] as const;\n","import { computed, inject, Injectable } from '@angular/core';\n\nimport { ShippingModeService } from '@africanies/africanies-core';\n\n/**\n * Tailwind class bundle for the active shipping mode (SFN export / STN import).\n *\n * Use these for **primary** product chrome: CTAs, selected controls, progress,\n * and accent text. Semantic colors (danger / warning) stay mode-independent.\n */\nexport interface ModeColorClasses {\n  /** Text color utility, e.g. `text-export`. */\n  text: string;\n  /** Solid background utility, e.g. `bg-export`. */\n  bg: string;\n  /** Soft background utility, e.g. `bg-export-subtle`. */\n  bgSubtle: string;\n  /** Border matching the mode accent, e.g. `border-export`. */\n  border: string;\n  /**\n   * Filled primary CTA — `variant=\"primary\"` on buttons.\n   * Includes hover utility as a literal so Tailwind keeps it.\n   */\n  primary: string;\n  /**\n   * Transparent / text-only CTA — `variant=\"ghost-primary\"` on buttons.\n   * Mode accent text + soft hover fill.\n   */\n  ghostPrimary: string;\n  /**\n   * Soft highlight for selected / active rows (works in dark mode).\n   * Dark uses a translucent tint — fine over solid surfaces, not for\n   * sticky overlays (see {@link softSolid}).\n   */\n  soft: string;\n  /**\n   * Opaque soft fill — same tint as {@link soft}, but dark mode mixes into\n   * ink so scrolled content cannot show through (sticky table headers/cells).\n   */\n  softSolid: string;\n  /**\n   * Soft hover highlight for menus and lists.\n   */\n  softHover: string;\n}\n\n/**\n * Maps {@link ShippingModeService} to mode-accent Tailwind classes.\n *\n * - **SFN** → export green is primary\n * - **STN** → import orange is primary\n *\n * WHY literal class strings: Tailwind's scanner cannot see dynamically built\n * names like `` `text-${token}` ``. Returning full literals (`text-export`, …)\n * keeps utilities in the compiled CSS. See {@link MODE_COLOR_SAFELIST}.\n *\n * @example\n * ```html\n * @let colors = modeColor.classes();\n * <button type=\"button\" [class]=\"colors.primary\">Save</button>\n * <span [class]=\"colors.text\">Mode accent</span>\n * ```\n */\n@Injectable({ providedIn: 'root' })\nexport class ModeColorService {\n  private readonly shippingMode = inject(ShippingModeService);\n\n  /**\n   * Mode-dependent utility classes. Recomputes when shipping mode changes.\n   */\n  readonly classes = computed<ModeColorClasses>(() => {\n    // Literal strings required for Tailwind content detection — do not interpolate.\n    if (this.shippingMode.mode() === 'sfn') {\n      return {\n        text: 'text-export',\n        bg: 'bg-export',\n        bgSubtle: 'bg-export-subtle',\n        border: 'border-export',\n        primary:\n          'bg-export text-white border-transparent hover:bg-export-light',\n        ghostPrimary:\n          'bg-transparent text-export border-transparent hover:bg-export-subtle dark:hover:bg-export/15',\n        soft: 'bg-export-subtle dark:bg-export/15',\n        softSolid:\n          'bg-export-subtle dark:bg-[color-mix(in_srgb,#1cbd5d_15%,#212529)]',\n        softHover: 'hover:bg-export-subtle dark:hover:bg-export/15',\n      };\n    }\n    return {\n      text: 'text-import',\n      bg: 'bg-import',\n      bgSubtle: 'bg-import-subtle',\n      border: 'border-import',\n      primary:\n        'bg-import text-white border-transparent hover:bg-import-light',\n      ghostPrimary:\n        'bg-transparent text-import border-transparent hover:bg-import-subtle dark:hover:bg-import/15',\n      soft: 'bg-import-subtle dark:bg-import/15',\n      softSolid:\n        'bg-import-subtle dark:bg-[color-mix(in_srgb,#f08829_15%,#212529)]',\n      softHover: 'hover:bg-import-subtle dark:hover:bg-import/15',\n    };\n  });\n}\n","import { DOCUMENT } from '@angular/common';\nimport { inject, Injectable, signal } from '@angular/core';\n\nimport { AFRICANIES_THEME_KEY, STORAGE_TOKEN } from '@africanies/africanies-storage';\n\nimport type { Theme } from './theme.types';\n\n/**\n * Application light/dark theme preference.\n *\n * WHY signals (not BehaviorSubject): theme is synchronous UI state read from\n * templates and other services; a signal avoids RxJS subscription boilerplate\n * and matches Angular 22 change detection. Persistence goes through\n * {@link STORAGE_TOKEN} so tests can swap storage without touching `localStorage`.\n *\n * Applies the Tailwind `darkMode: 'class'` contract by toggling `dark` on\n * `document.documentElement`, and sets `color-scheme` so native UI (date\n * pickers, scrollbars, form controls) matches the app theme — class-based\n * dark mode alone does not restyle browser chrome.\n *\n * @example\n * ```ts\n * // app.config.ts\n * import { inject, provideAppInitializer } from '@angular/core';\n * import { ThemeService } from '@africanies/africanies-theme';\n *\n * export const appConfig = {\n *   providers: [\n *     provideAppInitializer(() => {\n *       inject(ThemeService); // applies stored / system theme once\n *     }),\n *   ],\n * };\n *\n * // In a component\n * const theme = inject(ThemeService);\n * theme.toggle();\n * theme.setTheme('dark');\n * const current = theme.theme(); // 'light' | 'dark'\n * ```\n */\n@Injectable({ providedIn: 'root' })\nexport class ThemeService {\n  private readonly storage = inject(STORAGE_TOKEN);\n  private readonly document = inject(DOCUMENT);\n\n  /**\n   * Current theme. Prefer reading via `theme()` in templates / computed values\n   * rather than caching the string, so dark-class consumers stay in sync.\n   */\n  readonly theme = signal<Theme>(this.resolveInitialTheme());\n\n  constructor() {\n    this.applyToDocument(this.theme());\n  }\n\n  /**\n   * Sets and persists the theme, updating the `dark` class and `color-scheme`\n   * on `<html>`.\n   *\n   * @param theme - Absolute preference to store.\n   */\n  setTheme(theme: Theme): void {\n    this.theme.set(theme);\n    this.applyToDocument(theme);\n    try {\n      this.storage.set(AFRICANIES_THEME_KEY, theme);\n    } catch {\n      // Persistence failure must not block the in-session visual toggle —\n      // private browsing / quota issues are transient for theme preference.\n    }\n  }\n\n  /**\n   * Flips between light and dark.\n   *\n   * @returns The theme after the toggle.\n   */\n  toggle(): Theme {\n    const next: Theme = this.theme() === 'light' ? 'dark' : 'light';\n    this.setTheme(next);\n    return next;\n  }\n\n  private resolveInitialTheme(): Theme {\n    try {\n      const stored = this.storage.get<Theme>(AFRICANIES_THEME_KEY);\n      if (stored === 'light' || stored === 'dark') {\n        return stored;\n      }\n    } catch {\n      // Fall through to system preference when storage is unavailable.\n    }\n    return this.prefersDark() ? 'dark' : 'light';\n  }\n\n  private prefersDark(): boolean {\n    const win = this.document.defaultView;\n    return !!win?.matchMedia?.('(prefers-color-scheme: dark)').matches;\n  }\n\n  private applyToDocument(theme: Theme): void {\n    const root = this.document.documentElement;\n    if (theme === 'dark') {\n      root.classList.add('dark');\n    } else {\n      root.classList.remove('dark');\n    }\n    // Native date/time pickers follow `color-scheme`, not Tailwind's `dark` class.\n    root.style.colorScheme = theme;\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/.nx/cache/4082520855419352840/dist/libs/africanies-theme/package.json

@@ -1,35 +0,0 @@
-{
-  "name": "@africanies/africanies-theme",
-  "version": "0.0.2",
-  "peerDependencies": {
-    "@angular/common": "^22.0.0",
-    "@angular/core": "^22.0.0",
-    "@africanies/africanies-core": ">=0.0.2 <0.1.0",
-    "@africanies/africanies-storage": ">=0.0.1 <0.1.0"
-  },
-  "sideEffects": false,
-  "publishConfig": {
-    "access": "public"
-  },
-  "exports": {
-    "./tailwind-preset": "./tailwind-preset.cjs",
-    "./package.json": {
-      "default": "./package.json"
-    },
-    ".": {
-      "types": "./types/africanies-africanies-theme.d.ts",
-      "default": "./fesm2022/africanies-africanies-theme.mjs"
-    }
-  },
-  "files": [
-    "**/*",
-    "tailwind-preset.cjs",
-    "THEME.md"
-  ],
-  "module": "fesm2022/africanies-africanies-theme.mjs",
-  "typings": "types/africanies-africanies-theme.d.ts",
-  "type": "module",
-  "dependencies": {
-    "tslib": "^2.3.0"
-  }
-}

package/.nx/cache/terminalOutputs/17499961385238663835

@@ -1,21 +0,0 @@
-> 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/3017748574492080228

@@ -1,28 +0,0 @@
-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
-  90:54  warning  Forbidden non-null assertion  @typescript-eslint/no-non-null-assertion
-  94:28  warning  Forbidden non-null assertion  @typescript-eslint/no-non-null-assertion
-
-/Applications/AngularJS/angular-web-sdk/libs/africanies-ui/src/lib/table/table.component.ts
-  637:3  warning  Missing JSDoc @returns declaration  jsdoc/require-returns
-
-✖ 9 problems (0 errors, 9 warnings)
-  0 errors and 2 warnings potentially fixable with the `--fix` option.
-
-✖ 9 problems (0 errors, 9 warnings)
-
-  0 errors and 2 warnings are potentially fixable with the `--fix` option.
-