@lukas_holdings/castdom 1.0.0

package/dist/types-ChD5jENU.d.cts

@@ -0,0 +1,105 @@
+/** A single bone — one rectangular skeleton element */
+interface Bone {
+    /** X position relative to container (px) */
+    x: number;
+    /** Y position relative to container (px) */
+    y: number;
+    /** Width (px) */
+    w: number;
+    /** Height (px) */
+    h: number;
+    /** Border radius (px). 9999 = circle */
+    r: number;
+    /** Element type hint for content-aware rendering */
+    kind?: BoneKind;
+}
+type BoneKind = "text" | "heading" | "image" | "avatar" | "button" | "input" | "icon" | "divider" | "block";
+/** Bone data for a single breakpoint */
+interface BreakpointData {
+    /** Viewport width this was captured at */
+    viewport: number;
+    /** Container width at capture time */
+    containerWidth: number;
+    /** Container height at capture time */
+    containerHeight: number;
+    /** All bones at this breakpoint */
+    bones: Bone[];
+}
+/** Complete skeleton definition for a named component */
+interface SkeletonData {
+    /** Unique name for this skeleton */
+    name: string;
+    /** Version hash for cache busting */
+    hash: string;
+    /** Breakpoint data, sorted ascending by viewport width */
+    breakpoints: BreakpointData[];
+    /** Timestamp of last extraction */
+    extractedAt: number;
+}
+/** Configuration for CastDOM */
+interface CastDOMConfig {
+    /** Directory to output generated skeleton data */
+    outDir?: string;
+    /** Breakpoint widths to capture at (default: [375, 768, 1280]) */
+    breakpoints?: number[];
+    /** Base color for skeleton bones (default: "#e0e0e0") */
+    color?: string;
+    /** Shimmer highlight color (default: "#f0f0f0") */
+    shimmerColor?: string;
+    /** Animation duration in ms (default: 1500) */
+    animationDuration?: number;
+    /** Enable content-aware bone detection (default: true) */
+    contentAware?: boolean;
+    /** Minimum bone size to include in px (default: 4) */
+    minBoneSize?: number;
+    /** CSS class prefix (default: "castdom") */
+    classPrefix?: string;
+    /** Generate inline styles instead of class-based (default: false) */
+    inlineStyles?: boolean;
+    /** Enable SSR rendering (default: true) */
+    ssr?: boolean;
+    /** URL or path to dev server for extraction */
+    devServer?: string;
+    /** Routes to snapshot for extraction */
+    routes?: string[];
+    /** Playwright launch options */
+    playwright?: {
+        headless?: boolean;
+        timeout?: number;
+    };
+}
+/** Registry entry used at runtime */
+interface RegistryEntry {
+    data: SkeletonData;
+    css: string;
+    html: Record<number, string>;
+}
+/** Extraction target — what to snapshot */
+interface ExtractionTarget {
+    name: string;
+    selector: string;
+    route?: string;
+}
+/** Result from the extraction process */
+interface ExtractionResult {
+    target: ExtractionTarget;
+    skeleton: SkeletonData;
+}
+/** Compressed bone format for wire/storage (delta-encoded) */
+interface CompressedBones {
+    /** Version of compression format */
+    v: 1;
+    /** Viewport width */
+    vw: number;
+    /** Container dimensions [w, h] */
+    c: [number, number];
+    /** Flat array: [x, y, w, h, r, kind, ...] per bone. kind is enum index. */
+    d: number[];
+}
+/** Default configuration values */
+declare const DEFAULTS: Required<Pick<CastDOMConfig, "outDir" | "breakpoints" | "color" | "shimmerColor" | "animationDuration" | "contentAware" | "minBoneSize" | "classPrefix" | "inlineStyles" | "ssr">>;
+/** Map bone kind to numeric index for compression */
+declare const BONE_KIND_INDEX: Record<BoneKind, number>;
+declare const BONE_KIND_FROM_INDEX: Record<number, BoneKind>;
+
+export { type BreakpointData as B, type CastDOMConfig as C, DEFAULTS as D, type ExtractionResult as E, type RegistryEntry as R, type SkeletonData as S, type Bone as a, type CompressedBones as b, BONE_KIND_FROM_INDEX as c, BONE_KIND_INDEX as d, type BoneKind as e, type ExtractionTarget as f };

package/dist/types-ChD5jENU.d.ts

