@nindroidsystems/pluginator 2.3.0

package/dist/ui/themes/index.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Theme System
+ *
+ * Provides React Context for theming throughout the UI
+ *
+ * @since v1.57.0 - Added extended theme system with semantic tokens
+ */
+import React, { type ReactNode } from 'react';
+import type { Tier } from '../../core/types/auth.js';
+import type { ExtendedThemeContextValue, SemanticColors } from './theme-types.js';
+import type { ThemeContextValue } from './types.js';
+export * from './types.js';
+export * from './presets/index.js';
+export * from './gradient-presets.js';
+export * from './theme-types.js';
+export * from './theme-validator.js';
+export * from './theme-loader.js';
+export * from './default-themes.js';
+export * from './color-utils.js';
+export * from './contrast-checker.js';
+export * from './color-blindness.js';
+export * from './theme-marketplace.js';
+export * from './theme-gallery-loader.js';
+export * from './theme-scheduler.js';
+/**
+ * Theme Provider Props
+ */
+export interface ThemeProviderProps {
+    children: ReactNode;
+    initialTheme?: string;
+}
+/**
+ * Theme Provider Component
+ *
+ * Note: Custom color overrides have been removed in v1.15.0.
+ * Use bundled theme presets only (default, dark, light, monokai, nord).
+ */
+export declare function ThemeProvider({ children, initialTheme }: ThemeProviderProps): React.ReactElement;
+/**
+ * Hook to access theme context
+ */
+export declare function useTheme(): ThemeContextValue;
+/**
+ * Extended Theme Provider Props
+ */
+export interface ExtendedThemeProviderProps {
+    children: ReactNode;
+    userTier?: Tier;
+    initialTheme?: string;
+}
+/**
+ * Extended Theme Provider Component
+ *
+ * Provides semantic color tokens and tier-gated themes.
+ *
+ * @since v1.57.0
+ */
+export declare function ExtendedThemeProvider({ children, userTier, initialTheme }: ExtendedThemeProviderProps): React.ReactElement;
+/**
+ * Hook to access extended theme context
+ *
+ * @since v1.57.0
+ */
+export declare function useExtendedTheme(): ExtendedThemeContextValue;
+/**
+ * Hook to get semantic colors (shorthand for useExtendedTheme().colors)
+ *
+ * @since v1.57.0
+ */
+export declare function useSemanticColors(): SemanticColors;
+/**
+ * Hook to check if user has access to a specific theme
+ *
+ * @since v1.57.0
+ */
+export declare function useThemeAccess(themeId: string): boolean;
+/**
+ * Convert extended theme to legacy format for backward compatibility
+ *
+ * @since v1.57.0
+ */
+export declare function useThemeLegacy(): ThemeContextValue;
+//# sourceMappingURL=index.d.ts.map

package/dist/ui/themes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ui/themes/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,EAA2D,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACvG,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAIrD,OAAO,KAAK,EAAiB,yBAAyB,EAAE,cAAc,EAAiB,MAAM,kBAAkB,CAAC;AAEhH,OAAO,KAAK,EAAS,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG3D,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AAOrC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,SAAS,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,YAAwB,EAAE,EAAE,kBAAkB,GAAG,KAAK,CAAC,YAAY,CA+D5G;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,iBAAiB,CAY5C;AAWD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AASD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,QAAQ,EAAE,QAAiB,EAAE,YAAY,EAAE,EAAE,0BAA0B,GAAG,KAAK,CAAC,YAAY,CAkEnI;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,yBAAyB,CAgB5D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAGlD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAIvD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,iBAAiB,CAclD"}

package/dist/ui/themes/presets/default.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Default Theme - Purple/Violet tones
+ */
+import type { Theme } from '../types.js';
+export declare const defaultTheme: Theme;
+//# sourceMappingURL=default.d.ts.map

package/dist/ui/themes/presets/default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../../../src/ui/themes/presets/default.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGzC,eAAO,MAAM,YAAY,EAAE,KAmB1B,CAAC"}

package/dist/ui/themes/presets/forest.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Forest Theme - Green/Emerald tones
+ */
+import type { Theme } from '../types.js';
+export declare const forestTheme: Theme;
+//# sourceMappingURL=forest.d.ts.map

package/dist/ui/themes/presets/forest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forest.d.ts","sourceRoot":"","sources":["../../../../src/ui/themes/presets/forest.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGzC,eAAO,MAAM,WAAW,EAAE,KAmBzB,CAAC"}

