@gostack-framework/ui 0.0.0-stage → 0.1.0

package/dist/typography/typography.adapter.js

@@ -0,0 +1,113 @@
+/**
+ * Typography Persistence Adapter
+ * Isolates data storage logic behind a clean contract.
+ * Allows effortless swapping between LocalStorage and REST/GraphQL API.
+ */
+import { DEFAULT_TYPOGRAPHY_CONFIG } from "./typography.constants.js";
+const STORAGE_KEY = "gostack_typography_config_v1";
+/**
+ * LocalStorage Repository Implementation
+ * Synchronous read/write fallback suitable for client-side persistence.
+ */
+export const typographyLocalStorageRepository = {
+    getConfig: () => {
+        if (typeof window === "undefined") {
+            return DEFAULT_TYPOGRAPHY_CONFIG;
+        }
+        try {
+            const raw = localStorage.getItem(STORAGE_KEY);
+            if (!raw)
+                return DEFAULT_TYPOGRAPHY_CONFIG;
+            const parsed = JSON.parse(raw);
+            return {
+                ...DEFAULT_TYPOGRAPHY_CONFIG,
+                ...parsed,
+            };
+        }
+        catch (error) {
+            console.warn("[TypographyRepository] Failed to read config from localStorage, using defaults:", error);
+            return DEFAULT_TYPOGRAPHY_CONFIG;
+        }
+    },
+    saveConfig: (config) => {
+        if (typeof window === "undefined")
+            return;
+        try {
+            localStorage.setItem(STORAGE_KEY, JSON.stringify(config));
+        }
+        catch (error) {
+            console.error("[TypographyRepository] Failed to save config to localStorage:", error);
+        }
+    },
+    resetConfig: () => {
+        if (typeof window === "undefined")
+            return;
+        try {
+            localStorage.removeItem(STORAGE_KEY);
+        }
+        catch (error) {
+            console.error("[TypographyRepository] Failed to clear config from localStorage:", error);
+        }
+    },
+};
+/**
+ * REST / GraphQL API Repository Stub
+ * Template for seamless backend integration when migrating away from LocalStorage.
+ */
+export const createTypographyApiRepository = (apiEndpoint = "/api/v1/settings/typography") => ({
+    getConfig: async () => {
+        try {
+            const response = await fetch(apiEndpoint, {
+                headers: { "Content-Type": "application/json" },
+            });
+            if (!response.ok)
+                throw new Error(`HTTP ${response.status}`);
+            const json = await response.json();
+            return { ...DEFAULT_TYPOGRAPHY_CONFIG, ...json.data };
+        }
+        catch (error) {
+            console.warn("[TypographyApiRepository] API call failed, fallback to defaults:", error);
+            return typographyLocalStorageRepository.getConfig();
+        }
+    },
+    saveConfig: async (config) => {
+        try {
+            const response = await fetch(apiEndpoint, {
+                method: "PUT",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(config),
+            });
+            if (!response.ok)
+                throw new Error(`HTTP ${response.status}`);
+            // Also mirror to localStorage for offline cache
+            typographyLocalStorageRepository.saveConfig(config);
+        }
+        catch (error) {
+            console.error("[TypographyApiRepository] Failed to save to API:", error);
+            typographyLocalStorageRepository.saveConfig(config);
+        }
+    },
+    resetConfig: async () => {
+        try {
+            await fetch(apiEndpoint, { method: "DELETE" });
+            typographyLocalStorageRepository.resetConfig();
+        }
+        catch (error) {
+            console.error("[TypographyApiRepository] Failed to reset on API:", error);
+            typographyLocalStorageRepository.resetConfig();
+        }
+    },
+});
+/**
+ * Active Repository Singleton
+ * To swap from LocalStorage to API across the entire app, simply call:
+ * `setTypographyRepository(createTypographyApiRepository('/api/v1/typography'))`
+ */
+let activeRepository = typographyLocalStorageRepository;
+export function getTypographyRepository() {
+    return activeRepository;
+}
+export function setTypographyRepository(repo) {
+    activeRepository = repo;
+}
+//# sourceMappingURL=typography.adapter.js.map

package/dist/typography/typography.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typography.adapter.js","sourceRoot":"","sources":["../../src/typography/typography.adapter.ts"],"names":[],"mappings":"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"}

package/dist/typography/typography.constants.d.ts

@@ -0,0 +1,56 @@
+import { FontOptionItem, FontScaleOptionItem, FontSizeScale, SupportedArabicFont, SupportedHeadingFont, SupportedLatinFont, ThemedTextAlign, ThemedTextColor, ThemedTextTransform, ThemedTextVariant, TypographyConfig, TypographyVariantItem } from "./typography.types";
+/**
+ * Default Typography Configuration
+ */
+export declare const DEFAULT_TYPOGRAPHY_CONFIG: TypographyConfig;
+/**
+ * Supported Latin Fonts with metadata and CSS mappings
+ */
+export declare const LATIN_FONT_OPTIONS: FontOptionItem<SupportedLatinFont>[];
+/**
+ * Supported Arabic (RTL) Fonts with metadata
+ */
+export declare const ARABIC_FONT_OPTIONS: FontOptionItem<SupportedArabicFont>[];
+/**
+ * Supported Heading Fonts
+ */
+export declare const HEADING_FONT_OPTIONS: FontOptionItem<SupportedHeadingFont>[];
+/**
+ * Font Scale / Density options
+ */
+export declare const FONT_SCALE_OPTIONS: FontScaleOptionItem[];
+/**
+ * Font Family Class Map
+ * Maps individual font identifiers to Tailwind CSS utility classes
+ */
+export declare const FONT_FAMILIES_MAP: Record<string, string>;
+/**
+ * Text Colors Map (Using dashboard CSS variables)
+ */
+export declare const TEXT_COLORS_MAP: Record<ThemedTextColor, string>;
+/**
+ * Variant Configurations Array by Scale (compact, normal, comfortable)
+ * Contains the variant array of objects handling the font size, font weight,
+ * line-height, and tracking for each scale density mode.
+ */
+export declare const VARIANTS_CONFIG_BY_SCALE: Record<FontSizeScale, TypographyVariantItem[]>;
+/**
+ * Compiled map for O(1) variant style resolution by scale
+ */
+export declare const VARIANT_STYLES_BY_SCALE: Record<FontSizeScale, Record<ThemedTextVariant, string>>;
+/**
+ * Helper to resolve complete variant styling (size + weight + tracking) by active scale
+ */
+export declare const getVariantStyle: (variant?: ThemedTextVariant, scale?: FontSizeScale) => string;
+/**
+ * Variant Styles Map (Default normal fallback for backwards compatibility)
+ */
+export declare const VARIANT_STYLES_MAP: Record<ThemedTextVariant, string>;
+/**
+ * Text Alignments Map
+ */
+export declare const TEXT_ALIGNMENTS_MAP: Record<ThemedTextAlign, string>;
+/**
+ * Text Transforms Map
+ */
+export declare const TEXT_TRANSFORMS_MAP: Record<ThemedTextTransform, string>;