@@ -0,0 +1,105 @@
+/** A single bone — one rectangular skeleton element */
+interface Bone {
+    /** X position relative to container (px) */
+    x: number;
+    /** Y position relative to container (px) */
+    y: number;
+    /** Width (px) */
+    w: number;
+    /** Height (px) */
+    h: number;
+    /** Border radius (px). 9999 = circle */
+    r: number;
+    /** Element type hint for content-aware rendering */
+    kind?: BoneKind;
+}
+type BoneKind = "text" | "heading" | "image" | "avatar" | "button" | "input" | "icon" | "divider" | "block";
+/** Bone data for a single breakpoint */
+interface BreakpointData {
+    /** Viewport width this was captured at */
+    viewport: number;
+    /** Container width at capture time */
+    containerWidth: number;
+    /** Container height at capture time */
+    containerHeight: number;
+    /** All bones at this breakpoint */
+    bones: Bone[];
+}
+/** Complete skeleton definition for a named component */
+interface SkeletonData {
+    /** Unique name for this skeleton */
+    name: string;
+    /** Version hash for cache busting */
+    hash: string;
+    /** Breakpoint data, sorted ascending by viewport width */
+    breakpoints: BreakpointData[];
+    /** Timestamp of last extraction */
+    extractedAt: number;
+}
+/** Configuration for CastDOM */
+interface CastDOMConfig {
+    /** Directory to output generated skeleton data */
+    outDir?: string;
+    /** Breakpoint widths to capture at (default: [375, 768, 1280]) */
+    breakpoints?: number[];
+    /** Base color for skeleton bones (default: "#e0e0e0") */
+    color?: string;
+    /** Shimmer highlight color (default: "#f0f0f0") */
+    shimmerColor?: string;
+    /** Animation duration in ms (default: 1500) */
+    animationDuration?: number;
+    /** Enable content-aware bone detection (default: true) */
+    contentAware?: boolean;
+    /** Minimum bone size to include in px (default: 4) */
+    minBoneSize?: number;
+    /** CSS class prefix (default: "castdom") */
+    classPrefix?: string;
+    /** Generate inline styles instead of class-based (default: false) */
+    inlineStyles?: boolean;
+    /** Enable SSR rendering (default: true) */
+    ssr?: boolean;
+    /** URL or path to dev server for extraction */
+    devServer?: string;
+    /** Routes to snapshot for extraction */
+    routes?: string[];
+    /** Playwright launch options */
+    playwright?: {
+        headless?: boolean;
+        timeout?: number;
+    };
+}
+/** Registry entry used at runtime */
+interface RegistryEntry {
+    data: SkeletonData;
+    css: string;
+    html: Record<number, string>;
+}
+/** Extraction target — what to snapshot */
+interface ExtractionTarget {
+    name: string;
+    selector: string;
+    route?: string;
+}
+/** Result from the extraction process */
+interface ExtractionResult {
+    target: ExtractionTarget;
+    skeleton: SkeletonData;
+}
+/** Compressed bone format for wire/storage (delta-encoded) */
+interface CompressedBones {
+    /** Version of compression format */
+    v: 1;
+    /** Viewport width */
+    vw: number;
+    /** Container dimensions [w, h] */
+    c: [number, number];
+    /** Flat array: [x, y, w, h, r, kind, ...] per bone. kind is enum index. */
+    d: number[];
+}
+/** Default configuration values */
+declare const DEFAULTS: Required<Pick<CastDOMConfig, "outDir" | "breakpoints" | "color" | "shimmerColor" | "animationDuration" | "contentAware" | "minBoneSize" | "classPrefix" | "inlineStyles" | "ssr">>;
+/** Map bone kind to numeric index for compression */
+declare const BONE_KIND_INDEX: Record<BoneKind, number>;
+declare const BONE_KIND_FROM_INDEX: Record<number, BoneKind>;
+
+export { type BreakpointData as B, type CastDOMConfig as C, DEFAULTS as D, type ExtractionResult as E, type RegistryEntry as R, type SkeletonData as S, type Bone as a, type CompressedBones as b, BONE_KIND_FROM_INDEX as c, BONE_KIND_INDEX as d, type BoneKind as e, type ExtractionTarget as f };

package/dist/vite.cjs

