@epoch32/visage 1.0.0 → 1.1.1

package/dist/vite/lucide.d.ts

@@ -0,0 +1,27 @@
+import type { VisageVitePlugin } from "./types";
+export interface VisageLucideOptions {
+    /**
+     * Module aliases to intercept and translate.
+     * Defaults to `["lucide-react"]`.
+     */
+    aliases?: string[];
+}
+/**
+ * Official Visage Lucide Vite Plugin
+ *
+ * Statically transforms `import { Icon } from "lucide-react"` at build time into
+ * native, tree-shaken Visage SVG component instances using `createIcon` and `lucide`.
+ *
+ * Example:
+ * ```ts
+ * // vite.config.ts
+ * import { defineConfig } from "vite";
+ * import visage, { visageLucide } from "visage/vite";
+ *
+ * export default defineConfig({
+ *   plugins: [visage(), visageLucide()]
+ * });
+ * ```
+ */
+export declare function visageLucide(options?: VisageLucideOptions): VisageVitePlugin;
+export default visageLucide;

package/dist/vite/plugin.d.ts

@@ -0,0 +1,3 @@
+import type { VisagePluginOptions, VisageVitePlugin } from "./types";
+export declare function visage(options?: VisagePluginOptions): VisageVitePlugin[];
+export default visage;

package/dist/vite/rpc-middleware.d.ts

@@ -0,0 +1,5 @@
+import type { VisagePluginOptions } from "./types";
+/**
+ * Attach Visage RPC handler to Vite's Connect dev server middleware
+ */
+export declare function createViteRpcMiddleware(options: NonNullable<VisagePluginOptions["rpc"]>): (req: any, res: any, next: () => void) => Promise<void>;

package/dist/vite/types.d.ts

@@ -0,0 +1,59 @@
+import type { createRouter } from "../rpc/router";
+/**
+ * Options for the Visage Vite Plugin
+ */
+export interface VisagePluginOptions {
+    /**
+     * Automatically auto-inject Visage DevTools in development mode
+     * @default true
+     */
+    devtools?: boolean;
+    /**
+     * Enable Hot Module Replacement (HMR) with signal state preservation
+     * @default true
+     */
+    hmr?: boolean;
+    /**
+     * Extract static <Style> blocks into production CSS bundle
+     * @default true
+     */
+    extractCss?: boolean;
+    /**
+     * Enable Server-Side Rendering (SSR) pipeline
+     * @default false
+     */
+    ssr?: boolean;
+    /**
+     * Optional full-stack RPC router configuration for Vite dev server middleware
+     */
+    rpc?: {
+        router: ReturnType<typeof createRouter<any>>;
+        endpoint?: string;
+    };
+}
+/**
+ * Minimal interface representation of Vite Plugin to ensure zero hard runtime dependencies
+ */
+export interface VisageVitePlugin {
+    name: string;
+    enforce?: "pre" | "post";
+    apply?: "serve" | "build" | ((config: any, env: {
+        command: string;
+        mode: string;
+    }) => boolean);
+    config?: (config: any, env: any) => any;
+    configResolved?: (config: any) => void;
+    configureServer?: (server: any) => void | Promise<void>;
+    resolveId?: (source: string, importer?: string, options?: any) => Promise<string | null | undefined> | string | null | undefined;
+    load?: (id: string, options?: any) => Promise<string | null | undefined> | string | null | undefined;
+    transform?: (code: string, id: string, options?: {
+        ssr?: boolean;
+    }) => Promise<{
+        code: string;
+        map?: any;
+    } | null> | {
+        code: string;
+        map?: any;
+    } | null;
+    transformIndexHtml?: (html: string) => string | Promise<string>;
+}

package/package.json

