@picked/vite-plugin-picked 0.0.1-dev.1787019239195 → 0.0.1-dev.1787543060859

package/dist/types/index.d.ts

@@ -1,5 +1,11 @@
 import type { Plugin } from 'vite';
 export interface PickedPluginOptions {
+    /**
+     * Send anonymous telemetry about the time this plugin adds to your build. Off unless
+     * set here, by `telemetry` in `picked.config`, or by `PICKED_TELEMETRY=1`. This option
+     * beats both; `PICKED_TELEMETRY=0` and `DO_NOT_TRACK=1` force it off.
+     */
+    telemetry?: boolean;
     /**
      * @deprecated Set `projectId` in `picked.config` instead, which the CLI and the type
      * generator read from too. Still honoured when `picked.config` omits it, and a future

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAqB,MAAM,EAAU,MAAM,MAAM,CAAA;AA+S7D,MAAM,WAAW,mBAAmB;IAClC;;;;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,CA8QhE"}
+{"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;;;;OAIG;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"}

package/dist/types/launcher.d.ts

@@ -1,4 +1,12 @@
 /** @file Dev launcher page: lists the project's feature flags and previews an experience. */
 import type { ProjectConfigFeature } from '@picked/delivery-api-client';
+/**
+ * Renders the dev launcher page: a URL box, the project's feature flags with an
+ * override picker each, and the script that assembles them into a preview URL.
+ *
+ * @param {ReadonlyArray<ProjectConfigFeature>} features - The project's features, in wire order.
+ * @returns {string} The complete HTML document.
+ * @example getLauncherHtml(config.features)
+ */
 export declare function getLauncherHtml(features: ReadonlyArray<ProjectConfigFeature>): string;
 //# sourceMappingURL=launcher.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"launcher.d.ts","sourceRoot":"","sources":["../../src/launcher.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAEvE,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,CAAC,oBAAoB,CAAC,GAAG,MAAM,CA+brF"}
+{"version":3,"file":"launcher.d.ts","sourceRoot":"","sources":["../../src/launcher.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAkDvE;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,CAAC,oBAAoB,CAAC,GAAG,MAAM,CAgcrF"}

package/dist/types/telemetry.d.ts

@@ -0,0 +1,44 @@
+import type { Plugin } from 'vite';
+import { type SpanAttributes } from '@picked/telemetry';
+/** Collects hook timings and sends them when the build ends. */
+export interface BuildTelemetry {
+    /** Records one hook invocation. */
+    record: (hook: string, durationMs: number) => void;
+    /** Sends everything collected. Always resolves. */
+    flush: (attributes: SpanAttributes) => Promise<void>;
+}
+/**
+ * Creates a telemetry collector for one build.
+ *
+ * @param {string} traceId - Trace all of this build's spans belong to.
+ * @returns {BuildTelemetry} A collector bound to that trace.
+ * @example const telemetry = createBuildTelemetry(createTraceId())
+ */
+export declare function createBuildTelemetry(traceId?: string): BuildTelemetry;
+/**
+ * Wraps a hook so its duration is recorded, preserving its return value.
+ *
+ * @template Args - The hook's argument tuple.
+ * @template Result - What the hook returns.
+ * @param {string} hook - The hook's name.
+ * @param {(...args: Args) => Result} handler - The original hook.
+ * @param {BuildTelemetry} telemetry - Where to record the timing.
+ * @returns {(...args: Args) => Result} The wrapped hook.
+ * @example instrumentHook('config', original, telemetry)
+ */
+export declare function instrumentHook<Args extends unknown[], Result>(hook: string, handler: (...args: Args) => Result, telemetry: BuildTelemetry): (...args: Args) => Result;
+/**
+ * Wraps every hook on the plugin so its duration is recorded.
+ *
+ * Applied to the whole object, so a hook added later is covered automatically.
+ * Vite accepts a hook as a function or as `{ order, handler }`, and both shapes
+ * are handled. Hooks are mutated in place and never bound, so Rollup's plugin
+ * context reaches them as `this`.
+ *
+ * @param {BuildTelemetry | null} telemetry - Collector, or `null` when telemetry is off.
+ * @param {Plugin} plugin - The plugin object to wrap.
+ * @returns {Plugin} The same plugin, with its hooks instrumented.
+ * @example instrumentPlugin(telemetry, { name: 'picked', config: async () => {} })
+ */
+export declare function instrumentPlugin(telemetry: BuildTelemetry | null, plugin: Plugin): Plugin;
+//# sourceMappingURL=telemetry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/telemetry.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAClC,OAAO,EAKL,KAAK,cAAc,EAEpB,MAAM,mBAAmB,CAAA;AAc1B,gEAAgE;AAChE,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAA;IAClD,mDAAmD;IACnD,KAAK,EAAE,CAAC,UAAU,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACrD;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,SAAkB,GAAG,cAAc,CAgE9E;AAaD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,EAC3D,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,EAClC,SAAS,EAAE,cAAc,GACxB,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,CA4B3B;AAgBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAwBzF"}

package/dist/types/util.d.ts

@@ -1,8 +1,9 @@
 /**
- * @file Shared utilities for the Picked Vite plugin. Currently exposes a single
- * defensive helper for handling API entity arrays that may be omitted at runtime
- * despite being typed as required.
+ * @file Shared utilities for the Picked Vite plugin: a defensive helper for API
+ * entity arrays that may be omitted at runtime despite being typed as required,
+ * and the console rendering of a feature's traffic split.
  */
+import type { ProjectConfigFeature } from '@picked/delivery-api-client';
 /**
  * Safely coerce a value to an array, returning an empty array for nullish inputs.
  * Needed because the API response may omit entity arrays at runtime even though
@@ -15,4 +16,19 @@
  * toArray(undefined) // []
  */
 export declare function toArray<T>(value: ReadonlyArray<T> | null | undefined): ReadonlyArray<T>;
+/**
+ * Renders a feature's traffic split for the dev-server console.
+ *
+ * A boolean feature reports `weight`, which is already a percentage. A text feature
+ * reports each arm against the total of the arms, since an arm's `weight` is a share
+ * relative to its siblings: `1` against `1, 2` is a quarter of the traffic.
+ *
+ * A feature whose arms are absent or all weigh zero reports its own weight.
+ *
+ * @param {ProjectConfigFeature} feature - The feature to describe.
+ * @returns {string} The split, as a percentage or a comma-separated list of arms.
+ * @example
+ * formatFeatureSplit({ valueType: 'text', variants: [{ key: 'a', value: 'a', weight: 1 }] })
+ */
+export declare function formatFeatureSplit(feature: ProjectConfigFeature): string;
 //# sourceMappingURL=util.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/util.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,aAAa,CAAC,CAAC,CAAC,CAEvF"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/util.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAEvE;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,aAAa,CAAC,CAAC,CAAC,CAEvF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAcxE"}

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@picked/vite-plugin-picked",
   "description": "Vite plugin for build-time config injection",
-  "version": "0.0.1-dev.1787019239195",
+  "version": "0.0.1-dev.1787543060859",
   "dependencies": {
-    "@picked/client": "0.0.1-dev.1787019239195",
-    "@picked/config": "0.0.1-dev.1787019239195",
-    "@picked/delivery-api-client": "0.0.1-dev.1787019239195",
-    "@picked/typegen": "0.0.1-dev.1787019239195"
+    "@picked/client": "0.0.1-dev.1787543060859",
+    "@picked/config": "0.0.1-dev.1787543060859",
+    "@picked/delivery-api-client": "0.0.1-dev.1787543060859",
+    "@picked/telemetry": "0.0.1-dev.1787543060859",
+    "@picked/typegen": "0.0.1-dev.1787543060859"
   },
   "devDependencies": {
     "@repo/eslint-config": "workspace:*",