@@ -0,0 +1,83 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var chunkJRQ6EVQP_cjs = require('./chunk-JRQ6EVQP.cjs');
+
+// src/adapters/vite.ts
+var VIRTUAL_MODULE_ID = "virtual:castdom";
+var RESOLVED_VIRTUAL_MODULE_ID = "\0virtual:castdom";
+function castdom(options = {}) {
+  const outDir = options.outDir ?? chunkJRQ6EVQP_cjs.DEFAULTS.outDir;
+  let devPort = options.devPort;
+  return {
+    name: "castdom",
+    enforce: "pre",
+    configResolved(config) {
+      if (config.command === "serve") {
+        devPort ??= config.server?.port ?? 5173;
+      }
+    },
+    configureServer(server) {
+      devPort ??= server.config.server.port ?? 5173;
+      server.watcher.add(outDir);
+      server.middlewares.use((req, res, next) => {
+        if (req.url === "/__castdom/extract") {
+          res.writeHead(200, { "Content-Type": "application/json" });
+          res.end(JSON.stringify({ status: "ok", message: "Use npx castdom build" }));
+          return;
+        }
+        next();
+      });
+    },
+    resolveId(id) {
+      if (id === VIRTUAL_MODULE_ID) {
+        return RESOLVED_VIRTUAL_MODULE_ID;
+      }
+      return null;
+    },
+    load(id) {
+      if (id === RESOLVED_VIRTUAL_MODULE_ID) {
+        return `
+import { loadManifest } from "castdom";
+
+let manifest;
+try {
+  manifest = await import("${outDir}/manifest.json", { with: { type: "json" } });
+  loadManifest(manifest.default || manifest);
+} catch (e) {
+  console.warn("CastDOM: No manifest found. Run 'npx castdom build' to generate.");
+}
+
+export default manifest;
+`;
+      }
+      return null;
+    },
+    handleHotUpdate(ctx) {
+      if (ctx.file.includes(outDir)) {
+        ctx.server.ws.send({
+          type: "custom",
+          event: "castdom:update",
+          data: { file: ctx.file }
+        });
+      }
+    }
+  };
+}
+function castdomExtract(options = {}) {
+  return {
+    name: "castdom-extract",
+    enforce: "pre",
+    async buildStart() {
+      console.log("CastDOM: Ensure skeletons are up to date with 'npx castdom build'");
+    }
+  };
+}
+var vite_default = castdom;
+
+exports.castdom = castdom;
+exports.castdomExtract = castdomExtract;
+exports.default = vite_default;
+//# sourceMappingURL=vite.cjs.map
+//# sourceMappingURL=vite.cjs.map