@@ -1,82 +1,82 @@
 {
   "name": "@epoch32/visage",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "Lightning-fast, zero-VDOM, fine-grained reactive UI library with full TypeScript support",
   "type": "module",
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./src/index.ts",
-      "import": "./src/index.ts"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     },
     "./signals": {
-      "types": "./src/signals/index.ts",
-      "import": "./src/signals/index.ts"
+      "types": "./dist/signals/index.d.ts",
+      "import": "./dist/signals/index.js"
     },
     "./dom": {
-      "types": "./src/dom/index.ts",
-      "import": "./src/dom/index.ts"
+      "types": "./dist/dom/index.d.ts",
+      "import": "./dist/dom/index.js"
     },
     "./router": {
-      "types": "./src/router/index.ts",
-      "import": "./src/router/index.ts"
+      "types": "./dist/router/index.d.ts",
+      "import": "./dist/router/index.js"
     },
     "./template": {
-      "types": "./src/template/index.ts",
-      "import": "./src/template/index.ts"
+      "types": "./dist/template/index.d.ts",
+      "import": "./dist/template/index.js"
     },
     "./server": {
-      "types": "./src/server/index.ts",
-      "import": "./src/server/index.ts"
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js"
     },
     "./form": {
-      "types": "./src/form/index.ts",
-      "import": "./src/form/index.ts"
+      "types": "./dist/form/index.d.ts",
+      "import": "./dist/form/index.js"
     },
     "./virtual": {
-      "types": "./src/virtual/index.ts",
-      "import": "./src/virtual/index.ts"
+      "types": "./dist/virtual/index.d.ts",
+      "import": "./dist/virtual/index.js"
     },
     "./query": {
-      "types": "./src/query/index.ts",
-      "import": "./src/query/index.ts"
+      "types": "./dist/query/index.d.ts",
+      "import": "./dist/query/index.js"
     },
     "./rpc": {
-      "types": "./src/rpc/index.ts",
-      "import": "./src/rpc/index.ts"
+      "types": "./dist/rpc/index.d.ts",
+      "import": "./dist/rpc/index.js"
     },
     "./api": {
-      "types": "./src/api/index.ts",
-      "import": "./src/api/index.ts"
+      "types": "./dist/api/index.d.ts",
+      "import": "./dist/api/index.js"
     },
     "./style": {
-      "types": "./src/style/index.ts",
-      "import": "./src/style/index.ts"
+      "types": "./dist/style/index.d.ts",
+      "import": "./dist/style/index.js"
     },
     "./devtools": {
-      "types": "./src/devtools/index.ts",
-      "import": "./src/devtools/index.ts"
+      "types": "./dist/devtools/index.d.ts",
+      "import": "./dist/devtools/index.js"
     },
     "./vite": {
-      "types": "./src/vite/index.ts",
-      "import": "./src/vite/index.ts"
+      "types": "./dist/vite/index.d.ts",
+      "import": "./dist/vite/index.js"
     },
     "./ui": {
-      "types": "./src/ui/index.ts",
-      "import": "./src/ui/index.ts"
+      "types": "./dist/ui/index.d.ts",
+      "import": "./dist/ui/index.js"
     },
     "./charts": {
-      "types": "./src/charts/index.ts",
-      "import": "./src/charts/index.ts"
+      "types": "./dist/charts/index.d.ts",
+      "import": "./dist/charts/index.js"
     },
     "./jsx-runtime": {
-      "types": "./src/jsx-runtime/index.ts",
-      "import": "./src/jsx-runtime/index.ts"
+      "types": "./dist/jsx-runtime/index.d.ts",
+      "import": "./dist/jsx-runtime/index.js"
     },
     "./jsx-dev-runtime": {
-      "types": "./src/jsx-runtime/index.ts",
-      "import": "./src/jsx-runtime/index.ts"
+      "types": "./dist/jsx-runtime/index.d.ts",
+      "import": "./dist/jsx-runtime/index.js"
     }
   },
   "sideEffects": false,
