@mohamedatia/fly-design-system 1.0.0 → 1.3.1

package/fesm2022/mohamedatia-fly-design-system.mjs

@@ -1,21 +1,317 @@
-import { InjectionToken } from '@angular/core';
+import * as i0 from '@angular/core';
+import { InjectionToken, signal, computed, Injectable, inject, ErrorHandler, Pipe } from '@angular/core';
 
 const WINDOW_DATA = new InjectionToken('WINDOW_DATA');
 
+/**
+ * Shared AuthService for Business Apps.
+ *
+ * This is a **read-only signal store** — Business Apps inject it to read the
+ * current user and access token. The FlyOS shell populates it after PKCE login
+ * and silent refresh. Business Apps must never call setSession() directly.
+ *
+ * When running as a Module Federation remote, the shell and the Business App
+ * share this singleton via the `@mohamedatia/fly-design-system` shared mapping
+ * in federation.config.js — so the shell's populated instance is the same
+ * object the Business App reads.
+ *
+ * When running standalone (without the shell), call initFromToken() with a
+ * JWT stored in localStorage to hydrate the user.
+ */
+class AuthService {
+    _session = signal(null, ...(ngDevMode ? [{ debugName: "_session" }] : /* istanbul ignore next */ []));
+    currentUser = computed(() => this._session()?.user ?? null, ...(ngDevMode ? [{ debugName: "currentUser" }] : /* istanbul ignore next */ []));
+    accessToken = computed(() => this._session()?.accessToken ?? null, ...(ngDevMode ? [{ debugName: "accessToken" }] : /* istanbul ignore next */ []));
+    isAuthenticated = computed(() => {
+        const s = this._session();
+        return s !== null && s.expiresAt > Date.now();
+    }, ...(ngDevMode ? [{ debugName: "isAuthenticated" }] : /* istanbul ignore next */ []));
+    /**
+     * Called by the shell after a successful login or silent refresh.
+     * Business Apps should not call this directly.
+     */
+    setSession(user, accessToken, expiresAt) {
+        this._session.set({ user, accessToken, expiresAt });
+    }
+    /** Clears the in-memory session (called by the shell on logout). */
+    clearSession() {
+        this._session.set(null);
+    }
+    /**
+     * Standalone mode: parse a JWT from localStorage and hydrate the user.
+     * Key defaults to "circles_token" but can be overridden.
+     */
+    initFromToken(storageKey = 'circles_token') {
+        const token = localStorage.getItem(storageKey);
+        if (!token)
+            return;
+        try {
+            const base64 = token.split('.')[1].replace(/-/g, '+').replace(/_/g, '/');
+            const payload = JSON.parse(decodeURIComponent(atob(base64).split('').map(c => '%' + ('00' + c.charCodeAt(0).toString(16)).slice(-2)).join('')));
+            const rawRole = payload['role'];
+            const roles = Array.isArray(rawRole) ? rawRole : rawRole ? [rawRole] : [];
+            const rawApps = payload['apps'];
+            const apps = Array.isArray(rawApps) ? rawApps : rawApps ? [rawApps] : [];
+            const name = payload['name'] ?? '';
+            const nameParts = name.split(' ');
+            const user = {
+                id: payload['sub'] ?? '',
+                tenantId: payload['tenant_id'] ?? payload['tid'] ?? null,
+                email: payload['email'] ?? '',
+                fullName: name,
+                firstName: nameParts[0] ?? '',
+                lastName: nameParts.slice(1).join(' '),
+                preferredLocale: payload['locale'] ?? 'en',
+                roles,
+                apps,
+                ou: payload['ou'],
+            };
+            const expiresAt = (payload['exp'] ?? 0) * 1000;
+            this.setSession(user, token, expiresAt);
+        }
+        catch {
+            // Invalid token — stay unauthenticated
+        }
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.5", ngImport: i0, type: AuthService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.5", ngImport: i0, type: AuthService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.5", ngImport: i0, type: AuthService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+/** Locales that use RTL layout for `dir` and DS `isRtl` / `direction`. */
+const RTL_LOCALE_SET = new Set(['ar', 'ur']);
+function isRtlLocale(lang) {
+    return RTL_LOCALE_SET.has(lang);
+}
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/** Accepts flat or nested JSON objects; nested keys become dot paths. Rejects arrays and non-string leaves. */
+function normalizeLocaleJson(raw) {
+    if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
+        throw new Error('Locale bundle must be a JSON object');
+    }
+    const out = {};
+    const walk = (obj, prefix) => {
+        for (const [k, v] of Object.entries(obj)) {
+            const path = prefix ? `${prefix}.${k}` : k;
+            if (typeof v === 'string') {
+                out[path] = v;
+            }
+            else if (v !== null && typeof v === 'object' && !Array.isArray(v)) {
+                walk(v, path);
+            }
+            else {
+                throw new Error(`Locale bundle invalid value at "${path}" (expected string or nested object)`);
+            }
+        }
+    };
+    walk(raw, '');
+    return out;
+}
+/**
+ * Shared I18nService for the shell and Business Apps.
+ *
+ * **Merge order** (later keys win): shell layer → remote bundles in registration order.
+ *
+ * - Shell: `setShellTranslations()` after loading `locale/{lang}.json` and API overrides.
+ * - Remotes: `loadBundle()` per manifest `localeBaseUrl`.
+ */
+class I18nService {
+    errorHandler = inject(ErrorHandler, { optional: true });
+    _shell = signal({}, ...(ngDevMode ? [{ debugName: "_shell" }] : /* istanbul ignore next */ []));
+    _bundles = signal({}, ...(ngDevMode ? [{ debugName: "_bundles" }] : /* istanbul ignore next */ []));
+    _bundleOrder = signal([], ...(ngDevMode ? [{ debugName: "_bundleOrder" }] : /* istanbul ignore next */ []));
+    _locale = signal('en', ...(ngDevMode ? [{ debugName: "_locale" }] : /* istanbul ignore next */ []));
+    _version = signal(0, ...(ngDevMode ? [{ debugName: "_version" }] : /* istanbul ignore next */ []));
+    _merged = computed(() => {
+        const shell = this._shell();
+        const order = this._bundleOrder();
+        const bundles = this._bundles();
+        let out = { ...shell };
+        for (const id of order) {
+            const b = bundles[id];
+            if (b)
+                out = { ...out, ...b };
+        }
+        return out;
+    }, ...(ngDevMode ? [{ debugName: "_merged" }] : /* istanbul ignore next */ []));
+    locale = this._locale.asReadonly();
+    version = this._version.asReadonly();
+    isRtl = computed(() => isRtlLocale(this._locale()), ...(ngDevMode ? [{ debugName: "isRtl" }] : /* istanbul ignore next */ []));
+    direction = computed(() => (isRtlLocale(this._locale()) ? 'rtl' : 'ltr'), ...(ngDevMode ? [{ debugName: "direction" }] : /* istanbul ignore next */ []));
+    bump() {
+        this._version.update((v) => v + 1);
+    }
+    /** Replace shell strings (desktop `locale/*.json` + `/api/i18n/desktop-shell/{lang}` merged by the shell). */
+    setShellTranslations(data, lang) {
+        this._shell.set(data);
+        this._locale.set(lang);
+        this.bump();
+    }
+    setLanguage(lang) {
+        this._locale.set(lang);
+        this.bump();
+    }
+    /**
+     * Fetch `{baseUrl}{lang}.json` and store under `id`. New ids are appended to the merge order.
+     */
+    async loadBundle(opts) {
+        const { id, baseUrl, lang, signal: abortSignal } = opts;
+        try {
+            const base = baseUrl.endsWith('/') ? baseUrl : `${baseUrl}/`;
+            const url = `${base}${lang}.json`;
+            const resp = await fetch(url, { signal: abortSignal });
+            if (!resp.ok)
+                throw new Error(`HTTP ${resp.status}`);
+            const data = normalizeLocaleJson(await resp.json());
+            if (abortSignal?.aborted)
+                return;
+            this._bundles.update((b) => ({ ...b, [id]: data }));
+            this._bundleOrder.update((order) => (order.includes(id) ? order : [...order, id]));
+            this._locale.set(lang);
+            this.bump();
+        }
+        catch (e) {
+            if (abortSignal?.aborted)
+                return;
+            this.errorHandler?.handleError(e);
+        }
+    }
+    removeBundle(id) {
+        this._bundles.update((b) => {
+            const next = { ...b };
+            delete next[id];
+            return next;
+        });
+        this._bundleOrder.update((order) => order.filter((x) => x !== id));
+        this.bump();
+    }
+    clearRemoteBundles() {
+        this._bundles.set({});
+        this._bundleOrder.set([]);
+        this.bump();
+    }
+    t(key, params) {
+        const val = this._merged()[key] ?? key;
+        if (!params)
+            return val;
+        return Object.entries(params).reduce((result, [k, v]) => {
+            const safe = escapeRegExp(k);
+            return result.replace(new RegExp(`{{\\s*${safe}\\s*}}`, 'g'), String(v));
+        }, val);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.5", ngImport: i0, type: I18nService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.5", ngImport: i0, type: I18nService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.5", ngImport: i0, type: I18nService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+/**
+ * Applies `html.light-theme` / `html.dark-theme` / `html.transparent-theme` for DS SCSS.
+ * Shell and standalone Business Apps use the same service (federation singleton when shared).
+ */
+class FlyThemeService {
+    theme = signal('light', ...(ngDevMode ? [{ debugName: "theme" }] : /* istanbul ignore next */ []));
+    applyTheme(mode) {
+        this.theme.set(mode);
+        const html = document.documentElement;
+        html.classList.remove('dark-theme', 'light-theme', 'transparent-theme');
+        if (mode === 'dark') {
+            html.classList.add('dark-theme');
+        }
+        else if (mode === 'transparent') {
+            html.classList.add('transparent-theme');
+        }
+        else {
+            html.classList.add('light-theme');
+        }
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.5", ngImport: i0, type: FlyThemeService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.5", ngImport: i0, type: FlyThemeService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.5", ngImport: i0, type: FlyThemeService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+/**
+ * Abstract interface for the WindowManager.
+ * The FlyOS shell provides the concrete implementation; Business Apps
+ * inject this token to open, close, and focus windows without depending
+ * on the shell's internal implementation.
+ */
+class WindowManagerService {
+}
+/**
+ * No-op fallback implementation used when running a Business App in
+ * standalone mode (outside the FlyOS shell). Logs a warning instead of
+ * throwing so standalone dev/test flows are not broken.
+ */
+class StandaloneWindowManagerService extends WindowManagerService {
+    openChildWindow(options) {
+        console.warn('[WindowManagerService] openChildWindow called in standalone mode — no shell available.', options);
+    }
+    closeWindow(windowId) {
+        console.warn('[WindowManagerService] closeWindow called in standalone mode — no shell available.', windowId);
+    }
+    focusWindow(windowId) {
+        console.warn('[WindowManagerService] focusWindow called in standalone mode — no shell available.', windowId);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.5", ngImport: i0, type: StandaloneWindowManagerService, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.5", ngImport: i0, type: StandaloneWindowManagerService });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.5", ngImport: i0, type: StandaloneWindowManagerService, decorators: [{
+            type: Injectable
+        }] });
+
+/**
+ * Translates a key using the shared I18nService.
+ *
+ * @example
+ * {{ 'circles.signals.title' | translate }}
+ * {{ 'circles.items_count' | translate:{ n: count() } }}
+ */
+class TranslatePipe {
+    i18n = inject(I18nService);
+    transform(key, params) {
+        return this.i18n.t(key, params);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.5", ngImport: i0, type: TranslatePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "21.2.5", ngImport: i0, type: TranslatePipe, isStandalone: true, name: "translate", pure: false });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.5", ngImport: i0, type: TranslatePipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'translate',
+                    standalone: true,
+                    pure: false,
+                }]
+        }] });
+
 /*
- * @fly/design-system — Public API
+ * @mohamedatia/fly-design-system — Public API
+ * https://www.npmjs.com/package/@mohamedatia/fly-design-system
  *
  * This is the single entry point for Business App developers.
- * Import everything from '@fly/design-system' — never from relative shell paths.
+ * Import everything from '@mohamedatia/fly-design-system' — never from relative shell paths.
+ *
+ * NOTE: This package is published under @mohamedatia/fly-design-system until the @fly
+ * npm org is created. It will be republished as @fly/design-system once available.
  *
- * v1.0.0 exports the core models and tokens needed to integrate with the
- * FlyOS desktop shell. Components, directives, and pipes will be added in
- * subsequent releases as they are extracted from the shell.
+ * v1.3.0: FlyThemeService (html theme classes), hardened I18nService (AbortSignal, ErrorHandler, RTL helpers).
+ * v1.3.1: loadBundle normalizes locale JSON (flat or nested objects; rejects invalid leaves).
+ * See BusinessAppsGuide/03-frontend-app.md.
  */
 
 /**
  * Generated bundle index. Do not edit.
  */
 