package/dist/ui/themes/presets/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Theme Presets
+ *
+ * Barrel exports for all theme presets and utilities
+ */
+import type { Theme, ThemeColors } from '../types.js';
+export { DEFAULT_SPACING } from './spacing.js';
+export { defaultTheme } from './default.js';
+export { oceanTheme } from './ocean.js';
+export { forestTheme } from './forest.js';
+export { sunsetTheme } from './sunset.js';
+/**
+ * All available theme presets
+ */
+export declare const themePresets: Record<string, Theme>;
+/**
+ * Get a theme by name
+ */
+export declare function getTheme(name: string): Theme;
+/**
+ * Merge custom colors with a base theme
+ */
+export declare function mergeTheme(base: Theme, customColors: Partial<ThemeColors>): Theme;
+//# sourceMappingURL=index.d.ts.map

package/dist/ui/themes/presets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ui/themes/presets/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAOtD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAK9C,CAAC;AAEF;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAE5C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,KAAK,CAQjF"}

package/dist/ui/themes/presets/ocean.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Ocean Theme - Blue/Cyan tones
+ */
+import type { Theme } from '../types.js';
+export declare const oceanTheme: Theme;
+//# sourceMappingURL=ocean.d.ts.map

package/dist/ui/themes/presets/ocean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ocean.d.ts","sourceRoot":"","sources":["../../../../src/ui/themes/presets/ocean.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGzC,eAAO,MAAM,UAAU,EAAE,KAmBxB,CAAC"}

package/dist/ui/themes/presets/spacing.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Default Spacing
+ *
+ * Shared spacing values for all themes - compact for terminal use
+ */
+import type { ThemeSpacing } from '../types.js';
+export declare const DEFAULT_SPACING: ThemeSpacing;
+//# sourceMappingURL=spacing.d.ts.map

package/dist/ui/themes/presets/spacing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spacing.d.ts","sourceRoot":"","sources":["../../../../src/ui/themes/presets/spacing.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,eAAO,MAAM,eAAe,EAAE,YAM7B,CAAC"}

package/dist/ui/themes/presets/sunset.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Sunset Theme - Orange/Amber tones
+ */
+import type { Theme } from '../types.js';
+export declare const sunsetTheme: Theme;
+//# sourceMappingURL=sunset.d.ts.map

package/dist/ui/themes/presets/sunset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sunset.d.ts","sourceRoot":"","sources":["../../../../src/ui/themes/presets/sunset.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGzC,eAAO,MAAM,WAAW,EAAE,KAmBzB,CAAC"}

package/dist/ui/themes/theme-gallery-loader.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Theme Gallery Loader
+ *
+ * Loads and caches the bundled theme gallery JSON.
+ * Used as offline fallback for the marketplace and for API seeding.
+ *
+ * @since v2.2.3
+ */
+import type { ExtendedTheme } from './theme-types.js';
+/**
+ * Gallery theme entry — extends ExtendedTheme with gallery metadata
+ */
+export interface GalleryTheme extends ExtendedTheme {
+    /** Whether the theme has been verified by the Pluginator team */
+    verified?: boolean;
+    /** Whether the theme is featured in the gallery */
+    featured?: boolean;
+}
+/**
+ * Load all themes from the bundled gallery JSON.
+ * Results are cached after first load.
+ */
+export declare function loadThemeGallery(): GalleryTheme[];
+/**
+ * Get a single gallery theme by ID.
+ */
+export declare function getGalleryTheme(id: string): GalleryTheme | undefined;
+/**
+ * Clear the gallery cache (useful for testing).
+ */
+export declare function clearGalleryCache(): void;
+//# sourceMappingURL=theme-gallery-loader.d.ts.map

