@africanies/angular-web-sdk 0.1.11 → 0.1.12

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

@@ -1,166 +0,0 @@
-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/6664915487114632770/dist/libs/africanies-icons/README.md

@@ -1,69 +0,0 @@
-# @africanies/africanies-icons
-
-Typed SVG icon system for AFRICANIES apps. Icons ship as a **single sprite** plus an
-`IconName` union — not one Angular component per glyph.
-
-## Why a sprite?
-
-There are 600–1000+ icons in `/svg`. Generating a component (or HTTP request)
-per file would hurt bundle size, compile time, and runtime waterfalls. The build
-script packs every SVG into `icons.sprite.svg`; `IconRegistryService` fetches
-that file **once** and inlines it into the DOM so `<africanies-icon>` can use
-`<use href="#name">`.
-
-## Usage
-
-```ts
-import { AfricaniesIconComponent, AFRICANIES_ICON_SPRITE_URL } from '@africanies/africanies-icons';
-
-// Provide the URL where you serve the published sprite asset:
-providers: [
-  {
-    provide: AFRICANIES_ICON_SPRITE_URL,
-    useValue: '/assets/africanies-icons/icons.sprite.svg',
-  },
-],
-```
-
-```html
-<africanies-icon name="truck" />
-<africanies-icon name="search" [size]="32" />
-```
-
-### Serving the sprite
-
-After installing `@africanies/africanies-icons`, copy (or angular.json `assets` map) the
-published file:
-
-`node_modules/@africanies/africanies-icons/assets/icons.sprite.svg`
-→ `src/assets/africanies-icons/icons.sprite.svg`
-
-Then point {@link AFRICANIES_ICON_SPRITE_URL} at `/assets/africanies-icons/icons.sprite.svg`
-(the package default). Use a leading `/` so the sprite loads on nested routes.
-
-## Adding a new icon
-
-1. Drop a new `.svg` into the monorepo `/svg` folder (kebab-case filename;
-   spaces are normalized to hyphens).
-2. From the repo root run:
-
-```bash
-npm run icons:build
-```
-
-3. Commit the regenerated files:
-   - `libs/africanies-icons/src/assets/icons.sprite.svg`
-   - `libs/africanies-icons/src/lib/icon-name.ts` (`ICON_NAMES` + `IconName`)
-
-The new name appears in `ICON_NAMES` / `IconName` for autocomplete, type-checking,
-and the playground gallery.
-
-## Public API
-
-| Export | Role |
-| --- | --- |
-| `ICON_NAMES` | Generated `as const` array of every icon id (for galleries / iteration) |
-| `IconName` | `typeof ICON_NAMES[number]` — closed union for typed `name` inputs |
-| `AfricaniesIconComponent` | `<africanies-icon name="…">` |
-| `IconRegistryService` | Fetches/inlines the sprite once |
-| `AFRICANIES_ICON_SPRITE_URL` | InjectionToken for the sprite URL |