package/dist/vite.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/vite.ts"],"names":["DEFAULTS"],"mappings":";;;;;;;AA4DA,IAAM,iBAAA,GAAoB,iBAAA;AAC1B,IAAM,0BAAA,GAA6B,mBAAA;AAE5B,SAAS,OAAA,CAAQ,OAAA,GAA8B,EAAC,EAAe;AACpE,EAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,MAAA,IAAUA,0BAAA,CAAS,MAAA;AAC1C,EAAA,IAAI,UAA8B,OAAA,CAAQ,OAAA;AAG1C,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,SAAA;AAAA,IACN,OAAA,EAAS,KAAA;AAAA,IAET,eAAe,MAAA,EAAQ;AACrB,MAAA,IAAI,MAAA,CAAO,YAAY,OAAA,EAAS;AAE9B,QAAA,OAAA,KAAY,MAAA,CAAO,QAAQ,IAAA,IAAQ,IAAA;AAAA,MACrC;AAAA,IACF,CAAA;AAAA,IAEA,gBAAgB,MAAA,EAAQ;AACtB,MAAA,OAAA,KAAY,MAAA,CAAO,MAAA,CAAO,MAAA,CAAO,IAAA,IAAQ,IAAA;AAGzC,MAAA,MAAA,CAAO,OAAA,CAAQ,IAAI,MAAM,CAAA;AAGzB,MAAA,MAAA,CAAO,WAAA,CAAY,GAAA,CAAI,CAAC,GAAA,EAAU,KAAU,IAAA,KAAc;AACxD,QAAA,IAAI,GAAA,CAAI,QAAQ,oBAAA,EAAsB;AAEpC,UAAA,GAAA,CAAI,SAAA,CAAU,GAAA,EAAK,EAAE,cAAA,EAAgB,oBAAoB,CAAA;AACzD,UAAA,GAAA,CAAI,GAAA,CAAI,KAAK,SAAA,CAAU,EAAE,QAAQ,IAAA,EAAM,OAAA,EAAS,uBAAA,EAAyB,CAAC,CAAA;AAC1E,UAAA;AAAA,QACF;AACA,QAAA,IAAA,EAAK;AAAA,MACP,CAAC,CAAA;AAAA,IACH,CAAA;AAAA,IAEA,UAAU,EAAA,EAAI;AACZ,MAAA,IAAI,OAAO,iBAAA,EAAmB;AAC5B,QAAA,OAAO,0BAAA;AAAA,MACT;AACA,MAAA,OAAO,IAAA;AAAA,IACT,CAAA;AAAA,IAEA,KAAK,EAAA,EAAI;AACP,MAAA,IAAI,OAAO,0BAAA,EAA4B;AAErC,QAAA,OAAO;AAAA;;AAAA;AAAA;AAAA,2BAAA,EAKc,MAAM,CAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA,CAAA;AAAA,MAQ7B;AACA,MAAA,OAAO,IAAA;AAAA,IACT,CAAA;AAAA,IAEA,gBAAgB,GAAA,EAAK;AAEnB,MAAA,IAAI,GAAA,CAAI,IAAA,CAAK,QAAA,CAAS,MAAM,CAAA,EAAG;AAC7B,QAAA,GAAA,CAAI,MAAA,CAAO,GAAG,IAAA,CAAK;AAAA,UACjB,IAAA,EAAM,QAAA;AAAA,UACN,KAAA,EAAO,gBAAA;AAAA,UACP,IAAA,EAAM,EAAE,IAAA,EAAM,GAAA,CAAI,IAAA;AAAK,SACxB,CAAA;AAAA,MACH;AAAA,IACF;AAAA,GACF;AACF;AAMO,SAAS,cAAA,CAAe,OAAA,GAA8B,EAAC,EAAe;AAC3E,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,iBAAA;AAAA,IACN,OAAA,EAAS,KAAA;AAAA,IAET,MAAM,UAAA,GAAa;AAGjB,MAAA,OAAA,CAAQ,IAAI,mEAAmE,CAAA;AAAA,IACjF;AAAA,GACF;AACF;AAEA,IAAO,YAAA,GAAQ","file":"vite.cjs","sourcesContent":["import type { CastDOMConfig, ExtractionTarget } from \"../core/types.js\";\nimport { DEFAULTS } from \"../core/types.js\";\n\n/**\n * Vite plugin for CastDOM.\n *\n * Features:\n * - Dev mode: live skeleton extraction from running dev server\n * - Build mode: pre-extract and embed skeleton data\n * - HMR: hot-reload skeleton changes\n * - Auto-discovery of [data-castdom] elements\n *\n * Usage:\n * ```ts\n * // vite.config.ts\n * import { castdom } from \"castdom/vite\";\n *\n * export default defineConfig({\n *   plugins: [castdom()],\n * });\n * ```\n */\n\nexport interface CastDOMViteOptions {\n  /** Path to castdom config file (default: \"castdom.config.json\") */\n  configPath?: string;\n  /** Output directory (default: \".castdom\") */\n  outDir?: string;\n  /** Dev server port to extract from (auto-detected if not set) */\n  devPort?: number;\n  /** Breakpoints to capture (default: [375, 768, 1280]) */\n  breakpoints?: number[];\n  /** Auto-extract on dev server start (default: false) */\n  autoExtract?: boolean;\n  /** Watch for changes and re-extract (default: true in dev) */\n  watch?: boolean;\n  /** Targets to extract (if not using config file) */\n  targets?: ExtractionTarget[];\n  /** Config overrides */\n  config?: Partial<CastDOMConfig>;\n}\n\ninterface VitePlugin {\n  name: string;\n  enforce?: \"pre\" | \"post\";\n  configResolved?: (config: { command: string; server?: { port?: number } }) => void;\n  configureServer?: (server: ViteDevServer) => void;\n  buildStart?: () => Promise<void>;\n  resolveId?: (id: string) => string | null;\n  load?: (id: string) => string | null;\n  handleHotUpdate?: (ctx: { file: string; server: ViteDevServer }) => void;\n}\n\ninterface ViteDevServer {\n  config: { server: { port?: number } };\n  ws: { send: (data: unknown) => void };\n  watcher: { add: (path: string) => void };\n  middlewares: { use: (fn: unknown) => void };\n}\n\nconst VIRTUAL_MODULE_ID = \"virtual:castdom\";\nconst RESOLVED_VIRTUAL_MODULE_ID = \"\\0virtual:castdom\";\n\nexport function castdom(options: CastDOMViteOptions = {}): VitePlugin {\n  const outDir = options.outDir ?? DEFAULTS.outDir;\n  let devPort: number | undefined = options.devPort;\n  let isServing = false;\n\n  return {\n    name: \"castdom\",\n    enforce: \"pre\",\n\n    configResolved(config) {\n      if (config.command === \"serve\") {\n        isServing = true;\n        devPort ??= config.server?.port ?? 5173;\n      }\n    },\n\n    configureServer(server) {\n      devPort ??= server.config.server.port ?? 5173;\n\n      // Watch the output directory for changes\n      server.watcher.add(outDir);\n\n      // Add dev middleware for on-demand extraction\n      server.middlewares.use((req: any, res: any, next: any) => {\n        if (req.url === \"/__castdom/extract\") {\n          // Trigger extraction via HTTP endpoint in dev\n          res.writeHead(200, { \"Content-Type\": \"application/json\" });\n          res.end(JSON.stringify({ status: \"ok\", message: \"Use npx castdom build\" }));\n          return;\n        }\n        next();\n      });\n    },\n\n    resolveId(id) {\n      if (id === VIRTUAL_MODULE_ID) {\n        return RESOLVED_VIRTUAL_MODULE_ID;\n      }\n      return null;\n    },\n\n    load(id) {\n      if (id === RESOLVED_VIRTUAL_MODULE_ID) {\n        // Provide a virtual module that loads the manifest\n        return `\nimport { loadManifest } from \"castdom\";\n\nlet manifest;\ntry {\n  manifest = await import(\"${outDir}/manifest.json\", { with: { type: \"json\" } });\n  loadManifest(manifest.default || manifest);\n} catch (e) {\n  console.warn(\"CastDOM: No manifest found. Run 'npx castdom build' to generate.\");\n}\n\nexport default manifest;\n`;\n      }\n      return null;\n    },\n\n    handleHotUpdate(ctx) {\n      // Hot-reload when skeleton data changes\n      if (ctx.file.includes(outDir)) {\n        ctx.server.ws.send({\n          type: \"custom\",\n          event: \"castdom:update\",\n          data: { file: ctx.file },\n        });\n      }\n    },\n  };\n}\n\n/**\n * Vite plugin for extracting skeletons during build.\n * Runs `castdom build` as part of the Vite build process.\n */\nexport function castdomExtract(options: CastDOMViteOptions = {}): VitePlugin {\n  return {\n    name: \"castdom-extract\",\n    enforce: \"pre\",\n\n    async buildStart() {\n      // Only extract during build, not serve\n      // The actual extraction is done via the CLI\n      console.log(\"CastDOM: Ensure skeletons are up to date with 'npx castdom build'\");\n    },\n  };\n}\n\nexport default castdom;\n"]}