@@ -100,7 +100,7 @@
     "package.json"
   ],
   "scripts": {
-    "build": "bun build src/index.ts src/signals/index.ts src/dom/index.ts src/template/index.ts src/api/index.ts src/rpc/index.ts src/query/index.ts src/style/index.ts src/devtools/index.ts src/ui/index.ts src/virtual/index.ts src/form/index.ts src/server/index.ts src/router/index.ts src/vite/index.ts src/jsx-runtime/index.ts src/charts/index.ts --outdir dist/",
+    "build": "bun build src/index.ts src/signals/index.ts src/dom/index.ts src/template/index.ts src/api/index.ts src/rpc/index.ts src/query/index.ts src/style/index.ts src/devtools/index.ts src/ui/index.ts src/virtual/index.ts src/form/index.ts src/server/index.ts src/router/index.ts src/vite/index.ts src/jsx-runtime/index.ts src/charts/index.ts --root src --outdir dist/ && bun x tsc -p tsconfig.build.json && cp src/jsx-runtime/jsx.d.ts dist/jsx-runtime/jsx.d.ts",
     "test": "bun test",
     "test:watch": "bun test --watch",
     "test:coverage": "bun test --coverage",

package/src/signals/index.ts

@@ -49,6 +49,7 @@ export {
   COMPUTED_BRAND,
   type Dependency,
   isSignal,
+  type PersistOptions,
   type ReadonlySignal,
   SIGNAL_BRAND,
   type Subscriber,

package/src/signals/signal.ts

@@ -22,11 +22,13 @@ export class Signal<T> implements IDependency {
   private _value: T;
   private _subscribers: Set<ISubscriber> = new Set();
   private _equals: (a: T, b: T) => boolean;
+  private _onSet?: (val: T) => void;
   version = 0;
 
-  constructor(initialValue: T, equals?: (a: T, b: T) => boolean) {
+  constructor(initialValue: T, equals?: (a: T, b: T) => boolean, onSet?: (val: T) => void) {
     this._value = initialValue;
     this._equals = equals ?? Object.is;
+    this._onSet = onSet;
   }
 
   get(): T {
@@ -58,6 +60,9 @@ export class Signal<T> implements IDependency {
 
     this._value = newValue;
     this.version++;
+    if (this._onSet) {
+      this._onSet(newValue);
+    }
     batch(() => {
       this.notify();
     });
@@ -117,6 +122,43 @@ export class Signal<T> implements IDependency {
  * @param optionsOrEquals - Custom equality comparison function or SignalOptions
  * @returns A writable reactive signal function accessor
  */
+function resolveStorage(storageOption?: "local" | "session" | Storage): Storage | null {
+  if (storageOption && typeof storageOption === "object") {
+    return storageOption;
+  }
+  if (storageOption === "session") {
+    try {
+      if (typeof sessionStorage !== "undefined") return sessionStorage;
+    } catch {}
+    try {
+      if (typeof window !== "undefined" && (window as any).sessionStorage) {
+        return (window as any).sessionStorage;
+      }
+    } catch {}
+    try {
+      if (typeof globalThis !== "undefined" && (globalThis as any).sessionStorage) {
+        return (globalThis as any).sessionStorage;
+      }
+    } catch {}
+    return null;
+  }
+
+  try {
+    if (typeof localStorage !== "undefined") return localStorage;
+  } catch {}
+  try {
+    if (typeof window !== "undefined" && (window as any).localStorage) {
+      return (window as any).localStorage;
+    }
+  } catch {}
+  try {
+    if (typeof globalThis !== "undefined" && (globalThis as any).localStorage) {
+      return (globalThis as any).localStorage;
+    }
+  } catch {}
+  return null;
+}
+
 export function signal<T>(
   initialValue: T,
   optionsOrEquals?: ((a: T, b: T) => boolean) | SignalOptions<T>
@@ -125,7 +167,73 @@ export function signal<T>(
   const isInternal = typeof optionsOrEquals === "object" ? optionsOrEquals?.internal : false;
   const customName = typeof optionsOrEquals === "object" ? optionsOrEquals?.name : undefined;
 
-  const s = new Signal(initialValue, equals);
+  const persistOption = typeof optionsOrEquals === "object" ? optionsOrEquals?.persist : undefined;
+  const persistConfig = persistOption
+    ? typeof persistOption === "string"
+      ? { key: persistOption }
+      : persistOption
+    : undefined;
+
+  let effectiveInitial = initialValue;
+  const storage = persistConfig ? resolveStorage(persistConfig.storage) : null;
+  const serialize = persistConfig?.serialize ?? JSON.stringify;
+  const deserialize = persistConfig?.deserialize ?? JSON.parse;
+
+  if (persistConfig && storage) {
+    try {
+      const stored = storage.getItem(persistConfig.key);
+      if (stored !== null) {
+        effectiveInitial = deserialize(stored);
+      }
+    } catch {
+      // Fallback cleanly to initialValue
+    }
+  }
+
+  let isSyncing = false;
+  const onSet =
+    persistConfig && storage
+      ? (val: T) => {
+          if (isSyncing) return;
+          try {
+            storage.setItem(persistConfig.key, serialize(val));
+          } catch {
+            // Gracefully handle storage quota or access errors
+          }
+        }
+      : undefined;
+
+  const s = new Signal(effectiveInitial, equals, onSet);
+
+  if (
+    persistConfig &&
+    storage &&
+    (persistConfig.syncTabs ?? true) &&
+    typeof window !== "undefined" &&
+    typeof window.addEventListener === "function"
+  ) {
+    const onStorage = (e: StorageEvent) => {
+      if (e.key === persistConfig.key) {
+        try {
+          const nextVal = e.newValue !== null ? deserialize(e.newValue) : initialValue;
+          isSyncing = true;
+          try {
+            s.set(nextVal);
+          } finally {
+            isSyncing = false;
+          }
+        } catch {
+          // Ignore external malformed entries
+        }
+      }
+    };
+    window.addEventListener("storage", onStorage);
+    if (currentScope) {
+      currentScope.addCleanup(() => {
+        window.removeEventListener("storage", onStorage);
+      });
+    }
+  }
 
   const accessor = ((...args: [value?: T]): T => {
     if (args.length === 0) {

package/src/signals/types.ts

@@ -29,10 +29,19 @@ export interface WritableSignal<T> extends ReadonlySignal<T> {
   value: T;
 }
 
+export interface PersistOptions<T> {
+  key: string;
+  storage?: "local" | "session" | Storage;
+  serialize?: (value: T) => string;
+  deserialize?: (raw: string) => T;
+  syncTabs?: boolean;
+}
+
 export interface SignalOptions<T> {
   name?: string;
   equals?: (a: T, b: T) => boolean;
   internal?: boolean;
+  persist?: string | PersistOptions<T>;
 }
 
 export interface ComputedOptions {

package/src/vite/plugin.ts

@@ -57,6 +57,10 @@ export function visage(options: VisagePluginOptions = {}): VisageVitePlugin[] {
           ]
         },
         resolve: {
+          alias: [
+            { find: /^visage\/(.*)/, replacement: "@epoch32/visage/$1" },
+            { find: /^visage$/, replacement: "@epoch32/visage" }
+          ],
           dedupe: ["@epoch32/visage", "visage"]
         }
       };