-export { WINDOW_DATA };
+export { AuthService, FlyThemeService, I18nService, RTL_LOCALE_SET, StandaloneWindowManagerService, TranslatePipe, WINDOW_DATA, WindowManagerService, isRtlLocale };
 //# sourceMappingURL=mohamedatia-fly-design-system.mjs.map

package/fesm2022/mohamedatia-fly-design-system.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mohamedatia-fly-design-system.mjs","sources":["../../../projects/design-system/src/lib/models/window.model.ts","../../../projects/design-system/src/public-api.ts","../../../projects/design-system/src/mohamedatia-fly-design-system.ts"],"sourcesContent":["import { InjectionToken, Type } from '@angular/core';\r\n\r\nexport type WindowState = 'normal' | 'minimized' | 'maximized';\r\n\r\nexport interface ChildWindowData {\r\n  childComponent: Type<unknown>;\r\n  [key: string]: unknown;\r\n}\r\n\r\nexport interface WindowInstance {\r\n  id: string;\r\n  appId: string;\r\n  title: string;\r\n  icon: string;\r\n  iconBg: string;\r\n  state: WindowState;\r\n  position: { x: number; y: number };\r\n  size: { width: number; height: number };\r\n  zIndex: number;\r\n  isFocused: boolean;\r\n  isClosing?: boolean;\r\n  isMinimizing?: boolean;\r\n  isRestoring?: boolean;\r\n  isMaximizing?: boolean;\r\n  isUnmaximizing?: boolean;\r\n  parentWindowId?: string;\r\n  childData?: ChildWindowData;\r\n}\r\n\r\nexport const WINDOW_DATA = new InjectionToken<WindowInstance>('WINDOW_DATA');\r\n","/*\r\n * @fly/design-system — Public API\r\n *\r\n * This is the single entry point for Business App developers.\r\n * Import everything from '@fly/design-system' — never from relative shell paths.\r\n *\r\n * v1.0.0 exports the core models and tokens needed to integrate with the\r\n * FlyOS desktop shell. Components, directives, and pipes will be added in\r\n * subsequent releases as they are extracted from the shell.\r\n */\r\n\r\n// ─── Models ──────────────────────────────────────────────────────────────────\r\nexport type { DesktopApp } from './lib/models/app.model';\r\nexport type {\r\n  WindowInstance,\r\n  WindowState,\r\n  ChildWindowData,\r\n} from './lib/models/window.model';\r\nexport { WINDOW_DATA } from './lib/models/window.model';\r\n\r\n// ─── Remote App Registration ─────────────────────────────────────────────────\r\nexport type { RemoteAppDef } from './lib/models/remote-app.model';\r\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;MA6Ba,WAAW,GAAG,IAAI,cAAc,CAAiB,aAAa;;AC7B3E;;;;;;;;;AASG;;ACTH;;AAEG;;;;"}
+{"version":3,"file":"mohamedatia-fly-design-system.mjs","sources":["../../../projects/design-system/src/lib/models/window.model.ts","../../../projects/design-system/src/lib/services/auth.service.ts","../../../projects/design-system/src/lib/services/i18n.service.ts","../../../projects/design-system/src/lib/services/fly-theme.service.ts","../../../projects/design-system/src/lib/services/window-manager.service.ts","../../../projects/design-system/src/lib/pipes/translate.pipe.ts","../../../projects/design-system/src/public-api.ts","../../../projects/design-system/src/mohamedatia-fly-design-system.ts"],"sourcesContent":["import { InjectionToken, Type } from '@angular/core';\r\n\r\nexport type WindowState = 'normal' | 'minimized' | 'maximized';\r\n\r\nexport interface ChildWindowData {\r\n  childComponent: Type<unknown>;\r\n  [key: string]: unknown;\r\n}\r\n\r\nexport interface WindowInstance {\r\n  id: string;\r\n  appId: string;\r\n  title: string;\r\n  icon: string;\r\n  iconBg: string;\r\n  state: WindowState;\r\n  position: { x: number; y: number };\r\n  size: { width: number; height: number };\r\n  zIndex: number;\r\n  isFocused: boolean;\r\n  isClosing?: boolean;\r\n  isMinimizing?: boolean;\r\n  isRestoring?: boolean;\r\n  isMaximizing?: boolean;\r\n  isUnmaximizing?: boolean;\r\n  parentWindowId?: string;\r\n  childData?: ChildWindowData;\r\n  /** Populated when remote `loadComponent()` fails (e.g. federation). */\r\n  remoteLoadError?: string;\r\n}\r\n\r\nexport const WINDOW_DATA = new InjectionToken<WindowInstance>('WINDOW_DATA');\r\n","import { Injectable, computed, signal } from '@angular/core';\nimport { User } from '../models/user.model';\n\ninterface AuthSession {\n  user: User;\n  accessToken: string;\n  expiresAt: number;\n}\n\n/**\n * Shared AuthService for Business Apps.\n *\n * This is a **read-only signal store** — Business Apps inject it to read the\n * current user and access token. The FlyOS shell populates it after PKCE login\n * and silent refresh. Business Apps must never call setSession() directly.\n *\n * When running as a Module Federation remote, the shell and the Business App\n * share this singleton via the `@mohamedatia/fly-design-system` shared mapping\n * in federation.config.js — so the shell's populated instance is the same\n * object the Business App reads.\n *\n * When running standalone (without the shell), call initFromToken() with a\n * JWT stored in localStorage to hydrate the user.\n */\n@Injectable({ providedIn: 'root' })\nexport class AuthService {\n  private _session = signal<AuthSession | null>(null);\n\n  readonly currentUser = computed(() => this._session()?.user ?? null);\n  readonly accessToken = computed(() => this._session()?.accessToken ?? null);\n  readonly isAuthenticated = computed(() => {\n    const s = this._session();\n    return s !== null && s.expiresAt > Date.now();\n  });\n\n  /**\n   * Called by the shell after a successful login or silent refresh.\n   * Business Apps should not call this directly.\n   */\n  setSession(user: User, accessToken: string, expiresAt: number): void {\n    this._session.set({ user, accessToken, expiresAt });\n  }\n\n  /** Clears the in-memory session (called by the shell on logout). */\n  clearSession(): void {\n    this._session.set(null);\n  }\n\n  /**\n   * Standalone mode: parse a JWT from localStorage and hydrate the user.\n   * Key defaults to \"circles_token\" but can be overridden.\n   */\n  initFromToken(storageKey = 'circles_token'): void {\n    const token = localStorage.getItem(storageKey);\n    if (!token) return;\n    try {\n      const base64 = token.split('.')[1].replace(/-/g, '+').replace(/_/g, '/');\n      const payload = JSON.parse(decodeURIComponent(\n        atob(base64).split('').map(c => '%' + ('00' + c.charCodeAt(0).toString(16)).slice(-2)).join('')\n      )) as Record<string, unknown>;\n\n      const rawRole = payload['role'];\n      const roles = Array.isArray(rawRole) ? rawRole as string[] : rawRole ? [rawRole as string] : [];\n      const rawApps = payload['apps'];\n      const apps = Array.isArray(rawApps) ? rawApps as string[] : rawApps ? [rawApps as string] : [];\n      const name = (payload['name'] as string) ?? '';\n      const nameParts = name.split(' ');\n\n      const user: User = {\n        id:              (payload['sub'] as string) ?? '',\n        tenantId:        (payload['tenant_id'] as string) ?? (payload['tid'] as string) ?? null,\n        email:           (payload['email'] as string) ?? '',\n        fullName:        name,\n        firstName:       nameParts[0] ?? '',\n        lastName:        nameParts.slice(1).join(' '),\n        preferredLocale: (payload['locale'] as string) ?? 'en',\n        roles,\n        apps,\n        ou:              payload['ou'] as string | undefined,\n      };\n\n      const expiresAt = ((payload['exp'] as number) ?? 0) * 1000;\n      this.setSession(user, token, expiresAt);\n    } catch {\n      // Invalid token — stay unauthenticated\n    }\n  }\n}\n","import { Injectable, computed, signal, inject, ErrorHandler } from '@angular/core';\n\n/** Locales that use RTL layout for `dir` and DS `isRtl` / `direction`. */\nexport const RTL_LOCALE_SET: ReadonlySet<string> = new Set(['ar', 'ur']);\n\nexport function isRtlLocale(lang: string): boolean {\n  return RTL_LOCALE_SET.has(lang);\n}\n\nfunction escapeRegExp(s: string): string {\n  return s.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\n/** Accepts flat or nested JSON objects; nested keys become dot paths. Rejects arrays and non-string leaves. */\nfunction normalizeLocaleJson(raw: unknown): Record<string, string> {\n  if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {\n    throw new Error('Locale bundle must be a JSON object');\n  }\n  const out: Record<string, string> = {};\n  const walk = (obj: Record<string, unknown>, prefix: string): void => {\n    for (const [k, v] of Object.entries(obj)) {\n      const path = prefix ? `${prefix}.${k}` : k;\n      if (typeof v === 'string') {\n        out[path] = v;\n      } else if (v !== null && typeof v === 'object' && !Array.isArray(v)) {\n        walk(v as Record<string, unknown>, path);\n      } else {\n        throw new Error(`Locale bundle invalid value at \"${path}\" (expected string or nested object)`);\n      }\n    }\n  };\n  walk(raw as Record<string, unknown>, '');\n  return out;\n}\n\n/** Options for loading a remote or standalone locale JSON bundle. */\nexport interface LoadBundleOptions {\n  /** Stable id (e.g. app id from manifest); later loads replace this bundle only. */\n  id: string;\n  /** Base URL ending with `/`, e.g. `https://app.example.com/locale/` or `/circles-dev/locale/` */\n  baseUrl: string;\n  lang: string;\n  /** When aborted, failures are ignored (e.g. superseded language load). */\n  signal?: AbortSignal;\n}\n\n/**\n * Shared I18nService for the shell and Business Apps.\n *\n * **Merge order** (later keys win): shell layer → remote bundles in registration order.\n *\n * - Shell: `setShellTranslations()` after loading `locale/{lang}.json` and API overrides.\n * - Remotes: `loadBundle()` per manifest `localeBaseUrl`.\n */\n@Injectable({ providedIn: 'root' })\nexport class I18nService {\n  private readonly errorHandler = inject(ErrorHandler, { optional: true });\n\n  private readonly _shell = signal<Record<string, string>>({});\n  private readonly _bundles = signal<Record<string, Record<string, string>>>({});\n  private readonly _bundleOrder = signal<string[]>([]);\n  private readonly _locale = signal<string>('en');\n  private readonly _version = signal(0);\n\n  private readonly _merged = computed(() => {\n    const shell = this._shell();\n    const order = this._bundleOrder();\n    const bundles = this._bundles();\n    let out: Record<string, string> = { ...shell };\n    for (const id of order) {\n      const b = bundles[id];\n      if (b) out = { ...out, ...b };\n    }\n    return out;\n  });\n\n  readonly locale = this._locale.asReadonly();\n  readonly version = this._version.asReadonly();\n  readonly isRtl = computed(() => isRtlLocale(this._locale()));\n  readonly direction = computed(() => (isRtlLocale(this._locale()) ? 'rtl' : 'ltr'));\n\n  private bump(): void {\n    this._version.update((v) => v + 1);\n  }\n\n  /** Replace shell strings (desktop `locale/*.json` + `/api/i18n/desktop-shell/{lang}` merged by the shell). */\n  setShellTranslations(data: Record<string, string>, lang: string): void {\n    this._shell.set(data);\n    this._locale.set(lang);\n    this.bump();\n  }\n\n  setLanguage(lang: string): void {\n    this._locale.set(lang);\n    this.bump();\n  }\n\n  /**\n   * Fetch `{baseUrl}{lang}.json` and store under `id`. New ids are appended to the merge order.\n   */\n  async loadBundle(opts: LoadBundleOptions): Promise<void> {\n    const { id, baseUrl, lang, signal: abortSignal } = opts;\n    try {\n      const base = baseUrl.endsWith('/') ? baseUrl : `${baseUrl}/`;\n      const url = `${base}${lang}.json`;\n      const resp = await fetch(url, { signal: abortSignal });\n      if (!resp.ok) throw new Error(`HTTP ${resp.status}`);\n      const data = normalizeLocaleJson(await resp.json());\n      if (abortSignal?.aborted) return;\n      this._bundles.update((b) => ({ ...b, [id]: data }));\n      this._bundleOrder.update((order) => (order.includes(id) ? order : [...order, id]));\n      this._locale.set(lang);\n      this.bump();\n    } catch (e) {\n      if (abortSignal?.aborted) return;\n      this.errorHandler?.handleError(e);\n    }\n  }\n\n  removeBundle(id: string): void {\n    this._bundles.update((b) => {\n      const next = { ...b };\n      delete next[id];\n      return next;\n    });\n    this._bundleOrder.update((order) => order.filter((x) => x !== id));\n    this.bump();\n  }\n\n  clearRemoteBundles(): void {\n    this._bundles.set({});\n    this._bundleOrder.set([]);\n    this.bump();\n  }\n\n  t(key: string, params?: Record<string, string | number>): string {\n    const val = this._merged()[key] ?? key;\n    if (!params) return val;\n    return Object.entries(params).reduce((result, [k, v]) => {\n      const safe = escapeRegExp(k);\n      return result.replace(new RegExp(`{{\\\\s*${safe}\\\\s*}}`, 'g'), String(v));\n    }, val);\n  }\n}\n","import { Injectable, signal } from '@angular/core';\n\nexport type FlyThemeMode = 'light' | 'dark' | 'transparent';\n\n/**\n * Applies `html.light-theme` / `html.dark-theme` / `html.transparent-theme` for DS SCSS.\n * Shell and standalone Business Apps use the same service (federation singleton when shared).\n */\n@Injectable({ providedIn: 'root' })\nexport class FlyThemeService {\n  readonly theme = signal<FlyThemeMode>('light');\n\n  applyTheme(mode: FlyThemeMode): void {\n    this.theme.set(mode);\n    const html = document.documentElement;\n    html.classList.remove('dark-theme', 'light-theme', 'transparent-theme');\n    if (mode === 'dark') {\n      html.classList.add('dark-theme');\n    } else if (mode === 'transparent') {\n      html.classList.add('transparent-theme');\n    } else {\n      html.classList.add('light-theme');\n    }\n  }\n}\n","import { Injectable } from '@angular/core';\n\n/** Options for opening a child window. */\nexport interface OpenWindowOptions {\n  /** Unique identifier for the window instance. */\n  windowId: string;\n  /** Display title shown in the window chrome. */\n  title: string;\n  /** Route path or URL to load inside the window. */\n  route: string;\n  /** Initial width in pixels. Defaults to 900. */\n  width?: number;\n  /** Initial height in pixels. Defaults to 600. */\n  height?: number;\n  /** Whether the window can be resized. Defaults to true. */\n  resizable?: boolean;\n  /** Whether the window can be maximised. Defaults to true. */\n  maximizable?: boolean;\n  /** Arbitrary data passed to the child window via WINDOW_DATA. */\n  data?: unknown;\n}\n\n/**\n * Abstract interface for the WindowManager.\n * The FlyOS shell provides the concrete implementation; Business Apps\n * inject this token to open, close, and focus windows without depending\n * on the shell's internal implementation.\n */\nexport abstract class WindowManagerService {\n  abstract openChildWindow(options: OpenWindowOptions): void;\n  abstract closeWindow(windowId: string): void;\n  abstract focusWindow(windowId: string): void;\n}\n\n/**\n * No-op fallback implementation used when running a Business App in\n * standalone mode (outside the FlyOS shell). Logs a warning instead of\n * throwing so standalone dev/test flows are not broken.\n */\n@Injectable()\nexport class StandaloneWindowManagerService extends WindowManagerService {\n  openChildWindow(options: OpenWindowOptions): void {\n    console.warn('[WindowManagerService] openChildWindow called in standalone mode — no shell available.', options);\n  }\n\n  closeWindow(windowId: string): void {\n    console.warn('[WindowManagerService] closeWindow called in standalone mode — no shell available.', windowId);\n  }\n\n  focusWindow(windowId: string): void {\n    console.warn('[WindowManagerService] focusWindow called in standalone mode — no shell available.', windowId);\n  }\n}\n\n","import { Pipe, PipeTransform, inject } from '@angular/core';\nimport { I18nService } from '../services/i18n.service';\n\n/**\n * Translates a key using the shared I18nService.\n *\n * @example\n * {{ 'circles.signals.title' | translate }}\n * {{ 'circles.items_count' | translate:{ n: count() } }}\n */\n@Pipe({\n  name: 'translate',\n  standalone: true,\n  pure: false,\n})\nexport class TranslatePipe implements PipeTransform {\n  private readonly i18n = inject(I18nService);\n\n  transform(key: string, params?: Record<string, string | number>): string {\n    return this.i18n.t(key, params);\n  }\n}\n","/*\r\n * @mohamedatia/fly-design-system — Public API\r\n * https://www.npmjs.com/package/@mohamedatia/fly-design-system\r\n *\r\n * This is the single entry point for Business App developers.\r\n * Import everything from '@mohamedatia/fly-design-system' — never from relative shell paths.\r\n *\r\n * NOTE: This package is published under @mohamedatia/fly-design-system until the @fly\r\n * npm org is created. It will be republished as @fly/design-system once available.\r\n *\r\n * v1.3.0: FlyThemeService (html theme classes), hardened I18nService (AbortSignal, ErrorHandler, RTL helpers).\r\n * v1.3.1: loadBundle normalizes locale JSON (flat or nested objects; rejects invalid leaves).\r\n * See BusinessAppsGuide/03-frontend-app.md.\r\n */\r\n\r\n// ─── Models ──────────────────────────────────────────────────────────────────\r\nexport type { DesktopApp } from './lib/models/app.model';\r\nexport type {\r\n  WindowInstance,\r\n  WindowState,\r\n  ChildWindowData,\r\n} from './lib/models/window.model';\r\nexport { WINDOW_DATA } from './lib/models/window.model';\r\nexport type { User } from './lib/models/user.model';\r\n\r\n// ─── Remote App Registration ─────────────────────────────────────────────────\r\nexport type { RemoteAppDef } from './lib/models/remote-app.model';\r\n\r\n// ─── Services ────────────────────────────────────────────────────────────────\r\nexport { AuthService } from './lib/services/auth.service';\r\nexport type { LoadBundleOptions } from './lib/services/i18n.service';\r\nexport { I18nService, RTL_LOCALE_SET, isRtlLocale } from './lib/services/i18n.service';\r\nexport { FlyThemeService, type FlyThemeMode } from './lib/services/fly-theme.service';\r\nexport {\r\n  WindowManagerService,\r\n  StandaloneWindowManagerService,\r\n  type OpenWindowOptions,\r\n} from './lib/services/window-manager.service';\r\n\r\n// ─── Pipes ───────────────────────────────────────────────────────────────────\r\nexport { TranslatePipe } from './lib/pipes/translate.pipe';\r\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mohamedatia/fly-design-system",
-  "version": "1.0.0",
+  "version": "1.3.1",
   "description": "FlyOS design system — shared components, directives, pipes, services, and models for Business App developers.",
   "keywords": [
     "flyos",

package/scss/_fly-theme.scss

@@ -0,0 +1,9 @@
+// Entry: tokens + html.light-theme / .dark-theme / .transparent-theme + OS auto dark.
+// Use from shell or Business Apps:
+//   stylePreprocessorOptions.includePaths → design-system src folder
+//   @use 'scss/fly-theme' or @use 'fly-theme' when scss is on the path.
+@use 'tokens';
+@use 'theme-light';
+@use 'theme-dark';
+@use 'theme-transparent';
+@use 'theme-auto';

package/scss/_theme-auto.scss

@@ -0,0 +1,8 @@
+@use 'theme-dark-vars' as *;
+
+// ─── Automatic dark mode via OS preference (when user hasn't chosen) ─────────
+@media (prefers-color-scheme: dark) {
+  html:not(.light-theme):not(.dark-theme):not(.transparent-theme) {
+    @include dark-theme-vars;
+  }
+}

package/scss/_theme-dark-vars.scss

@@ -0,0 +1,38 @@
+// ─── Dark Theme Variables (shared mixin to avoid duplication) ────────────────
+@mixin dark-theme-vars {
+  --primary-light: rgba(232, 115, 42, 0.18);
+
+  --surface-ground: #0e0e10;
+  --surface-section: rgba(28, 28, 30, 0.85);
+  --surface-card: rgba(28, 28, 30, 0.7);
+  --surface-border: rgba(255, 255, 255, 0.1);
+  --surface-hover: rgba(255, 255, 255, 0.08);
+  --text-color: #f2f2f7;
+  --text-color-secondary: rgba(242, 242, 247, 0.65);
+
+  --glass-bg: rgba(25, 25, 28, 0.72);
+  --glass-bg-elevated: rgba(38, 38, 42, 0.82);
+  --glass-border: rgba(255, 255, 255, 0.12);
+  --glass-shadow: 0 8px 40px rgba(0, 0, 0, 0.35);
+  --glass-inner-glow: inset 0 1px 0 rgba(255, 255, 255, 0.08);
+
+  --window-bg: rgba(22, 22, 24, 0.55);
+  --window-radius: 46px;
+  --window-shadow: 0 24px 80px rgba(0, 0, 0, 0.4);
+  --window-border: rgba(255, 255, 255, 0.12);
+
+  --titlebar-bg: transparent;
+
+  --dock-bg: rgba(20, 20, 22, 0.55);
+  --dock-border: rgba(255, 255, 255, 0.12);
+  --dock-blur: 50px;
+
+  --menubar-bg: rgba(14, 14, 16, 0.6);
+  --menubar-border: rgba(255, 255, 255, 0.06);
+  --menubar-text: rgba(242, 242, 247, 1);
+
+  --sidebar-bg: rgba(20, 20, 22, 0.6);
+  --sidebar-border: rgba(255, 255, 255, 0.08);
+
+  --focus-ring: rgba(232, 115, 42, 0.6);
+}

package/scss/_theme-dark.scss

@@ -0,0 +1,6 @@
+@use 'theme-dark-vars' as *;
+
+// ─── Dark Theme — applied to <html> via FlyThemeService (shell or standalone) ─
+html.dark-theme {
+  @include dark-theme-vars;
+}

package/scss/_theme-light.scss

@@ -0,0 +1,61 @@
+// ─── Light Theme (default) ───────────────────────────────────────────────────
+:root,
+html.light-theme {
+  --primary-color: #E8732A;
+  --primary-hover: #D4631E;
+  --primary-light: rgba(232, 115, 42, 0.12);
+
+  --accent-green: var(--system-green);
+  --accent-red: var(--system-red);
+  --accent-blue: var(--system-blue);
+  --accent-orange: #E8732A;
+  --accent-yellow: var(--system-yellow);
+
+  --surface-ground: #f8f9fa;
+  --surface-section: #ffffff;
+  --surface-card: rgba(255, 255, 255, 0.55);
+  --surface-border: rgba(0, 0, 0, 0.06);
+  --surface-hover: rgba(0, 0, 0, 0.04);
+  --text-color: #111827;
+  --text-color-secondary: rgba(17, 24, 39, 0.55);
+
+  --glass-bg: rgba(255, 255, 255, 0.55);
+  --glass-bg-elevated: rgba(255, 255, 255, 0.72);
+  --glass-blur: 40px;
+  --glass-border: rgba(255, 255, 255, 0.35);
+  --glass-shadow: 0 8px 40px rgba(0, 0, 0, 0.08);
+  --glass-inner-glow: inset 0 1px 0 rgba(255, 255, 255, 0.5);
+
+  --card-radius: 20px;
+  --card-padding: 20px;
+  --card-gap: 14px;
+
+  --window-bg: var(--material-glass);
+  --window-radius: 46px;
+  --window-blur: var(--material-glass-blur);
+  --window-shadow: 0 24px 80px rgba(0, 0, 0, 0.12);
+  --window-border: var(--material-glass-stroke);
+  --window-specular: var(--material-glass-specular);
+
+  --titlebar-bg: transparent;
+  --titlebar-height: 92px;
+  --titlebar-padding: 0 24px;
+
+  --dock-bg: rgba(255, 255, 255, 0.15);
+  --dock-border: rgba(255, 255, 255, 0.3);
+  --dock-blur: 50px;
+
+  --menubar-bg: rgba(255, 255, 255, 0.55);
+  --menubar-border: rgba(0, 0, 0, 0.06);
+  --menubar-text: rgba(17, 24, 39, 1);
+  --menubar-blur: 40px;
+  --menubar-radius: 24px;
+
+  --sidebar-bg: rgba(255, 255, 255, 0.35);
+  --sidebar-border: rgba(255, 255, 255, 0.25);
+  --sidebar-width: 60px;
+  --sidebar-icon-size: 36px;
+  --sidebar-radius: 28px;
+
+  --focus-ring: rgba(232, 115, 42, 0.5);
+}

package/scss/_theme-transparent.scss

@@ -0,0 +1,41 @@
+// ─── Transparent / Spatial Theme (visionOS-style) ───────────────────────────
+html.transparent-theme {
+  --primary-light: rgba(232, 115, 42, 0.2);
+
+  --surface-ground: transparent;
+  --surface-section: rgba(255, 255, 255, 0.18);
+  --surface-card: rgba(255, 255, 255, 0.22);
+  --surface-border: rgba(255, 255, 255, 0.16);
+  --surface-hover: rgba(0, 0, 0, 0.04);
+  --text-color: var(--label-primary);
+  --text-color-secondary: var(--label-secondary);
+
+  --glass-bg: var(--material-glass);
+  --glass-bg-elevated: rgba(128, 128, 128, 0.45);
+  --glass-blur: var(--material-glass-blur);
+  --glass-border: var(--material-glass-stroke);
+  --glass-shadow: 0 12px 48px rgba(0, 0, 0, 0.15);
+  --glass-inner-glow: var(--material-glass-specular);
+
+  --window-bg: var(--material-glass);
+  --window-radius: 46px;
+  --window-blur: var(--material-glass-blur);
+  --window-shadow: 0 24px 80px rgba(0, 0, 0, 0.15);
+  --window-border: var(--material-glass-stroke);
+
+  --titlebar-bg: transparent;
+
+  --dock-bg: rgba(128, 128, 128, 0.2);
+  --dock-border: var(--material-glass-stroke);
+  --dock-blur: var(--material-glass-blur);
+
+  --menubar-bg: rgba(128, 128, 128, 0.25);
+  --menubar-border: var(--material-glass-stroke);
+  --menubar-text: var(--label-primary);
+  --menubar-blur: var(--material-glass-blur);
+
+  --sidebar-bg: rgba(128, 128, 128, 0.2);
+  --sidebar-border: var(--material-glass-stroke);
+
+  --focus-ring: rgba(232, 115, 42, 0.6);
+}

package/scss/_tokens.scss

@@ -0,0 +1,126 @@
+// ─── visionOS System Colors & Design Tokens ─────────────────────────────────
+:root {
+  --system-red: #FF453A;
+  --system-orange: #FF9F0A;
+  --system-yellow: #FFD60A;
+  --system-green: #32D74B;
+  --system-mint: #66D4CF;
+  --system-teal: #6AC4DC;
+  --system-cyan: #5AC8F5;
+  --system-blue: #0A84FF;
+  --system-indigo: #5E5CE6;
+  --system-purple: #BF5AF2;
+  --system-pink: #FF375F;
+  --system-brown: #AC8E68;
+  --system-gray: #98989D;
+
+  // ── Semantic Status Colors ──
+  --status-success: var(--system-green);
+  --status-warning: var(--system-orange);
+  --status-error: var(--system-red);
+  --status-info: var(--system-blue);
+  --status-pending: var(--system-yellow);
+
+  // ── visionOS Typography ──
+  --font-family: 'SF Pro Display', 'SF Pro', 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+  --font-xl-title1: 700 48px/56px var(--font-family);
+  --font-xl-title2: 700 38px/46px var(--font-family);
+  --font-large-title: 700 29px/38px var(--font-family);
+  --font-title1: 700 24px/32px var(--font-family);
+  --font-title2: 700 22px/28px var(--font-family);
+  --font-title3: 700 19px/24px var(--font-family);
+  --font-headline: 700 17px/22px var(--font-family);
+  --font-body: 510 17px/22px var(--font-family);
+  --font-callout: 590 15px/20px var(--font-family);
+  --font-subheadline: 400 15px/20px var(--font-family);
+  --font-footnote: 510 13px/18px var(--font-family);
+  --font-caption1: 510 12px/16px var(--font-family);
+  --font-caption2: 510 12px/16px var(--font-family);
+
+  // ── visionOS Label Colors ──
+  --label-primary: rgba(255, 255, 255, 0.96);
+  --label-secondary: rgba(255, 255, 255, 0.56);
+  --label-tertiary: rgba(255, 255, 255, 0.36);
+
+  // ── visionOS Materials ──
+  --material-glass: rgba(128, 128, 128, 0.3);
+  --material-glass-blur: 50px;
+  --material-glass-stroke: rgba(255, 255, 255, 0.4);
+  --material-glass-specular: inset 0px -0.5px 1px rgba(255, 255, 255, 0.3),
+                              inset 0px -0.5px 1px rgba(255, 255, 255, 0.25),
+                              inset 1px 1.5px 4px rgba(0, 0, 0, 0.08),
+                              inset 1px 1.5px 4px rgba(0, 0, 0, 0.1);
+
+  --material-recessed-bg: linear-gradient(rgba(208, 208, 208, 0.5), rgba(208, 208, 208, 0.5)),
+                           linear-gradient(rgba(0, 0, 0, 0.1), rgba(0, 0, 0, 0.1));
+  --material-recessed-shadow: inset 1px 1.5px 4px rgba(0, 0, 0, 0.1),
+                               inset 1px 1.5px 4px rgba(0, 0, 0, 0.08),
+                               inset 0px -0.5px 1px rgba(255, 255, 255, 0.25),
+                               inset 0px -0.5px 1px rgba(255, 255, 255, 0.3);
+
+  --material-thin: rgba(255, 255, 255, 0.06);
+  --material-regular: rgba(255, 255, 255, 0.12);
+  --material-thick: rgba(255, 255, 255, 0.2);
+
+  --control-idle: rgba(255, 255, 255, 0.06);
+  --control-hover: rgba(255, 255, 255, 0.12);
+  --control-selected: rgba(255, 255, 255, 1);
+  --control-disabled: rgba(255, 255, 255, 0.04);
+
+  --separator: rgba(255, 255, 255, 0.12);
+
+  --blur-shadow-small: 0 2px 4px rgba(0, 0, 0, 0.1);
+
+  // ── visionOS Button Tokens ──
+  --btn-font-weight: 590;
+  --btn-symbol-font-weight: 510;
+  --btn-radius-capsule: 500px;
+  --btn-radius-rect-lg: 16px;
+  --btn-radius-rect-sm: 8px;
+
+  --btn-sm-height: 32px;
+  --btn-sm-padding: 0 12px;
+  --btn-sm-font-size: 15px;
+  --btn-sm-line-height: 20px;
+  --btn-sm-symbol-size: 17px;
+  --btn-sm-gap: 2px;
+
+  --btn-reg-height: 44px;
+  --btn-reg-padding: 0 20px;
+  --btn-reg-font-size: 17px;
+  --btn-reg-line-height: 22px;
+  --btn-reg-symbol-size: 19px;
+  --btn-reg-gap: 6px;
+
+  --btn-lg-height: 52px;
+  --btn-lg-padding: 0 25px;
+  --btn-lg-font-size: 19px;
+  --btn-lg-line-height: 24px;
+  --btn-lg-symbol-size: 22px;
+  --btn-lg-gap: 6px;
+
+  --btn-symbol-mini: 28px;
+  --btn-symbol-mini-font: 13px;
+  --btn-symbol-sm: 36px;
+  --btn-symbol-sm-font: 15px;
+  --btn-symbol-reg: 44px;
+  --btn-symbol-reg-font: 19px;
+  --btn-symbol-lg: 52px;
+  --btn-symbol-lg-font: 22px;
+  --btn-symbol-xl: 60px;
+  --btn-symbol-xl-font: 26px;
+
+  --btn-platter-lighten: rgba(255, 255, 255, 0.06);
+  --btn-platter-dodge: rgba(94, 94, 94, 0.18);
+  --btn-hover-grad-white: rgba(255, 255, 255, 0.07);
+  --btn-hover-grad-gray: rgba(94, 94, 94, 0.14);
+  --btn-disabled-lighten: rgba(255, 255, 255, 0.04);
+  --btn-disabled-dodge: rgba(94, 94, 94, 0.07);
+  --btn-disabled-text: rgba(112, 112, 112, 0.5);
+  --btn-selected-bg: rgba(255, 255, 255, 0.96);
+  --btn-selected-text: #000000;
+
+  --link-color: #3CD3FE;
+  --link-height: 26px;
+  --link-font-size: 13px;
+}

package/types/mohamedatia-fly-design-system.d.ts

@@ -1,4 +1,5 @@
-import { Type, InjectionToken } from '@angular/core';
+import * as i0 from '@angular/core';
+import { Type, InjectionToken, PipeTransform } from '@angular/core';
 
 interface DesktopApp {
     id: string;
@@ -49,9 +50,24 @@ interface WindowInstance {
     isUnmaximizing?: boolean;
     parentWindowId?: string;
     childData?: ChildWindowData;
+    /** Populated when remote `loadComponent()` fails (e.g. federation). */
+    remoteLoadError?: string;
 }
 declare const WINDOW_DATA: InjectionToken<WindowInstance>;
 
+interface User {
+    id: string;
+    tenantId: string | null;
+    email: string;
+    fullName: string;
+    firstName: string;
+    lastName: string;
+    preferredLocale: string;
+    roles: string[];
+    apps: string[];
+    ou?: string;
+}
+
 /**
  * Describes a Business App remote registered via the Controller App's
  * /api/apps/manifest endpoint. The shell loads the component at runtime
@@ -63,6 +79,8 @@ interface RemoteAppDef {
     remoteEntry: string;
     /** The module key exposed by the remote's federation.config.js, e.g. "./MyAppComponent" */
     exposedModule: string;
+    /** Base URL for locale JSON (`{base}{lang}.json`), e.g. `/circles-dev/locale/` or `https://app/locale/` */
+    localeBaseUrl?: string;
     nameKey: string;
     descriptionKey: string;
     icon: string;
@@ -80,6 +98,159 @@ interface RemoteAppDef {
     chromeless?: boolean;
 }
 
-export { WINDOW_DATA };
-export type { ChildWindowData, DesktopApp, RemoteAppDef, WindowInstance, WindowState };
+/**
+ * Shared AuthService for Business Apps.
+ *
+ * This is a **read-only signal store** — Business Apps inject it to read the
+ * current user and access token. The FlyOS shell populates it after PKCE login
+ * and silent refresh. Business Apps must never call setSession() directly.
+ *
+ * When running as a Module Federation remote, the shell and the Business App
+ * share this singleton via the `@mohamedatia/fly-design-system` shared mapping
+ * in federation.config.js — so the shell's populated instance is the same
+ * object the Business App reads.
+ *
+ * When running standalone (without the shell), call initFromToken() with a
+ * JWT stored in localStorage to hydrate the user.
+ */
+declare class AuthService {
+    private _session;
+    readonly currentUser: i0.Signal<User | null>;
+    readonly accessToken: i0.Signal<string | null>;
+    readonly isAuthenticated: i0.Signal<boolean>;
+    /**
+     * Called by the shell after a successful login or silent refresh.
+     * Business Apps should not call this directly.
+     */
+    setSession(user: User, accessToken: string, expiresAt: number): void;
+    /** Clears the in-memory session (called by the shell on logout). */
+    clearSession(): void;
+    /**
+     * Standalone mode: parse a JWT from localStorage and hydrate the user.
+     * Key defaults to "circles_token" but can be overridden.
+     */
+    initFromToken(storageKey?: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AuthService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AuthService>;
+}
+
+/** Locales that use RTL layout for `dir` and DS `isRtl` / `direction`. */
+declare const RTL_LOCALE_SET: ReadonlySet<string>;
+declare function isRtlLocale(lang: string): boolean;
+/** Options for loading a remote or standalone locale JSON bundle. */
+interface LoadBundleOptions {
+    /** Stable id (e.g. app id from manifest); later loads replace this bundle only. */
+    id: string;
+    /** Base URL ending with `/`, e.g. `https://app.example.com/locale/` or `/circles-dev/locale/` */
+    baseUrl: string;
+    lang: string;
+    /** When aborted, failures are ignored (e.g. superseded language load). */
+    signal?: AbortSignal;
+}
+/**
+ * Shared I18nService for the shell and Business Apps.
+ *
+ * **Merge order** (later keys win): shell layer → remote bundles in registration order.
+ *
+ * - Shell: `setShellTranslations()` after loading `locale/{lang}.json` and API overrides.
+ * - Remotes: `loadBundle()` per manifest `localeBaseUrl`.
+ */
+declare class I18nService {
+    private readonly errorHandler;
+    private readonly _shell;
+    private readonly _bundles;
+    private readonly _bundleOrder;
+    private readonly _locale;
+    private readonly _version;
+    private readonly _merged;
+    readonly locale: i0.Signal<string>;
+    readonly version: i0.Signal<number>;
+    readonly isRtl: i0.Signal<boolean>;
+    readonly direction: i0.Signal<"rtl" | "ltr">;
+    private bump;
+    /** Replace shell strings (desktop `locale/*.json` + `/api/i18n/desktop-shell/{lang}` merged by the shell). */
+    setShellTranslations(data: Record<string, string>, lang: string): void;
+    setLanguage(lang: string): void;
+    /**
+     * Fetch `{baseUrl}{lang}.json` and store under `id`. New ids are appended to the merge order.
+     */
+    loadBundle(opts: LoadBundleOptions): Promise<void>;
+    removeBundle(id: string): void;
+    clearRemoteBundles(): void;
+    t(key: string, params?: Record<string, string | number>): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<I18nService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<I18nService>;
+}
+
+type FlyThemeMode = 'light' | 'dark' | 'transparent';
+/**
+ * Applies `html.light-theme` / `html.dark-theme` / `html.transparent-theme` for DS SCSS.
+ * Shell and standalone Business Apps use the same service (federation singleton when shared).
+ */
+declare class FlyThemeService {
+    readonly theme: i0.WritableSignal<FlyThemeMode>;
+    applyTheme(mode: FlyThemeMode): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FlyThemeService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<FlyThemeService>;
+}
+
+/** Options for opening a child window. */
+interface OpenWindowOptions {
+    /** Unique identifier for the window instance. */
+    windowId: string;
+    /** Display title shown in the window chrome. */
+    title: string;
+    /** Route path or URL to load inside the window. */
+    route: string;
+    /** Initial width in pixels. Defaults to 900. */
+    width?: number;
+    /** Initial height in pixels. Defaults to 600. */
+    height?: number;
+    /** Whether the window can be resized. Defaults to true. */
+    resizable?: boolean;
+    /** Whether the window can be maximised. Defaults to true. */
+    maximizable?: boolean;
+    /** Arbitrary data passed to the child window via WINDOW_DATA. */
+    data?: unknown;
+}
+/**
+ * Abstract interface for the WindowManager.
+ * The FlyOS shell provides the concrete implementation; Business Apps
+ * inject this token to open, close, and focus windows without depending
+ * on the shell's internal implementation.
+ */
+declare abstract class WindowManagerService {
+    abstract openChildWindow(options: OpenWindowOptions): void;
+    abstract closeWindow(windowId: string): void;
+    abstract focusWindow(windowId: string): void;
+}
+/**
+ * No-op fallback implementation used when running a Business App in
+ * standalone mode (outside the FlyOS shell). Logs a warning instead of
+ * throwing so standalone dev/test flows are not broken.
+ */
+declare class StandaloneWindowManagerService extends WindowManagerService {
+    openChildWindow(options: OpenWindowOptions): void;
+    closeWindow(windowId: string): void;
+    focusWindow(windowId: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<StandaloneWindowManagerService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<StandaloneWindowManagerService>;
+}
+
+/**
+ * Translates a key using the shared I18nService.
+ *
+ * @example
+ * {{ 'circles.signals.title' | translate }}
+ * {{ 'circles.items_count' | translate:{ n: count() } }}
+ */
+declare class TranslatePipe implements PipeTransform {
+    private readonly i18n;
+    transform(key: string, params?: Record<string, string | number>): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TranslatePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<TranslatePipe, "translate", true>;
+}
+
+export { AuthService, FlyThemeService, I18nService, RTL_LOCALE_SET, StandaloneWindowManagerService, TranslatePipe, WINDOW_DATA, WindowManagerService, isRtlLocale };
+export type { ChildWindowData, DesktopApp, FlyThemeMode, LoadBundleOptions, OpenWindowOptions, RemoteAppDef, User, WindowInstance, WindowState };
 //# sourceMappingURL=mohamedatia-fly-design-system.d.ts.map

package/types/mohamedatia-fly-design-system.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mohamedatia-fly-design-system.d.ts","sources":["../../../projects/design-system/src/lib/models/app.model.ts","../../../projects/design-system/src/lib/models/window.model.ts","../../../projects/design-system/src/lib/models/remote-app.model.ts"],"mappings":";;UAEiB,UAAU;;;;;;yBAMJ,OAAO,CAAC,IAAI;AACjC;;;;AACA;;;;;;;AAID;;ACZK,KAAM,WAAW;UAEN,eAAe;AAC9B,oBAAgB,IAAI;AACpB;AACD;UAEgB,cAAc;;;;;;WAMtB,WAAW;AAClB;;;;AACA;;;;;;;;;;;;gBASY,eAAe;AAC5B;AAED,cAAa,WAAW,EAAA,cAAA,CAAA,cAAA;;AC3BxB;;;;AAIG;UACc,YAAY;;;;;;;;;;AAU3B;;;;AACA;;;;;AAEA,cAAU,UAAU;;AAErB;;;;","names":[]}
+{"version":3,"file":"mohamedatia-fly-design-system.d.ts","sources":["../../../projects/design-system/src/lib/models/app.model.ts","../../../projects/design-system/src/lib/models/window.model.ts","../../../projects/design-system/src/lib/models/user.model.ts","../../../projects/design-system/src/lib/models/remote-app.model.ts","../../../projects/design-system/src/lib/services/auth.service.ts","../../../projects/design-system/src/lib/services/i18n.service.ts","../../../projects/design-system/src/lib/services/fly-theme.service.ts","../../../projects/design-system/src/lib/services/window-manager.service.ts","../../../projects/design-system/src/lib/pipes/translate.pipe.ts"],"mappings":";;;UAEiB,UAAU;;;;;;yBAMJ,OAAO,CAAC,IAAI;AACjC;;;;AACA;;;;;;;AAID;;ACZK,KAAM,WAAW;UAEN,eAAe;AAC9B,oBAAgB,IAAI;AACpB;AACD;UAEgB,cAAc;;;;;;WAMtB,WAAW;AAClB;;;;AACA;;;;;;;;;;;;gBASY,eAAe;;;AAG5B;AAED,cAAa,WAAW,EAAA,cAAA,CAAA,cAAA;;UC/BP,IAAI;;AAEnB;;;;;;;;;AASD;;ACTD;;;;AAIG;UACc,YAAY;;;;;;;;;;;;AAY3B;;;;AACA;;;;;AAEA,cAAU,UAAU;;AAErB;;ACfD;;;;;;;;;;;;;;AAcG;AACH,cACa,WAAW;;0BAGFA,EAAA,CAAA,MAAA,CAAA,IAAA;0BACAA,EAAA,CAAA,MAAA;8BACIA,EAAA,CAAA,MAAA;AAKxB;;;AAGG;AACH,qBAAiB,IAAI;;AAKrB;AAIA;;;AAGG;AACH;yCA3BW,WAAW;6CAAX,WAAW;AA8DvB;;ACrFD;AACA,cAAa,cAAc,EAAE,WAAW;AAExC,iBAAgB,WAAW;AA8B3B;UACiB,iBAAiB;;;;;;;aAOvB,WAAW;AACrB;AAED;;;;;;;AAOG;AACH,cACa,WAAW;AACtB;AAEA;AACA;AACA;AACA;AACA;AAEA;qBAYeA,EAAA,CAAA,MAAA;sBACCA,EAAA,CAAA,MAAA;oBACFA,EAAA,CAAA,MAAA;wBACIA,EAAA,CAAA,MAAA;AAElB;;AAKA,+BAA2B,MAAM;AAMjC;AAKA;;AAEG;qBACoB,iBAAiB,GAAG,OAAO;AAmBlD;AAUA;AAMA,4BAAwB,MAAM;yCAhFnB,WAAW;6CAAX,WAAW;AAwFvB;;AC7IK,KAAM,YAAY;AAExB;;;AAGG;AACH,cACa,eAAe;oBACZA,EAAA,CAAA,cAAA,CAAA,YAAA;AAEd,qBAAiB,YAAY;yCAHlB,eAAe;6CAAf,eAAe;AAe3B;;ACtBD;UACiB,iBAAiB;;;;;;;;;;;;;;;;;AAiBjC;AAED;;;;;AAKG;AACH,uBAAsB,oBAAoB;AACxC,sCAAkC,iBAAiB;AACnD;AACA;AACD;AAED;;;;AAIG;AACH,cACa,8BAA+B,SAAQ,oBAAoB;AACtE,6BAAyB,iBAAiB;AAI1C;AAIA;yCATW,8BAA8B;6CAA9B,8BAA8B;AAY1C;;ACjDD;;;;;;AAMG;AACH,cAKa,aAAc,YAAW,aAAa;AACjD;AAEA,oCAAgC,MAAM;yCAH3B,aAAa;uCAAb,aAAa;AAMzB;;;;","names":["_angular_core"]}