package/dist/ui/themes/theme-gallery-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-gallery-loader.d.ts","sourceRoot":"","sources":["../../../src/ui/themes/theme-gallery-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAgB,aAAa,EAAyC,MAAM,kBAAkB,CAAC;AAE3G;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAeD;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,YAAY,EAAE,CAYjD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/ui/themes/theme-loader.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Theme Loader
+ *
+ * Loads and manages themes from bundled defaults and user directory.
+ * Handles tier-gating for premium themes.
+ *
+ * @since v1.57.0
+ */
+import type { Tier } from '../../core/types/auth.js';
+import type { ExtendedTheme, ThemeMetadata, ThemePreferences } from './theme-types.js';
+/**
+ * Check if user tier meets minimum requirement
+ */
+export declare function tierMeetsMinimum(userTier: Tier, minTier: Tier): boolean;
+/**
+ * Theme loader service
+ */
+export declare class ThemeLoader {
+    private themes;
+    private userThemesDir;
+    private preferencesPath;
+    private preferences;
+    private initialized;
+    constructor();
+    /**
+     * Initialize the theme loader
+     */
+    init(): Promise<void>;
+    /**
+     * Load bundled default themes
+     */
+    private loadBundledThemes;
+    /**
+     * Load user-created themes
+     */
+    private loadUserThemes;
+    /**
+     * Load user preferences
+     */
+    private loadPreferences;
+    /**
+     * Save user preferences
+     */
+    private savePreferences;
+    /**
+     * Get default preferences
+     */
+    private getDefaultPreferences;
+    /**
+     * Get all themes (optionally filtered by tier)
+     */
+    getThemes(userTier?: Tier): ExtendedTheme[];
+    /**
+     * Get theme metadata for gallery display
+     */
+    getThemeMetadata(userTier?: Tier): ThemeMetadata[];
+    /**
+     * Get a theme by ID
+     */
+    getTheme(id: string): ExtendedTheme | undefined;
+    /**
+     * Get current active theme
+     */
+    getActiveTheme(): ExtendedTheme;
+    /**
+     * Set active theme (with tier check)
+     */
+    setActiveTheme(id: string, userTier: Tier): boolean;
+    /**
+     * Get recent themes
+     */
+    getRecentThemes(): ThemeMetadata[];
+    /**
+     * Save a custom theme
+     */
+    saveCustomTheme(theme: ExtendedTheme): {
+        success: boolean;
+        error?: string;
+    };
+    /**
+     * Add a user theme directly (for marketplace installs)
+     */
+    addUserTheme(theme: ExtendedTheme): void;
+    /**
+     * Delete a custom theme
+     */
+    deleteCustomTheme(id: string): boolean;
+    /**
+     * Get themes by category
+     */
+    getThemesByCategory(category: ExtendedTheme['category'], userTier?: Tier): ExtendedTheme[];
+    /**
+     * Get themes by type (dark/light)
+     */
+    getThemesByType(type: ExtendedTheme['type'], userTier?: Tier): ExtendedTheme[];
+    /**
+     * Check if a theme is available to the user
+     */
+    isThemeAvailable(id: string, userTier: Tier): boolean;
+    /**
+     * Get theme count by tier
+     */
+    getThemeCountByTier(): Record<Tier, number>;
+    /**
+     * Export theme preferences for backup
+     */
+    exportPreferences(): ThemePreferences;
+    /**
+     * Import theme preferences
+     */
+    importPreferences(prefs: ThemePreferences): boolean;
+    /**
+     * Get auto dark mode settings
+     */
+    getAutoDarkMode(): ThemePreferences['autoDarkMode'];
+    /**
+     * Set auto dark mode settings
+     */
+    setAutoDarkMode(settings: ThemePreferences['autoDarkMode']): void;
+    /**
+     * Get theme for current time (if auto dark mode enabled)
+     */
+    getThemeForCurrentTime(): ExtendedTheme | null;
+}
+/**
+ * Get the theme loader instance
+ */
+export declare function getThemeLoader(): ThemeLoader;
+/**
+ * Initialize the theme loader (call at app startup)
+ */
+export declare function initThemeLoader(): Promise<ThemeLoader>;
+//# sourceMappingURL=theme-loader.d.ts.map

package/dist/ui/themes/theme-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-loader.d.ts","sourceRoot":"","sources":["../../../src/ui/themes/theme-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAErD,OAAO,KAAK,EAAE,aAAa,EAAkB,aAAa,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAQvG;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAG,OAAO,CAIvE;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAyC;IACvD,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,WAAW,CAAS;;IAQ5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAoBtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAkBvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAQ7B;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,EAAE,IAAI,GAAG,aAAa,EAAE;IAM3C;;OAEG;IACH,gBAAgB,CAAC,QAAQ,CAAC,EAAE,IAAI,GAAG,aAAa,EAAE;IAmBlD;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI/C;;OAEG;IACH,cAAc,IAAI,aAAa;IAK/B;;OAEG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,OAAO;IAmBnD;;OAEG;IACH,eAAe,IAAI,aAAa,EAAE;IAoBlC;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IA8B3E;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IA6BxC;;OAEG;IACH,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAsBtC;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,EAAE,IAAI,GAAG,aAAa,EAAE;IAI1F;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,EAAE,IAAI,GAAG,aAAa,EAAE;IAI9E;;OAEG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,OAAO;IAMrD;;OAEG;IACH,mBAAmB,IAAI,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC;IAQ3C;;OAEG;IACH,iBAAiB,IAAI,gBAAgB;IAIrC;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO;IAQnD;;OAEG;IACH,eAAe,IAAI,gBAAgB,CAAC,cAAc,CAAC;IAInD;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,gBAAgB,CAAC,cAAc,CAAC,GAAG,IAAI;IAKjE;;OAEG;IACH,sBAAsB,IAAI,aAAa,GAAG,IAAI;CAU/C;AAKD;;GAEG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAK5C;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC,CAI5D"}