package/dist/vite.d.cts

@@ -0,0 +1,81 @@
+import { f as ExtractionTarget, C as CastDOMConfig } from './types-ChD5jENU.cjs';
+
+/**
+ * Vite plugin for CastDOM.
+ *
+ * Features:
+ * - Dev mode: live skeleton extraction from running dev server
+ * - Build mode: pre-extract and embed skeleton data
+ * - HMR: hot-reload skeleton changes
+ * - Auto-discovery of [data-castdom] elements
+ *
+ * Usage:
+ * ```ts
+ * // vite.config.ts
+ * import { castdom } from "castdom/vite";
+ *
+ * export default defineConfig({
+ *   plugins: [castdom()],
+ * });
+ * ```
+ */
+interface CastDOMViteOptions {
+    /** Path to castdom config file (default: "castdom.config.json") */
+    configPath?: string;
+    /** Output directory (default: ".castdom") */
+    outDir?: string;
+    /** Dev server port to extract from (auto-detected if not set) */
+    devPort?: number;
+    /** Breakpoints to capture (default: [375, 768, 1280]) */
+    breakpoints?: number[];
+    /** Auto-extract on dev server start (default: false) */
+    autoExtract?: boolean;
+    /** Watch for changes and re-extract (default: true in dev) */
+    watch?: boolean;
+    /** Targets to extract (if not using config file) */
+    targets?: ExtractionTarget[];
+    /** Config overrides */
+    config?: Partial<CastDOMConfig>;
+}
+interface VitePlugin {
+    name: string;
+    enforce?: "pre" | "post";
+    configResolved?: (config: {
+        command: string;
+        server?: {
+            port?: number;
+        };
+    }) => void;
+    configureServer?: (server: ViteDevServer) => void;
+    buildStart?: () => Promise<void>;
+    resolveId?: (id: string) => string | null;
+    load?: (id: string) => string | null;
+    handleHotUpdate?: (ctx: {
+        file: string;
+        server: ViteDevServer;
+    }) => void;
+}
+interface ViteDevServer {
+    config: {
+        server: {
+            port?: number;
+        };
+    };
+    ws: {
+        send: (data: unknown) => void;
+    };
+    watcher: {
+        add: (path: string) => void;
+    };
+    middlewares: {
+        use: (fn: unknown) => void;
+    };
+}
+declare function castdom(options?: CastDOMViteOptions): VitePlugin;
+/**
+ * Vite plugin for extracting skeletons during build.
+ * Runs `castdom build` as part of the Vite build process.
+ */
+declare function castdomExtract(options?: CastDOMViteOptions): VitePlugin;
+
+export { type CastDOMViteOptions, castdom, castdomExtract, castdom as default };

package/dist/vite.d.ts

