@salla.sa/twilight-theme-engine 1.0.0-beta.4

package/dist/vite/plugins/best-practices/types.d.ts

@@ -0,0 +1,34 @@
+export type Severity = 'error' | 'warn' | 'info';
+export interface Violation {
+    rule: string;
+    message: string;
+    line: number;
+    recommendation: string;
+}
+export interface RuleContext {
+    /** Full source code of the file. */
+    code: string;
+    /** Absolute file path. */
+    id: string;
+    /** Path relative to the project root. */
+    relativeId: string;
+}
+export interface Rule {
+    name: string;
+    description: string;
+    severity: Severity;
+    check(context: RuleContext): Violation[];
+}
+export interface BestPracticesOptions {
+    /** Glob patterns to include (default: all .ts/.tsx files). */
+    include?: string[];
+    /** Glob patterns to exclude. */
+    exclude?: string[];
+    /** Disable specific rules by name. */
+    disabledRules?: string[];
+    /** Override severity per rule name. */
+    severityOverrides?: Record<string, Severity>;
+    /** Inject warnings into the browser dev console (default: false). */
+    browserConsole?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/vite/plugins/best-practices/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/vite/plugins/best-practices/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEjD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,sCAAsC;IACtC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,uCAAuC;IACvC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC7C,qEAAqE;IACrE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B"}

package/dist/vite/plugins/package-aliases.plugin.d.ts

@@ -0,0 +1,3 @@
+import type { Plugin } from 'vite';
+export declare function packageAliasesPlugin(): Plugin;
+//# sourceMappingURL=package-aliases.plugin.d.ts.map

package/dist/vite/plugins/package-aliases.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-aliases.plugin.d.ts","sourceRoot":"","sources":["../../../src/vite/plugins/package-aliases.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAgB,MAAM,MAAM,CAAC;AA0NjD,wBAAgB,oBAAoB,IAAI,MAAM,CAY7C"}

package/dist/vite/plugins/salla-hydration.plugin.d.ts

@@ -0,0 +1,12 @@
+import type { Plugin } from 'vite';
+/**
+ * Vite plugin that automatically adds `suppressHydrationWarning` to all Salla
+ * web components (`salla-*` and `custom-*`) in JSX/TSX source files.
+ *
+ * All Salla web components are built with Stencil.js, which adds
+ * `class="hydrated"` and may inject light DOM content after the browser parses
+ * the SSR HTML but before React's `hydrateRoot` runs. Without suppression,
+ * React throws a hydration mismatch and regenerates the entire subtree.
+ */
+export declare function webHydrationPlugin(): Plugin;
+//# sourceMappingURL=salla-hydration.plugin.d.ts.map

package/dist/vite/plugins/salla-hydration.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"salla-hydration.plugin.d.ts","sourceRoot":"","sources":["../../../src/vite/plugins/salla-hydration.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAKnC;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CA8D3C"}

package/dist/vite/plugins/theme-translations.plugin.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Vite plugin that exposes a `virtual:twilight/theme-translations` module
+ * built from all `*.json` files found in the configured `localesDir`.
+ *
+ * The virtual module exports a `TranslationMessages` object keyed by
+ * `{locale}.trans` so it maps directly into the i18next `theme` namespace.
+ *
+ * @example
+ * // vite.config.ts
+ * twilightReact({ localesDir: './locales' })
+ *
+ * // virtual module output (auto-generated, never written to disk):
+ * export default {
+ *   'ar.trans': { "key": "قيمة" },
+ *   'en.trans': { "key": "value" },
+ * };
+ */
+import type { Plugin } from 'vite';
+export declare function themeTranslationsPlugin(localesDir?: string): Plugin;
+//# sourceMappingURL=theme-translations.plugin.d.ts.map

package/dist/vite/plugins/theme-translations.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-translations.plugin.d.ts","sourceRoot":"","sources":["../../../src/vite/plugins/theme-translations.plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAOnC,wBAAgB,uBAAuB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CA4DnE"}

package/dist/vite/twilight-react.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @fileoverview twilightReact — entry point for the Twilight Vite plugin.
+ *
+ * Framework-specific setup is fully delegated to the adapter for that framework.
+ * Developers can optionally create `app/routes.ts` to add or override routes.
+ */
+import type { PluginOption } from 'vite';
+import type { TwilightReactOptions } from './types';
+export type { TwilightRoute, Framework, ReactPluginOptions, TanStackRouterOptions, NextJsRouterOptions, RouterOptions, TwilightReactOptions, FrameworkAdapter, } from './types';
+/**
+ * Main Twilight Vite plugin.
+ *
+ * For TanStack Start + Cloudflare Workers (default):
+ * ```ts
+ * export default defineConfig(async () => ({
+ *   plugins: [cloudflare({ viteEnvironment: { name: 'ssr' } }), ...(await twilightReact())],
+ * }));
+ * ```
+ */
+export declare function twilightReact(options?: TwilightReactOptions): Promise<PluginOption[]>;
+export default twilightReact;
+//# sourceMappingURL=twilight-react.d.ts.map

package/dist/vite/twilight-react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"twilight-react.d.ts","sourceRoot":"","sources":["../../src/vite/twilight-react.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AACzC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAOpD,YAAY,EACV,aAAa,EACb,SAAS,EACT,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAO/F;AAED,eAAe,aAAa,CAAC"}

package/dist/vite/types.d.ts

@@ -0,0 +1,110 @@
+/**
+ * @fileoverview Type definitions for twilightReact plugin
+ */
+import type { PluginOption } from 'vite';
+export interface TwilightRoute {
+    path: string;
+    file: string;
+    factory: string;
+    /** Route identifier for matching, analytics, and conditional rendering */
+    id?: string;
+    isIndex?: boolean;
+    isLayout?: boolean;
+}
+/**
+ * Supported frameworks for twilightReact plugin
+ */
+export type Framework = 'tanstack' | 'nextjs';
+/**
+ * Options for React plugin configuration
+ */
+export interface ReactPluginOptions {
+    jsxRuntime?: 'automatic' | 'classic';
+    jsxImportSource?: string;
+    babel?: Record<string, any>;
+    [key: string]: any;
+}
+/**
+ * Options for TanStack Router plugin configuration
+ */
+export interface TanStackRouterOptions {
+    /**
+     * Directory for route files (default: './app/routes')
+     */
+    routesDirectory?: string;
+    generatedRouteTree?: string;
+    virtualRouteConfig?: unknown;
+    /**
+     * Root route file name (default: '__root.tsx')
+     */
+    rootRoute?: string;
+    /**
+     * Path to the developer's custom routes file (default: './app/routes.ts').
+     * If the file exists, its route entries are merged with the base routes.
+     * Routes with matching paths override the defaults.
+     */
+    routesFile?: string;
+    [key: string]: any;
+}
+/**
+ * Options for Next.js router configuration (for future support)
+ */
+export interface NextJsRouterOptions {
+    [key: string]: any;
+}
+/**
+ * Router configuration based on framework
+ */
+export type RouterOptions = TanStackRouterOptions | NextJsRouterOptions;
+export interface GenerateRoutesOptions {
+    projectRoot: string;
+    /** Base routes to generate. When omitted the adapter uses its own defaults. */
+    baseRoutes?: TwilightRoute[];
+    baseRoutesImport: string;
+}
+export interface TwilightReactOptions {
+    /**
+     * Framework to use (default: 'tanstack')
+     */
+    framework?: Framework;
+    /**
+     * Source directory for the app (default: 'app').
+     */
+    srcDirectory?: string;
+    /**
+     * Import path for base routes (default: '@salla.sa/twilight-theme-engine/routes')
+     */
+    baseRoutesImport?: string;
+    /**
+     * Options or plugin instance for the React plugin.
+     * - Pass an object to configure the auto-created React plugin.
+     * - Pass a plugin instance to use your own (e.g., react({ ... })).
+     * - Omit to use defaults.
+     */
+    react?: ReactPluginOptions | PluginOption;
+    /**
+     * Options or plugin instance for the router plugin.
+     * - Pass an object to configure the auto-created router plugin.
+     * - Pass a plugin instance to use your own (e.g., tanstackRouterGenerator({ ... })).
+     * - Omit to use defaults.
+     */
+    router?: RouterOptions | PluginOption;
+    /**
+     * Path to the directory containing per-locale JSON translation files.
+     * Relative to `vite.config.ts`. When set, all `*.json` files in the folder
+     * are bundled into the `virtual:twilight/theme-translations` module and
+     * loaded into the i18next `theme` fallback namespace at build time.
+     *
+     * @example './locales'
+     */
+    localesDir?: string;
+}
+/**
+ * Framework adapter interface for extensibility
+ */
+export interface FrameworkAdapter {
+    name: string;
+    generateRouteFiles: (options: GenerateRoutesOptions) => TwilightRoute[];
+    createPlugins: (options: TwilightReactOptions) => Promise<PluginOption[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/vite/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/vite/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAEzC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,qBAAqB,GAAG,mBAAmB,CAAC;AAExE,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;;;OAKG;IACH,KAAK,CAAC,EAAE,kBAAkB,GAAG,YAAY,CAAC;IAE1C;;;;;OAKG;IACH,MAAM,CAAC,EAAE,aAAa,GAAG,YAAY,CAAC;IACtC;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,aAAa,EAAE,CAAC;IACxE,aAAa,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CAC3E"}