package/dist/ui/themes/theme-marketplace.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Theme Marketplace Service
+ *
+ * Provides community theme sharing, browsing, and installation.
+ * Fetches from NinSys API with offline fallback to bundled gallery.
+ * Max tier feature.
+ *
+ * @since v1.57.4
+ * @updated v2.2.3 — API integration + offline fallback
+ */
+import type { Tier } from '../../core/types/auth.js';
+import type { ExtendedTheme } from './theme-types.js';
+/**
+ * Marketplace theme entry (includes community metadata)
+ */
+export interface MarketplaceTheme {
+    theme: ExtendedTheme;
+    author: {
+        id: string;
+        name: string;
+        avatar?: string;
+    };
+    stats: {
+        downloads: number;
+        rating: number;
+        ratingCount: number;
+    };
+    publishedAt: string;
+    updatedAt: string;
+    featured: boolean;
+    verified: boolean;
+}
+/**
+ * Theme search filters
+ */
+export interface ThemeSearchFilters {
+    query?: string;
+    type?: 'dark' | 'light' | 'all';
+    category?: string;
+    sortBy?: 'popular' | 'rating' | 'recent' | 'downloads';
+    page?: number;
+    pageSize?: number;
+}
+/**
+ * Theme search result
+ */
+export interface ThemeSearchResult {
+    themes: MarketplaceTheme[];
+    total: number;
+    page: number;
+    pageSize: number;
+    hasMore: boolean;
+}
+/**
+ * Theme install result
+ */
+export interface ThemeInstallResult {
+    success: boolean;
+    theme?: ExtendedTheme;
+    error?: string;
+}
+/**
+ * Marketplace submission request
+ */
+export interface ThemeSubmission {
+    theme: ExtendedTheme;
+    description: string;
+    tags: string[];
+    screenshots?: string[];
+}
+/**
+ * Submission result
+ */
+export interface SubmissionResult {
+    success: boolean;
+    themeId?: string;
+    message: string;
+}
+/**
+ * Theme rating request
+ */
+export interface ThemeRating {
+    themeId: string;
+    rating: number;
+    review?: string;
+}
+/**
+ * Theme Marketplace Service
+ */
+export declare class ThemeMarketplaceService {
+    private readonly apiUrl;
+    private installedThemes;
+    private cachedResults;
+    private cacheExpiry;
+    private lastCacheTime;
+    constructor(apiUrl?: string);
+    /**
+     * Check if user has marketplace access
+     */
+    hasAccess(tier: Tier): boolean;
+    /**
+     * Search marketplace themes via API, with offline fallback
+     */
+    search(filters?: ThemeSearchFilters): Promise<ThemeSearchResult>;
+    /**
+     * Get featured themes
+     */
+    getFeatured(): Promise<MarketplaceTheme[]>;
+    /**
+     * Get theme by ID from marketplace, with offline fallback
+     */
+    getTheme(themeId: string): Promise<MarketplaceTheme | null>;
+    /**
+     * Install theme from marketplace
+     */
+    installTheme(themeId: string): Promise<ThemeInstallResult>;
+    /**
+     * Install theme from URL (JSON file)
+     */
+    installFromUrl(url: string): Promise<ThemeInstallResult>;
+    /**
+     * Submit theme to marketplace
+     */
+    submitTheme(submission: ThemeSubmission): Promise<SubmissionResult>;
+    /**
+     * Rate a theme
+     */
+    rateTheme(rating: ThemeRating): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * Check if theme is installed
+     */
+    isInstalled(themeId: string): boolean;
+    /**
+     * Get installed marketplace themes
+     */
+    getInstalledThemes(): ExtendedTheme[];
+    /**
+     * Uninstall marketplace theme
+     */
+    uninstallTheme(themeId: string): boolean;
+    /**
+     * Clear cache
+     */
+    clearCache(): void;
+}
+/**
+ * Get marketplace service instance
+ */
+export declare function getMarketplaceService(): ThemeMarketplaceService;
+/**
+ * Initialize marketplace with custom API URL
+ */
+export declare function initMarketplaceService(apiUrl?: string): ThemeMarketplaceService;
+/**
+ * Format download count for display
+ */
+export declare function formatDownloadCount(count: number): string;
+/**
+ * Format rating for display
+ */
+export declare function formatRating(rating: number): string;
+/**
+ * Get star display for rating
+ */
+export declare function getRatingStars(rating: number): string;
+/**
+ * Validate marketplace theme
+ */
+export declare function validateMarketplaceTheme(data: unknown): {
+    valid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=theme-marketplace.d.ts.map

package/dist/ui/themes/theme-marketplace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-marketplace.d.ts","sourceRoot":"","sources":["../../../src/ui/themes/theme-marketplace.ts"],"names":[],"mappings":"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"}