@@ -0,0 +1,81 @@
+import { f as ExtractionTarget, C as CastDOMConfig } from './types-ChD5jENU.js';
+
+/**
+ * Vite plugin for CastDOM.
+ *
+ * Features:
+ * - Dev mode: live skeleton extraction from running dev server
+ * - Build mode: pre-extract and embed skeleton data
+ * - HMR: hot-reload skeleton changes
+ * - Auto-discovery of [data-castdom] elements
+ *
+ * Usage:
+ * ```ts
+ * // vite.config.ts
+ * import { castdom } from "castdom/vite";
+ *
+ * export default defineConfig({
+ *   plugins: [castdom()],
+ * });
+ * ```
+ */
+interface CastDOMViteOptions {
+    /** Path to castdom config file (default: "castdom.config.json") */
+    configPath?: string;
+    /** Output directory (default: ".castdom") */
+    outDir?: string;
+    /** Dev server port to extract from (auto-detected if not set) */
+    devPort?: number;
+    /** Breakpoints to capture (default: [375, 768, 1280]) */
+    breakpoints?: number[];
+    /** Auto-extract on dev server start (default: false) */
+    autoExtract?: boolean;
+    /** Watch for changes and re-extract (default: true in dev) */
+    watch?: boolean;
+    /** Targets to extract (if not using config file) */
+    targets?: ExtractionTarget[];
+    /** Config overrides */
+    config?: Partial<CastDOMConfig>;
+}
+interface VitePlugin {
+    name: string;
+    enforce?: "pre" | "post";
+    configResolved?: (config: {
+        command: string;
+        server?: {
+            port?: number;
+        };
+    }) => void;
+    configureServer?: (server: ViteDevServer) => void;
+    buildStart?: () => Promise<void>;
+    resolveId?: (id: string) => string | null;
+    load?: (id: string) => string | null;
+    handleHotUpdate?: (ctx: {
+        file: string;
+        server: ViteDevServer;
+    }) => void;
+}
+interface ViteDevServer {
+    config: {
+        server: {
+            port?: number;
+        };
+    };
+    ws: {
+        send: (data: unknown) => void;
+    };
+    watcher: {
+        add: (path: string) => void;
+    };
+    middlewares: {
+        use: (fn: unknown) => void;
+    };
+}
+declare function castdom(options?: CastDOMViteOptions): VitePlugin;
+/**
+ * Vite plugin for extracting skeletons during build.
+ * Runs `castdom build` as part of the Vite build process.
+ */
+declare function castdomExtract(options?: CastDOMViteOptions): VitePlugin;
+
+export { type CastDOMViteOptions, castdom, castdomExtract, castdom as default };

package/dist/vite.js

@@ -0,0 +1,77 @@
+import { DEFAULTS } from './chunk-EJRNKHL5.js';
+
+// src/adapters/vite.ts
+var VIRTUAL_MODULE_ID = "virtual:castdom";
+var RESOLVED_VIRTUAL_MODULE_ID = "\0virtual:castdom";
+function castdom(options = {}) {
+  const outDir = options.outDir ?? DEFAULTS.outDir;
+  let devPort = options.devPort;
+  return {
+    name: "castdom",
+    enforce: "pre",
+    configResolved(config) {
+      if (config.command === "serve") {
+        devPort ??= config.server?.port ?? 5173;
+      }
+    },
+    configureServer(server) {
+      devPort ??= server.config.server.port ?? 5173;
+      server.watcher.add(outDir);
+      server.middlewares.use((req, res, next) => {
+        if (req.url === "/__castdom/extract") {
+          res.writeHead(200, { "Content-Type": "application/json" });
+          res.end(JSON.stringify({ status: "ok", message: "Use npx castdom build" }));
+          return;
+        }
+        next();
+      });
+    },
+    resolveId(id) {
+      if (id === VIRTUAL_MODULE_ID) {
+        return RESOLVED_VIRTUAL_MODULE_ID;
+      }
+      return null;
+    },
+    load(id) {
+      if (id === RESOLVED_VIRTUAL_MODULE_ID) {
+        return `
+import { loadManifest } from "castdom";
+
+let manifest;
+try {
+  manifest = await import("${outDir}/manifest.json", { with: { type: "json" } });
+  loadManifest(manifest.default || manifest);
+} catch (e) {
+  console.warn("CastDOM: No manifest found. Run 'npx castdom build' to generate.");
+}
+
+export default manifest;
+`;
+      }
+      return null;
+    },
+    handleHotUpdate(ctx) {
+      if (ctx.file.includes(outDir)) {
+        ctx.server.ws.send({
+          type: "custom",
+          event: "castdom:update",
+          data: { file: ctx.file }
+        });
+      }
+    }
+  };
+}
+function castdomExtract(options = {}) {
+  return {
+    name: "castdom-extract",
+    enforce: "pre",
+    async buildStart() {
+      console.log("CastDOM: Ensure skeletons are up to date with 'npx castdom build'");
+    }
+  };
+}
+var vite_default = castdom;
+
+export { castdom, castdomExtract, vite_default as default };
+//# sourceMappingURL=vite.js.map
+//# sourceMappingURL=vite.js.map

