@picked/vite-plugin-picked 0.0.107-next.2 → 0.0.107-next.4

package/dist/types/index.d.ts

@@ -24,28 +24,28 @@ export interface PickedPluginOptions {
     /** Generate TypeScript types from the workspace schema on dev/build. Defaults to true. */
     generateTypes?: boolean;
     /**
-     * Whether this build carries Picked data. Defaults to `'bundle'`.
-     *
-     * `'bundle'` prefetches the project config and each experience's content, writes `.picked/`, and
-     * emits a module that registers itself with the SDK. `'api'` skips the prefetch altogether —
-     * no build-time dependency on the Picked API and no `.picked/` directory — and emits a module
-     * the SDK's shape guard refuses, which leaves every read on the API path.
+     * @deprecated Set `data` in `picked.config` instead, which the CLI and the type generator
+     * read from too. Still honoured when `picked.config` omits `data`, and a future release
+     * drops it. Setting both to different values is an error.
      */
     mode?: 'bundle' | 'api';
 }
 /**
- * Vite plugin that fetches Picked project config + per-experience CMS content at build time
- * and exposes both via the `virtual:picked/data` virtual module.
+ * Vite plugin that exposes Picked project config + per-experience CMS content via the
+ * `virtual:picked/data` virtual module.
  *
- * Build mode (`vite build`) prefetches every CMS-using experience, writes JSON artefacts
- * to `<root>/.picked/`, and synthesises a virtual module that statically imports the
- * project config (so it's bundled) and lazily imports each experience's content on demand.
+ * Under `data: 'bundle'`, build mode (`vite build`) prefetches every CMS-using experience,
+ * writes JSON artefacts to `<root>/.picked/`, and synthesises a virtual module that statically
+ * imports the project config (so it's bundled) and lazily imports each experience's content on
+ * demand. Dev mode (`vite serve`) writes nothing to disk; the synthesised virtual module inlines
+ * the config the plugin fetched and fetches content per call.
  *
- * Dev mode (`vite serve`) writes nothing to disk; the synthesised virtual module performs
- * runtime API fetches via top-level `await` for project config and per-call for content.
+ * Under `data: 'snapshot'`, build and dev serve the committed `picked.snapshot.json` and fetch
+ * nothing. Under `data: 'api'`, nothing is fetched or embedded.
  *
- * Project identity — `projectId` and `apiUrl` — comes from `picked.config.{ts,js,json}` at the
- * project root, which the CLI and the type generator read from the same place.
+ * Project identity — `projectId` and `apiUrl` — and the data mode come from
+ * `picked.config.{ts,js,json}` at the project root, which the CLI and the type generator read
+ * from the same place.
  *
  * @param {PickedPluginOptions} options - Plugin configuration.
  * @returns {Plugin} A Vite plugin instance.

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAqB,MAAM,EAAU,MAAM,MAAM,CAAA;AAsU7D,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qFAAqF;IACrF,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,0FAA0F;IAC1F,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAA;CACxB;AA+BD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,MAAM,CAAC,OAAO,GAAE,mBAAwB,GAAG,MAAM,CA4RhE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAqB,MAAM,EAAU,MAAM,MAAM,CAAA;AAqb7D,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qFAAqF;IACrF,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,0FAA0F;IAC1F,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;;OAIG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAA;CACxB;AA+BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,MAAM,CAAC,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAuUhE"}

package/dist/types/virtual-module/snapshot.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @file Synthesis for `virtual:picked/data` when `picked.config` sets `data: 'snapshot'`.
+ *
+ * The module inlines the snapshot's project config and reaches each experience's content
+ * through its own virtual module, so build output keeps content in lazy chunks and nothing is
+ * written to disk. The same source serves build and serve.
+ */
+import type { PickedSnapshot } from '@picked/config';
+/** Prefix of the per-experience content modules the snapshot module imports. */
+export declare const SNAPSHOT_EXPERIENCE_MODULE_PREFIX = "virtual:picked/data/experience/";
+/**
+ * Synthesises the snapshot-mode `virtual:picked/data` module.
+ *
+ * @param {PickedSnapshot} snapshot - The snapshot the build serves.
+ * @returns {string} JavaScript source for Vite's `load` hook.
+ * @example
+ * const source = snapshotVirtualModuleSource(snapshot)
+ */
+export declare function snapshotVirtualModuleSource(snapshot: PickedSnapshot): string;
+/**
+ * Synthesises the module that exports the content of the experience at a position in
+ * `snapshot.experiences`.
+ *
+ * @param {PickedSnapshot} snapshot - The snapshot the build serves.
+ * @param {string} position - The module id's position segment.
+ * @returns {string} JavaScript source for Vite's `load` hook; it exports `null` for a position the snapshot does not hold.
+ * @example
+ * snapshotExperienceModuleSource(snapshot, '0')
+ */
+export declare function snapshotExperienceModuleSource(snapshot: PickedSnapshot, position: string): string;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/types/virtual-module/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../src/virtual-module/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAGpD,gFAAgF;AAChF,eAAO,MAAM,iCAAiC,oCAAoC,CAAA;AAElF;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAmC5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQjG"}

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@picked/vite-plugin-picked",
   "description": "Vite plugin for build-time config injection",
-  "version": "0.0.107-next.2",
+  "version": "0.0.107-next.4",
   "dependencies": {
-    "@picked/client": "0.0.107-next.2",
-    "@picked/config": "0.0.107-next.2",
-    "@picked/delivery-api-client": "0.0.107-next.2",
-    "@picked/telemetry": "0.0.107-next.2",
-    "@picked/typegen": "0.0.107-next.2"
+    "@picked/client": "0.0.107-next.4",
+    "@picked/config": "0.0.107-next.4",
+    "@picked/delivery-api-client": "0.0.107-next.4",
+    "@picked/telemetry": "0.0.107-next.4",
+    "@picked/typegen": "0.0.107-next.4"
   },
   "devDependencies": {
     "@repo/eslint-config": "workspace:*",
@@ -47,14 +47,15 @@
       "@picked/client",
       "@picked/delivery-api-client",
       "@picked/typegen",
+      "@picked/telemetry",
       "@picked/config",
       "@repo/eslint-config",
       "@repo/typescript-config",
-      "@vitest/coverage-v8",
       "@repo/vitest-config"
     ],
     "ignore": [
-      "eslint.config.js"
+      "eslint.config.js",
+      "src/__fixtures__/sdk-stub.ts"
     ]
   },
   "license": "SEE LICENSE IN LICENSE",