package/dist/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/vite.ts"],"names":[],"mappings":";;;AA4DA,IAAM,iBAAA,GAAoB,iBAAA;AAC1B,IAAM,0BAAA,GAA6B,mBAAA;AAE5B,SAAS,OAAA,CAAQ,OAAA,GAA8B,EAAC,EAAe;AACpE,EAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,MAAA,IAAU,QAAA,CAAS,MAAA;AAC1C,EAAA,IAAI,UAA8B,OAAA,CAAQ,OAAA;AAG1C,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,SAAA;AAAA,IACN,OAAA,EAAS,KAAA;AAAA,IAET,eAAe,MAAA,EAAQ;AACrB,MAAA,IAAI,MAAA,CAAO,YAAY,OAAA,EAAS;AAE9B,QAAA,OAAA,KAAY,MAAA,CAAO,QAAQ,IAAA,IAAQ,IAAA;AAAA,MACrC;AAAA,IACF,CAAA;AAAA,IAEA,gBAAgB,MAAA,EAAQ;AACtB,MAAA,OAAA,KAAY,MAAA,CAAO,MAAA,CAAO,MAAA,CAAO,IAAA,IAAQ,IAAA;AAGzC,MAAA,MAAA,CAAO,OAAA,CAAQ,IAAI,MAAM,CAAA;AAGzB,MAAA,MAAA,CAAO,WAAA,CAAY,GAAA,CAAI,CAAC,GAAA,EAAU,KAAU,IAAA,KAAc;AACxD,QAAA,IAAI,GAAA,CAAI,QAAQ,oBAAA,EAAsB;AAEpC,UAAA,GAAA,CAAI,SAAA,CAAU,GAAA,EAAK,EAAE,cAAA,EAAgB,oBAAoB,CAAA;AACzD,UAAA,GAAA,CAAI,GAAA,CAAI,KAAK,SAAA,CAAU,EAAE,QAAQ,IAAA,EAAM,OAAA,EAAS,uBAAA,EAAyB,CAAC,CAAA;AAC1E,UAAA;AAAA,QACF;AACA,QAAA,IAAA,EAAK;AAAA,MACP,CAAC,CAAA;AAAA,IACH,CAAA;AAAA,IAEA,UAAU,EAAA,EAAI;AACZ,MAAA,IAAI,OAAO,iBAAA,EAAmB;AAC5B,QAAA,OAAO,0BAAA;AAAA,MACT;AACA,MAAA,OAAO,IAAA;AAAA,IACT,CAAA;AAAA,IAEA,KAAK,EAAA,EAAI;AACP,MAAA,IAAI,OAAO,0BAAA,EAA4B;AAErC,QAAA,OAAO;AAAA;;AAAA;AAAA;AAAA,2BAAA,EAKc,MAAM,CAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA,CAAA;AAAA,MAQ7B;AACA,MAAA,OAAO,IAAA;AAAA,IACT,CAAA;AAAA,IAEA,gBAAgB,GAAA,EAAK;AAEnB,MAAA,IAAI,GAAA,CAAI,IAAA,CAAK,QAAA,CAAS,MAAM,CAAA,EAAG;AAC7B,QAAA,GAAA,CAAI,MAAA,CAAO,GAAG,IAAA,CAAK;AAAA,UACjB,IAAA,EAAM,QAAA;AAAA,UACN,KAAA,EAAO,gBAAA;AAAA,UACP,IAAA,EAAM,EAAE,IAAA,EAAM,GAAA,CAAI,IAAA;AAAK,SACxB,CAAA;AAAA,MACH;AAAA,IACF;AAAA,GACF;AACF;AAMO,SAAS,cAAA,CAAe,OAAA,GAA8B,EAAC,EAAe;AAC3E,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,iBAAA;AAAA,IACN,OAAA,EAAS,KAAA;AAAA,IAET,MAAM,UAAA,GAAa;AAGjB,MAAA,OAAA,CAAQ,IAAI,mEAAmE,CAAA;AAAA,IACjF;AAAA,GACF;AACF;AAEA,IAAO,YAAA,GAAQ","file":"vite.js","sourcesContent":["import type { CastDOMConfig, ExtractionTarget } from \"../core/types.js\";\nimport { DEFAULTS } from \"../core/types.js\";\n\n/**\n * Vite plugin for CastDOM.\n *\n * Features:\n * - Dev mode: live skeleton extraction from running dev server\n * - Build mode: pre-extract and embed skeleton data\n * - HMR: hot-reload skeleton changes\n * - Auto-discovery of [data-castdom] elements\n *\n * Usage:\n * ```ts\n * // vite.config.ts\n * import { castdom } from \"castdom/vite\";\n *\n * export default defineConfig({\n *   plugins: [castdom()],\n * });\n * ```\n */\n\nexport interface CastDOMViteOptions {\n  /** Path to castdom config file (default: \"castdom.config.json\") */\n  configPath?: string;\n  /** Output directory (default: \".castdom\") */\n  outDir?: string;\n  /** Dev server port to extract from (auto-detected if not set) */\n  devPort?: number;\n  /** Breakpoints to capture (default: [375, 768, 1280]) */\n  breakpoints?: number[];\n  /** Auto-extract on dev server start (default: false) */\n  autoExtract?: boolean;\n  /** Watch for changes and re-extract (default: true in dev) */\n  watch?: boolean;\n  /** Targets to extract (if not using config file) */\n  targets?: ExtractionTarget[];\n  /** Config overrides */\n  config?: Partial<CastDOMConfig>;\n}\n\ninterface VitePlugin {\n  name: string;\n  enforce?: \"pre\" | \"post\";\n  configResolved?: (config: { command: string; server?: { port?: number } }) => void;\n  configureServer?: (server: ViteDevServer) => void;\n  buildStart?: () => Promise<void>;\n  resolveId?: (id: string) => string | null;\n  load?: (id: string) => string | null;\n  handleHotUpdate?: (ctx: { file: string; server: ViteDevServer }) => void;\n}\n\ninterface ViteDevServer {\n  config: { server: { port?: number } };\n  ws: { send: (data: unknown) => void };\n  watcher: { add: (path: string) => void };\n  middlewares: { use: (fn: unknown) => void };\n}\n\nconst VIRTUAL_MODULE_ID = \"virtual:castdom\";\nconst RESOLVED_VIRTUAL_MODULE_ID = \"\\0virtual:castdom\";\n\nexport function castdom(options: CastDOMViteOptions = {}): VitePlugin {\n  const outDir = options.outDir ?? DEFAULTS.outDir;\n  let devPort: number | undefined = options.devPort;\n  let isServing = false;\n\n  return {\n    name: \"castdom\",\n    enforce: \"pre\",\n\n    configResolved(config) {\n      if (config.command === \"serve\") {\n        isServing = true;\n        devPort ??= config.server?.port ?? 5173;\n      }\n    },\n\n    configureServer(server) {\n      devPort ??= server.config.server.port ?? 5173;\n\n      // Watch the output directory for changes\n      server.watcher.add(outDir);\n\n      // Add dev middleware for on-demand extraction\n      server.middlewares.use((req: any, res: any, next: any) => {\n        if (req.url === \"/__castdom/extract\") {\n          // Trigger extraction via HTTP endpoint in dev\n          res.writeHead(200, { \"Content-Type\": \"application/json\" });\n          res.end(JSON.stringify({ status: \"ok\", message: \"Use npx castdom build\" }));\n          return;\n        }\n        next();\n      });\n    },\n\n    resolveId(id) {\n      if (id === VIRTUAL_MODULE_ID) {\n        return RESOLVED_VIRTUAL_MODULE_ID;\n      }\n      return null;\n    },\n\n    load(id) {\n      if (id === RESOLVED_VIRTUAL_MODULE_ID) {\n        // Provide a virtual module that loads the manifest\n        return `\nimport { loadManifest } from \"castdom\";\n\nlet manifest;\ntry {\n  manifest = await import(\"${outDir}/manifest.json\", { with: { type: \"json\" } });\n  loadManifest(manifest.default || manifest);\n} catch (e) {\n  console.warn(\"CastDOM: No manifest found. Run 'npx castdom build' to generate.\");\n}\n\nexport default manifest;\n`;\n      }\n      return null;\n    },\n\n    handleHotUpdate(ctx) {\n      // Hot-reload when skeleton data changes\n      if (ctx.file.includes(outDir)) {\n        ctx.server.ws.send({\n          type: \"custom\",\n          event: \"castdom:update\",\n          data: { file: ctx.file },\n        });\n      }\n    },\n  };\n}\n\n/**\n * Vite plugin for extracting skeletons during build.\n * Runs `castdom build` as part of the Vite build process.\n */\nexport function castdomExtract(options: CastDOMViteOptions = {}): VitePlugin {\n  return {\n    name: \"castdom-extract\",\n    enforce: \"pre\",\n\n    async buildStart() {\n      // Only extract during build, not serve\n      // The actual extraction is done via the CLI\n      console.log(\"CastDOM: Ensure skeletons are up to date with 'npx castdom build'\");\n    },\n  };\n}\n\nexport default castdom;\n"]}