@westopp/windo 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (48) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +146 -0
  3. package/dist/chunk-5RM2VYAM.js +150 -0
  4. package/dist/chunk-5RM2VYAM.js.map +1 -0
  5. package/dist/cli.cjs +303 -0
  6. package/dist/cli.cjs.map +1 -0
  7. package/dist/cli.d.cts +1 -0
  8. package/dist/cli.d.ts +1 -0
  9. package/dist/cli.js +138 -0
  10. package/dist/cli.js.map +1 -0
  11. package/dist/index.cjs +219 -0
  12. package/dist/index.cjs.map +1 -0
  13. package/dist/index.d.cts +374 -0
  14. package/dist/index.d.ts +374 -0
  15. package/dist/index.js +182 -0
  16. package/dist/index.js.map +1 -0
  17. package/dist/plugin.cjs +185 -0
  18. package/dist/plugin.cjs.map +1 -0
  19. package/dist/plugin.d.cts +11 -0
  20. package/dist/plugin.d.ts +11 -0
  21. package/dist/plugin.js +11 -0
  22. package/dist/plugin.js.map +1 -0
  23. package/package.json +95 -0
  24. package/src/cli/index.ts +160 -0
  25. package/src/client/App.tsx +310 -0
  26. package/src/client/Canvas.tsx +358 -0
  27. package/src/client/Inspector.tsx +586 -0
  28. package/src/client/Sidebar.tsx +108 -0
  29. package/src/client/bridge.ts +124 -0
  30. package/src/client/chrome.css +1966 -0
  31. package/src/client/icons.tsx +110 -0
  32. package/src/client/index.ts +15 -0
  33. package/src/client/internal-types.ts +147 -0
  34. package/src/client/persist.ts +38 -0
  35. package/src/define-config.ts +54 -0
  36. package/src/descriptor.test.ts +59 -0
  37. package/src/descriptor.ts +185 -0
  38. package/src/globals.d.ts +9 -0
  39. package/src/index.ts +54 -0
  40. package/src/plugin/index.ts +181 -0
  41. package/src/preview/ctx.ts +43 -0
  42. package/src/preview/index.ts +283 -0
  43. package/src/preview/preview.css +81 -0
  44. package/src/preview/registry.ts +159 -0
  45. package/src/preview/render.tsx +90 -0
  46. package/src/preview/virtual.d.ts +8 -0
  47. package/src/protocol.ts +59 -0
  48. package/src/types.ts +319 -0
@@ -0,0 +1,374 @@
1
+ import { ComponentType, ReactNode } from 'react';
2
+ import { z } from 'zod';
3
+
4
+ type WindoStatus = 'stable' | 'beta' | 'deprecated';
5
+ declare const WINDO_STATUSES: readonly WindoStatus[];
6
+ /** Anchor a component within the canvas frame. */
7
+ type WindoPlacementBase = 'center' | 'fill' | 'top' | 'bottom' | 'left' | 'right' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
8
+ /**
9
+ * Where a component renders inside the canvas frame. Placements render flush by
10
+ * default; append `-padding` to inset the component from the frame edges
11
+ * (e.g. `top` sits flush at the top, `top-padding` adds breathing room).
12
+ */
13
+ type WindoPlacement = WindoPlacementBase | `${WindoPlacementBase}-padding`;
14
+ declare const WINDO_PLACEMENTS: readonly WindoPlacement[];
15
+ /** A configured group. Components reference a group by its `slug`. */
16
+ interface WindoGroup {
17
+ name: string;
18
+ slug: string;
19
+ description?: string;
20
+ }
21
+ type WindoControlType = 'enum' | 'boolean' | 'string' | 'number';
22
+ /** A single ambient control: a value plus the metadata to render its toggle. */
23
+ interface WindoControlSpec<T = unknown> {
24
+ type: WindoControlType;
25
+ label?: string;
26
+ default: T;
27
+ options?: readonly string[];
28
+ min?: number;
29
+ max?: number;
30
+ step?: number;
31
+ }
32
+ type WindoControlMap = Record<string, WindoControlSpec>;
33
+ /** Resolve a control map to the value object it produces. */
34
+ type WindoControlValues<C extends WindoControlMap> = {
35
+ [K in keyof C]: C[K] extends WindoControlSpec<infer T> ? T : never;
36
+ };
37
+ /**
38
+ * A named context. Two capabilities, either or both:
39
+ * - `controls` → ambient values + UI toggles (free, no opt-in needed)
40
+ * - `provider` → a React wrapper, mounted inside the iframe around components
41
+ * that opt in via `uses`
42
+ */
43
+ interface WindoContextDefinition<Values = unknown, Provided = Values> {
44
+ label?: string;
45
+ description?: string;
46
+ controls?: WindoControlMap;
47
+ provider?: ComponentType<{
48
+ children: ReactNode;
49
+ values: Values;
50
+ ctx: WindoRenderContext;
51
+ }>;
52
+ /** Derive the value exposed on `ctx.contexts[name]`. Defaults to the control values. */
53
+ resolve?: (values: Values, ctx: WindoRenderContext) => Provided;
54
+ }
55
+ type WindoContextMap = Record<string, WindoContextDefinition<any, any>>;
56
+ interface WindoViewport {
57
+ width: number;
58
+ height: number;
59
+ name: 'mobile' | 'tablet' | 'desktop';
60
+ }
61
+ /** Console channel: `ctx.logger.log(…)` posts an entry to the chrome's Console tab. */
62
+ interface WindoLogger {
63
+ log: (...args: unknown[]) => void;
64
+ }
65
+ /** How an action fires. `click` renders a toolbar button; the rest bind to the stage's pointer events. */
66
+ type WindoActionTrigger = 'click' | 'enter' | 'exit' | 'hover';
67
+ declare const WINDO_ACTION_TRIGGERS: readonly WindoActionTrigger[];
68
+ /**
69
+ * An out-of-band action that drives a component's state. `click` actions render as
70
+ * toolbar buttons; `enter`/`exit`/`hover` bind to the stage's pointer events. `run`
71
+ * receives the live ctx and an `active` flag — for `hover` it is `true` on
72
+ * pointer-enter and `false` on pointer-leave; for the others it is always `true`.
73
+ */
74
+ interface WindoAction<State = unknown> {
75
+ label: string;
76
+ /** Defaults to `click`. */
77
+ on?: WindoActionTrigger;
78
+ run: (ctx: WindoRenderContext<State>, active: boolean) => void;
79
+ /** Greys out a `click` action's toolbar button. Evaluated against the live state. */
80
+ disabled?: (ctx: WindoRenderContext<State>) => boolean;
81
+ }
82
+ /** Live environment handed to every render-time function inside the iframe. */
83
+ interface WindoRenderContext<State = unknown> {
84
+ colorScheme: 'light' | 'dark';
85
+ viewport: WindoViewport;
86
+ reducedMotion: boolean;
87
+ direction: 'ltr' | 'rtl';
88
+ locale: string;
89
+ logger: WindoLogger;
90
+ /** Current component-local state, typed by the windo's `State` generic. */
91
+ state: State;
92
+ /** Merge a patch into the component-local state and re-render. */
93
+ setState: (patch: Partial<State>) => void;
94
+ /** Resolved values of opted-in contexts, keyed by context name. */
95
+ contexts: Record<string, unknown>;
96
+ }
97
+ /** A variant: a label plus a partial prop patch. Renders in the gallery and is click-to-apply. */
98
+ interface WindoVariant<Props> {
99
+ label: string;
100
+ props: Partial<Props>;
101
+ }
102
+ /** A row in the authored Props documentation table. */
103
+ interface WindoPropDoc {
104
+ name: string;
105
+ type: string;
106
+ default?: string;
107
+ desc?: string;
108
+ }
109
+ type WindoDefaultProps<Props, State = unknown> = Props | ((ctx: WindoRenderContext<State>) => Props);
110
+ /**
111
+ * The object returned by a `windo(...)` factory.
112
+ *
113
+ * Keystone rule: the surrounding factory runs ONCE (definition-time) for static
114
+ * fields (title, group, schema). Every function field below — `defaultProps`,
115
+ * `actions`, `providers`, `component` — runs at render-time with the live `ctx`.
116
+ * Never close over live values in the static factory body.
117
+ */
118
+ interface WindoDefinition<Props = unknown, State = unknown, GroupSlug extends string = string> {
119
+ title: string;
120
+ group: GroupSlug;
121
+ status?: WindoStatus;
122
+ description?: string;
123
+ deprecation?: string;
124
+ placement?: WindoPlacement;
125
+ /** Initial component-local state. Its shape is the `State` generic; `ctx.state`/`ctx.setState` derive from it. */
126
+ state?: State;
127
+ /** Out-of-band actions that drive state: toolbar buttons (`click`) and stage pointer triggers (`enter`/`exit`/`hover`). */
128
+ actions?: WindoAction<State>[];
129
+ /** zod schema: validator + parser for the JSON-editable prop subset. `z.output ⊆ Props`. */
130
+ configurableProps?: z.ZodType;
131
+ /** Full props incl. functions/JSX. The editor's JSON overrides merge on top. */
132
+ defaultProps: WindoDefaultProps<Props, State>;
133
+ /** Names of provider contexts this component opts into. */
134
+ uses?: string[];
135
+ variants?: WindoVariant<Props>[];
136
+ /** Authored documentation table (not derived from the schema). */
137
+ props?: WindoPropDoc[];
138
+ /** Optional authored code snippet for the Code tab. */
139
+ code?: (values: Props) => string;
140
+ /** A local provider wrapping just this windo (in addition to `uses`). */
141
+ providers?: ComponentType<{
142
+ children: ReactNode;
143
+ ctx: WindoRenderContext<State>;
144
+ }>;
145
+ component: (props: Props, ctx: WindoRenderContext<State>) => ReactNode;
146
+ }
147
+ /** Argument handed to the `windo(w => ...)` factory. */
148
+ interface WindoFactoryArg<Groups extends readonly WindoGroup[], Contexts extends WindoContextMap> {
149
+ /** Configured groups keyed by slug. */
150
+ groups: Record<Groups[number]['slug'], WindoGroup>;
151
+ contexts: Contexts;
152
+ }
153
+ /**
154
+ * The default export of a `*.windo.tsx` file. A branded, lazily-resolved
155
+ * definition — the runtime calls `resolve(w)` with the config-derived factory arg.
156
+ */
157
+ interface WindoModule<Props = any, State = any> {
158
+ readonly __windo: true;
159
+ resolve: (w: WindoFactoryArg<readonly WindoGroup[], WindoContextMap>) => WindoDefinition<Props, State>;
160
+ }
161
+ interface WindoConfig<Groups extends readonly WindoGroup[] = readonly WindoGroup[], Contexts extends WindoContextMap = WindoContextMap> {
162
+ /** Configured groups. A component's `group` must be one of these slugs. */
163
+ groups: Groups;
164
+ /** Named contexts available to components. */
165
+ contexts?: Contexts;
166
+ /** Glob(s) for discovery, relative to project root. Default `**\/*.windo.tsx`. */
167
+ include?: string | string[];
168
+ /** Title shown in the workbench chrome. */
169
+ title?: string;
170
+ }
171
+ type WindoControlKind = 'string' | 'number' | 'boolean' | 'enum' | 'date' | 'array' | 'object' | 'unknown';
172
+ interface WindoControlDescriptor {
173
+ key: string;
174
+ kind: WindoControlKind;
175
+ optional: boolean;
176
+ options?: string[];
177
+ min?: number;
178
+ max?: number;
179
+ description?: string;
180
+ }
181
+ interface WindoSchemaDescriptor {
182
+ fields: WindoControlDescriptor[];
183
+ }
184
+ /** Serialisable metadata for one action — drives the canvas toolbar. */
185
+ interface WindoActionMeta {
186
+ id: string;
187
+ label: string;
188
+ on: WindoActionTrigger;
189
+ }
190
+ /** Static, serialisable metadata for one windo — drives the sidebar. */
191
+ interface WindoManifestEntry {
192
+ id: string;
193
+ title: string;
194
+ group: string;
195
+ status: WindoStatus;
196
+ description?: string;
197
+ deprecation?: string;
198
+ placement: WindoPlacement;
199
+ uses: string[];
200
+ hasVariants: boolean;
201
+ actions: WindoActionMeta[];
202
+ hasState: boolean;
203
+ }
204
+ interface WindoVariantMeta {
205
+ label: string;
206
+ props: Record<string, unknown>;
207
+ }
208
+ /** Ambient environment pushed from the chrome down into the iframe. */
209
+ interface WindoEnvState {
210
+ colorScheme: 'light' | 'dark';
211
+ viewport: WindoViewport;
212
+ reducedMotion: boolean;
213
+ direction: 'ltr' | 'rtl';
214
+ locale: string;
215
+ /** Per-context control values, keyed by context name then control key. */
216
+ contexts: Record<string, Record<string, unknown>>;
217
+ }
218
+ interface WindoLogEntry {
219
+ ts: number;
220
+ args: unknown[];
221
+ }
222
+ interface WindoFieldError {
223
+ path: string;
224
+ message: string;
225
+ }
226
+ interface WindoContextControlMeta {
227
+ key: string;
228
+ type: WindoControlType;
229
+ label?: string;
230
+ options?: string[];
231
+ default: unknown;
232
+ min?: number;
233
+ max?: number;
234
+ step?: number;
235
+ }
236
+ interface WindoContextMeta {
237
+ name: string;
238
+ label?: string;
239
+ description?: string;
240
+ /** True when the context contributes controls (ambient values). */
241
+ ambient: boolean;
242
+ /** True when the context mounts a provider (opt-in via `uses`). */
243
+ hasProvider: boolean;
244
+ controls: WindoContextControlMeta[];
245
+ }
246
+
247
+ interface DefineWindoConfigResult<Groups extends readonly WindoGroup[], Contexts extends WindoContextMap> {
248
+ config: WindoConfig<Groups, Contexts>;
249
+ windo: <Props, State = Record<string, never>>(factory: (w: WindoFactoryArg<Groups, Contexts>) => WindoDefinition<Props, State, Groups[number]['slug']>) => WindoModule<Props, State>;
250
+ }
251
+ declare function defineWindoConfig<const Groups extends readonly WindoGroup[], Contexts extends WindoContextMap = Record<string, never>>(config: WindoConfig<Groups, Contexts>): DefineWindoConfigResult<Groups, Contexts>;
252
+ /**
253
+ * Define a named context. A context can contribute ambient `controls` (values +
254
+ * UI), a `provider` (mounted inside the iframe for components that opt in via
255
+ * `uses`), or both.
256
+ *
257
+ * No cast: `def` is already structurally a `WindoContextDefinition<WindoControlValues<C>,
258
+ * Provided>` (only `controls` widens, covariantly). The unavoidable variance — TS has
259
+ * no existential type to hold contexts heterogeneous in `C` — is absorbed once, in
260
+ * `WindoContextMap`, not here and not at call sites.
261
+ */
262
+ declare function defineContext<C extends WindoControlMap, Provided = WindoControlValues<C>>(def: {
263
+ label?: string;
264
+ description?: string;
265
+ controls?: C;
266
+ provider?: ComponentType<{
267
+ children: ReactNode;
268
+ values: WindoControlValues<C>;
269
+ ctx: WindoRenderContext;
270
+ }>;
271
+ resolve?: (values: WindoControlValues<C>, ctx: WindoRenderContext) => Provided;
272
+ }): WindoContextDefinition<WindoControlValues<C>, Provided>;
273
+ /**
274
+ * Bind a zod schema to a component's props. The generic carries the component's
275
+ * prop type so the schema's output stays a subset of it; the returned schema is
276
+ * the runtime validator + parser (`z.input` is the JSON edit surface, `z.output`
277
+ * is what the component receives).
278
+ */
279
+ declare function configurableProps<P>(): <S extends z.ZodType<Partial<P>>>(schema: S) => S;
280
+
281
+ declare function describeSchema(schema: z.ZodType | undefined | null): WindoSchemaDescriptor;
282
+
283
+ declare const WINDO_MSG = "windo";
284
+ /** chrome -> iframe */
285
+ type WindoHostMessage = {
286
+ source: typeof WINDO_MSG;
287
+ dir: 'host';
288
+ type: 'request-manifest';
289
+ } | {
290
+ source: typeof WINDO_MSG;
291
+ dir: 'host';
292
+ type: 'select';
293
+ id: string;
294
+ } | {
295
+ source: typeof WINDO_MSG;
296
+ dir: 'host';
297
+ type: 'set-props';
298
+ id: string;
299
+ json: string;
300
+ } | {
301
+ source: typeof WINDO_MSG;
302
+ dir: 'host';
303
+ type: 'set-env';
304
+ env: WindoEnvState;
305
+ } | {
306
+ source: typeof WINDO_MSG;
307
+ dir: 'host';
308
+ type: 'invoke-action';
309
+ id: string;
310
+ actionId: string;
311
+ };
312
+ /** iframe -> chrome */
313
+ type WindoPreviewMessage = {
314
+ source: typeof WINDO_MSG;
315
+ dir: 'preview';
316
+ type: 'ready';
317
+ } | {
318
+ source: typeof WINDO_MSG;
319
+ dir: 'preview';
320
+ type: 'manifest';
321
+ title: string;
322
+ entries: WindoManifestEntry[];
323
+ groups: WindoGroup[];
324
+ contexts: WindoContextMeta[];
325
+ } | {
326
+ source: typeof WINDO_MSG;
327
+ dir: 'preview';
328
+ type: 'describe';
329
+ id: string;
330
+ descriptor: WindoSchemaDescriptor;
331
+ props: WindoPropDoc[];
332
+ variants: WindoVariantMeta[];
333
+ defaults: unknown;
334
+ code: string | null;
335
+ } | {
336
+ source: typeof WINDO_MSG;
337
+ dir: 'preview';
338
+ type: 'parse-ok';
339
+ id: string;
340
+ } | {
341
+ source: typeof WINDO_MSG;
342
+ dir: 'preview';
343
+ type: 'parse-error';
344
+ id: string;
345
+ errors: WindoFieldError[];
346
+ } | {
347
+ source: typeof WINDO_MSG;
348
+ dir: 'preview';
349
+ type: 'log';
350
+ entry: WindoLogEntry;
351
+ } | {
352
+ source: typeof WINDO_MSG;
353
+ dir: 'preview';
354
+ type: 'state';
355
+ id: string;
356
+ state: Record<string, unknown>;
357
+ actions: {
358
+ id: string;
359
+ disabled: boolean;
360
+ }[];
361
+ } | {
362
+ source: typeof WINDO_MSG;
363
+ dir: 'preview';
364
+ type: 'render-error';
365
+ id: string;
366
+ message: string;
367
+ stack?: string;
368
+ };
369
+ type WindoMessage = WindoHostMessage | WindoPreviewMessage;
370
+ declare function isWindoMessage(data: unknown): data is WindoMessage;
371
+ declare function isHostMessage(msg: WindoMessage): msg is WindoHostMessage;
372
+ declare function isPreviewMessage(msg: WindoMessage): msg is WindoPreviewMessage;
373
+
374
+ export { type DefineWindoConfigResult, WINDO_ACTION_TRIGGERS, WINDO_MSG, WINDO_PLACEMENTS, WINDO_STATUSES, type WindoAction, type WindoActionMeta, type WindoActionTrigger, type WindoConfig, type WindoContextControlMeta, type WindoContextDefinition, type WindoContextMap, type WindoContextMeta, type WindoControlDescriptor, type WindoControlKind, type WindoControlMap, type WindoControlSpec, type WindoControlType, type WindoControlValues, type WindoDefaultProps, type WindoDefinition, type WindoEnvState, type WindoFactoryArg, type WindoFieldError, type WindoGroup, type WindoHostMessage, type WindoLogEntry, type WindoLogger, type WindoManifestEntry, type WindoMessage, type WindoModule, type WindoPlacement, type WindoPreviewMessage, type WindoPropDoc, type WindoRenderContext, type WindoSchemaDescriptor, type WindoStatus, type WindoVariant, type WindoVariantMeta, type WindoViewport, configurableProps, defineContext, defineWindoConfig, describeSchema, isHostMessage, isPreviewMessage, isWindoMessage };
package/dist/index.js ADDED
@@ -0,0 +1,182 @@
1
+ // src/define-config.ts
2
+ function defineWindoConfig(config) {
3
+ function windo(factory) {
4
+ return {
5
+ __windo: true,
6
+ resolve: (w) => factory(w)
7
+ };
8
+ }
9
+ return { config, windo };
10
+ }
11
+ function defineContext(def) {
12
+ return def;
13
+ }
14
+ function configurableProps() {
15
+ return (schema) => schema;
16
+ }
17
+
18
+ // src/descriptor.ts
19
+ import { z } from "zod";
20
+ function describeSchema(schema) {
21
+ if (!schema) return { fields: [] };
22
+ let json;
23
+ try {
24
+ json = z.toJSONSchema(schema, { io: "input", unrepresentable: "any" });
25
+ } catch {
26
+ return { fields: [] };
27
+ }
28
+ const root = unwrap(json);
29
+ const properties = root.properties ?? {};
30
+ const required = new Set(root.required ?? []);
31
+ const zodKinds = shapeKinds(schema);
32
+ const fields = Object.keys(properties).map((key) => fieldFrom(key, properties[key], required.has(key), zodKinds[key]));
33
+ return { fields };
34
+ }
35
+ function unwrap(node) {
36
+ if (node.properties) return node;
37
+ const branches = node.anyOf ?? node.oneOf ?? node.allOf;
38
+ if (branches) {
39
+ const withProps = branches.find((b) => b.properties);
40
+ if (withProps) return withProps;
41
+ }
42
+ return node;
43
+ }
44
+ function fieldFrom(key, node, isRequired, zodKind) {
45
+ const inner = collapseNullable(node);
46
+ let kind = kindOf(inner);
47
+ if (zodKind && (kind === "unknown" || zodKind === "date")) kind = zodKind;
48
+ const descriptor = {
49
+ key,
50
+ kind,
51
+ optional: !isRequired || isNullable(node)
52
+ };
53
+ if (inner.description) descriptor.description = inner.description;
54
+ const options = enumOptions(inner);
55
+ if (options) descriptor.options = options;
56
+ if (typeof inner.minimum === "number") descriptor.min = inner.minimum;
57
+ if (typeof inner.maximum === "number") descriptor.max = inner.maximum;
58
+ return descriptor;
59
+ }
60
+ function isNullable(node) {
61
+ const branches = node.anyOf ?? node.oneOf;
62
+ if (!branches) return false;
63
+ return branches.some((b) => b.type === "null");
64
+ }
65
+ function collapseNullable(node) {
66
+ const branches = node.anyOf ?? node.oneOf;
67
+ if (!branches) return node;
68
+ const nonNull = branches.filter((b) => b.type !== "null");
69
+ if (nonNull.length === 1) return nonNull[0];
70
+ return node;
71
+ }
72
+ function enumOptions(node) {
73
+ if (Array.isArray(node.enum)) return node.enum.map((v) => String(v));
74
+ const branches = node.anyOf ?? node.oneOf;
75
+ if (branches?.every((b) => b.const !== void 0)) {
76
+ return branches.map((b) => String(b.const));
77
+ }
78
+ return void 0;
79
+ }
80
+ function kindOf(node) {
81
+ if (Array.isArray(node.enum) || (node.anyOf?.every((b) => b.const !== void 0) ?? false)) return "enum";
82
+ if (node.format === "date-time" || node.format === "date") return "date";
83
+ const type = Array.isArray(node.type) ? node.type.find((t) => t !== "null") : node.type;
84
+ switch (type) {
85
+ case "string":
86
+ return "string";
87
+ case "number":
88
+ case "integer":
89
+ return "number";
90
+ case "boolean":
91
+ return "boolean";
92
+ case "array":
93
+ return "array";
94
+ case "object":
95
+ return "object";
96
+ default:
97
+ return "unknown";
98
+ }
99
+ }
100
+ function zodDef(node) {
101
+ const n = node;
102
+ if (!n || typeof n !== "object") return void 0;
103
+ return n.def ?? n._zod?.def;
104
+ }
105
+ var ZOD_WRAPPERS = /* @__PURE__ */ new Set(["optional", "nullable", "default", "prefault", "catch", "readonly", "nonoptional", "lazy"]);
106
+ function unwrapZodDef(node) {
107
+ let def = zodDef(node);
108
+ let guard = 0;
109
+ while (def && def.innerType && ZOD_WRAPPERS.has(def.type ?? "") && guard++ < 16) {
110
+ def = zodDef(def.innerType);
111
+ }
112
+ return def;
113
+ }
114
+ function mapZodType(type) {
115
+ switch (type) {
116
+ case "date":
117
+ return "date";
118
+ case "string":
119
+ return "string";
120
+ case "number":
121
+ case "int":
122
+ case "bigint":
123
+ return "number";
124
+ case "boolean":
125
+ return "boolean";
126
+ case "array":
127
+ case "set":
128
+ case "tuple":
129
+ return "array";
130
+ case "object":
131
+ case "record":
132
+ case "map":
133
+ return "object";
134
+ case "enum":
135
+ case "literal":
136
+ return "enum";
137
+ default:
138
+ return void 0;
139
+ }
140
+ }
141
+ function shapeKinds(schema) {
142
+ const shape = schema.shape;
143
+ if (!shape || typeof shape !== "object") return {};
144
+ const out = {};
145
+ for (const key of Object.keys(shape)) {
146
+ const kind = mapZodType(unwrapZodDef(shape[key])?.type);
147
+ if (kind) out[key] = kind;
148
+ }
149
+ return out;
150
+ }
151
+
152
+ // src/protocol.ts
153
+ var WINDO_MSG = "windo";
154
+ function isWindoMessage(data) {
155
+ return typeof data === "object" && data !== null && data.source === WINDO_MSG;
156
+ }
157
+ function isHostMessage(msg) {
158
+ return msg.dir === "host";
159
+ }
160
+ function isPreviewMessage(msg) {
161
+ return msg.dir === "preview";
162
+ }
163
+
164
+ // src/types.ts
165
+ var WINDO_STATUSES = ["stable", "beta", "deprecated"];
166
+ var WINDO_PLACEMENT_BASE = ["center", "fill", "top", "bottom", "left", "right", "top-left", "top-right", "bottom-left", "bottom-right"];
167
+ var WINDO_PLACEMENTS = [...WINDO_PLACEMENT_BASE, ...WINDO_PLACEMENT_BASE.map((p) => `${p}-padding`)];
168
+ var WINDO_ACTION_TRIGGERS = ["click", "enter", "exit", "hover"];
169
+ export {
170
+ WINDO_ACTION_TRIGGERS,
171
+ WINDO_MSG,
172
+ WINDO_PLACEMENTS,
173
+ WINDO_STATUSES,
174
+ configurableProps,
175
+ defineContext,
176
+ defineWindoConfig,
177
+ describeSchema,
178
+ isHostMessage,
179
+ isPreviewMessage,
180
+ isWindoMessage
181
+ };
182
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/define-config.ts","../src/descriptor.ts","../src/protocol.ts","../src/types.ts"],"sourcesContent":["// The authoring API. `defineWindoConfig` is the single entry point: it captures\n// the project's groups + contexts and hands back a `windo` factory whose `group`\n// field is type-checked against the configured slugs.\n\nimport type { ComponentType, ReactNode } from 'react'\nimport type { z } from 'zod'\nimport type { WindoConfig, WindoContextDefinition, WindoContextMap, WindoControlMap, WindoControlValues, WindoDefinition, WindoFactoryArg, WindoGroup, WindoModule, WindoRenderContext } from './types'\n\nexport interface DefineWindoConfigResult<Groups extends readonly WindoGroup[], Contexts extends WindoContextMap> {\n config: WindoConfig<Groups, Contexts>\n windo: <Props, State = Record<string, never>>(factory: (w: WindoFactoryArg<Groups, Contexts>) => WindoDefinition<Props, State, Groups[number]['slug']>) => WindoModule<Props, State>\n}\n\nexport function defineWindoConfig<const Groups extends readonly WindoGroup[], Contexts extends WindoContextMap = Record<string, never>>(\n config: WindoConfig<Groups, Contexts>\n): DefineWindoConfigResult<Groups, Contexts> {\n function windo<Props, State = Record<string, never>>(factory: (w: WindoFactoryArg<Groups, Contexts>) => WindoDefinition<Props, State, Groups[number]['slug']>): WindoModule<Props, State> {\n return {\n __windo: true,\n resolve: w => factory(w as unknown as WindoFactoryArg<Groups, Contexts>),\n }\n }\n return { config, windo }\n}\n\n/**\n * Define a named context. A context can contribute ambient `controls` (values +\n * UI), a `provider` (mounted inside the iframe for components that opt in via\n * `uses`), or both.\n *\n * No cast: `def` is already structurally a `WindoContextDefinition<WindoControlValues<C>,\n * Provided>` (only `controls` widens, covariantly). The unavoidable variance — TS has\n * no existential type to hold contexts heterogeneous in `C` — is absorbed once, in\n * `WindoContextMap`, not here and not at call sites.\n */\nexport function defineContext<C extends WindoControlMap, Provided = WindoControlValues<C>>(def: {\n label?: string\n description?: string\n controls?: C\n provider?: ComponentType<{ children: ReactNode; values: WindoControlValues<C>; ctx: WindoRenderContext }>\n resolve?: (values: WindoControlValues<C>, ctx: WindoRenderContext) => Provided\n}): WindoContextDefinition<WindoControlValues<C>, Provided> {\n return def\n}\n\n/**\n * Bind a zod schema to a component's props. The generic carries the component's\n * prop type so the schema's output stays a subset of it; the returned schema is\n * the runtime validator + parser (`z.input` is the JSON edit surface, `z.output`\n * is what the component receives).\n */\nexport function configurableProps<P>() {\n return <S extends z.ZodType<Partial<P>>>(schema: S): S => schema\n}\n","// Walk a zod schema into a serialisable descriptor that can cross the iframe\n// boundary and render the Controls/Schema UI. We lean on `z.toJSONSchema` (zod\n// v4) for the input shape (enum options, min/max, optionality), then enrich the\n// kind from the zod node's own type tag — some types (Date, Map, Set) are\n// unrepresentable in JSON Schema and come back as `{}`, but their zod `def.type`\n// is exact. The live schema (with transforms/coerce/refine) stays in the iframe\n// and does the actual parsing — only this descriptor travels.\n\nimport { z } from 'zod'\nimport type { WindoControlDescriptor, WindoControlKind, WindoSchemaDescriptor } from './types'\n\ninterface JsonNode {\n type?: string | string[]\n enum?: unknown[]\n const?: unknown\n format?: string\n properties?: Record<string, JsonNode>\n required?: string[]\n items?: JsonNode\n anyOf?: JsonNode[]\n oneOf?: JsonNode[]\n allOf?: JsonNode[]\n minimum?: number\n maximum?: number\n description?: string\n}\n\nexport function describeSchema(schema: z.ZodType | undefined | null): WindoSchemaDescriptor {\n if (!schema) return { fields: [] }\n let json: JsonNode\n try {\n json = z.toJSONSchema(schema, { io: 'input', unrepresentable: 'any' }) as JsonNode\n } catch {\n return { fields: [] }\n }\n const root = unwrap(json)\n const properties = root.properties ?? {}\n const required = new Set(root.required ?? [])\n const zodKinds = shapeKinds(schema)\n const fields: WindoControlDescriptor[] = Object.keys(properties).map(key => fieldFrom(key, properties[key], required.has(key), zodKinds[key]))\n return { fields }\n}\n\n// JSON Schema often wraps the object in anyOf (for optional/nullable). Find the\n// node that actually carries the object's properties.\nfunction unwrap(node: JsonNode): JsonNode {\n if (node.properties) return node\n const branches = node.anyOf ?? node.oneOf ?? node.allOf\n if (branches) {\n const withProps = branches.find(b => b.properties)\n if (withProps) return withProps\n }\n return node\n}\n\nfunction fieldFrom(key: string, node: JsonNode, isRequired: boolean, zodKind?: WindoControlKind): WindoControlDescriptor {\n const inner = collapseNullable(node)\n let kind = kindOf(inner)\n // The zod tag wins for types JSON Schema can't express (date/array/object that\n // came back as {}), and as a fallback whenever the JSON kind is unknown.\n if (zodKind && (kind === 'unknown' || zodKind === 'date')) kind = zodKind\n const descriptor: WindoControlDescriptor = {\n key,\n kind,\n optional: !isRequired || isNullable(node),\n }\n if (inner.description) descriptor.description = inner.description\n const options = enumOptions(inner)\n if (options) descriptor.options = options\n if (typeof inner.minimum === 'number') descriptor.min = inner.minimum\n if (typeof inner.maximum === 'number') descriptor.max = inner.maximum\n return descriptor\n}\n\nfunction isNullable(node: JsonNode): boolean {\n const branches = node.anyOf ?? node.oneOf\n if (!branches) return false\n return branches.some(b => b.type === 'null')\n}\n\n// Strip a `{ anyOf: [T, null] }` wrapper down to T.\nfunction collapseNullable(node: JsonNode): JsonNode {\n const branches = node.anyOf ?? node.oneOf\n if (!branches) return node\n const nonNull = branches.filter(b => b.type !== 'null')\n if (nonNull.length === 1) return nonNull[0]\n return node\n}\n\nfunction enumOptions(node: JsonNode): string[] | undefined {\n if (Array.isArray(node.enum)) return node.enum.map(v => String(v))\n const branches = node.anyOf ?? node.oneOf\n if (branches?.every(b => b.const !== undefined)) {\n return branches.map(b => String(b.const))\n }\n return undefined\n}\n\nfunction kindOf(node: JsonNode): WindoControlKind {\n if (Array.isArray(node.enum) || (node.anyOf?.every(b => b.const !== undefined) ?? false)) return 'enum'\n if (node.format === 'date-time' || node.format === 'date') return 'date'\n const type = Array.isArray(node.type) ? node.type.find(t => t !== 'null') : node.type\n switch (type) {\n case 'string':\n return 'string'\n case 'number':\n case 'integer':\n return 'number'\n case 'boolean':\n return 'boolean'\n case 'array':\n return 'array'\n case 'object':\n return 'object'\n default:\n return 'unknown'\n }\n}\n\n/* ------------------------------------------------------------------ *\n * zod node introspection (the kind source of truth for unrepresentable types)\n * ------------------------------------------------------------------ */\n\ninterface ZodDefLike {\n type?: string\n innerType?: unknown\n}\n\nfunction zodDef(node: unknown): ZodDefLike | undefined {\n const n = node as { def?: ZodDefLike; _zod?: { def?: ZodDefLike } } | null\n if (!n || typeof n !== 'object') return undefined\n return n.def ?? n._zod?.def\n}\n\nconst ZOD_WRAPPERS = new Set(['optional', 'nullable', 'default', 'prefault', 'catch', 'readonly', 'nonoptional', 'lazy'])\n\n// Unwrap optional/nullable/default/... down to the meaningful inner node.\nfunction unwrapZodDef(node: unknown): ZodDefLike | undefined {\n let def = zodDef(node)\n let guard = 0\n while (def && def.innerType && ZOD_WRAPPERS.has(def.type ?? '') && guard++ < 16) {\n def = zodDef(def.innerType)\n }\n return def\n}\n\nfunction mapZodType(type: string | undefined): WindoControlKind | undefined {\n switch (type) {\n case 'date':\n return 'date'\n case 'string':\n return 'string'\n case 'number':\n case 'int':\n case 'bigint':\n return 'number'\n case 'boolean':\n return 'boolean'\n case 'array':\n case 'set':\n case 'tuple':\n return 'array'\n case 'object':\n case 'record':\n case 'map':\n return 'object'\n case 'enum':\n case 'literal':\n return 'enum'\n default:\n return undefined\n }\n}\n\n// Per-field kind read straight from the zod object's shape.\nfunction shapeKinds(schema: z.ZodType): Record<string, WindoControlKind> {\n const shape = (schema as { shape?: Record<string, unknown> }).shape\n if (!shape || typeof shape !== 'object') return {}\n const out: Record<string, WindoControlKind> = {}\n for (const key of Object.keys(shape)) {\n const kind = mapZodType(unwrapZodDef(shape[key])?.type)\n if (kind) out[key] = kind\n }\n return out\n}\n","// The chrome <-> iframe postMessage contract. The schema itself never crosses\n// the boundary: the iframe walks it into a serialisable descriptor, the chrome\n// sends candidate JSON down, the iframe parses and reports back. Every payload\n// here is plain JSON.\n\nimport type { WindoContextMeta, WindoEnvState, WindoFieldError, WindoGroup, WindoLogEntry, WindoManifestEntry, WindoPropDoc, WindoSchemaDescriptor, WindoVariantMeta } from './types'\n\nexport const WINDO_MSG = 'windo'\n\n/** chrome -> iframe */\nexport type WindoHostMessage =\n | { source: typeof WINDO_MSG; dir: 'host'; type: 'request-manifest' }\n | { source: typeof WINDO_MSG; dir: 'host'; type: 'select'; id: string }\n | { source: typeof WINDO_MSG; dir: 'host'; type: 'set-props'; id: string; json: string }\n | { source: typeof WINDO_MSG; dir: 'host'; type: 'set-env'; env: WindoEnvState }\n | { source: typeof WINDO_MSG; dir: 'host'; type: 'invoke-action'; id: string; actionId: string }\n\n/** iframe -> chrome */\nexport type WindoPreviewMessage =\n | { source: typeof WINDO_MSG; dir: 'preview'; type: 'ready' }\n | {\n source: typeof WINDO_MSG\n dir: 'preview'\n type: 'manifest'\n title: string\n entries: WindoManifestEntry[]\n groups: WindoGroup[]\n contexts: WindoContextMeta[]\n }\n | {\n source: typeof WINDO_MSG\n dir: 'preview'\n type: 'describe'\n id: string\n descriptor: WindoSchemaDescriptor\n props: WindoPropDoc[]\n variants: WindoVariantMeta[]\n defaults: unknown\n code: string | null\n }\n | { source: typeof WINDO_MSG; dir: 'preview'; type: 'parse-ok'; id: string }\n | { source: typeof WINDO_MSG; dir: 'preview'; type: 'parse-error'; id: string; errors: WindoFieldError[] }\n | { source: typeof WINDO_MSG; dir: 'preview'; type: 'log'; entry: WindoLogEntry }\n | { source: typeof WINDO_MSG; dir: 'preview'; type: 'state'; id: string; state: Record<string, unknown>; actions: { id: string; disabled: boolean }[] }\n | { source: typeof WINDO_MSG; dir: 'preview'; type: 'render-error'; id: string; message: string; stack?: string }\n\nexport type WindoMessage = WindoHostMessage | WindoPreviewMessage\n\nexport function isWindoMessage(data: unknown): data is WindoMessage {\n return typeof data === 'object' && data !== null && (data as { source?: unknown }).source === WINDO_MSG\n}\n\nexport function isHostMessage(msg: WindoMessage): msg is WindoHostMessage {\n return msg.dir === 'host'\n}\n\nexport function isPreviewMessage(msg: WindoMessage): msg is WindoPreviewMessage {\n return msg.dir === 'preview'\n}\n","// Core type system for windo. Everything — the authoring API, the iframe\n// preview runtime, the chrome UI, and the postMessage protocol — is typed\n// against the contracts in this file.\n\nimport type { ComponentType, ReactNode } from 'react'\nimport type { z } from 'zod'\n\n/* ------------------------------------------------------------------ *\n * Primitives\n * ------------------------------------------------------------------ */\n\nexport type WindoStatus = 'stable' | 'beta' | 'deprecated'\n\nexport const WINDO_STATUSES: readonly WindoStatus[] = ['stable', 'beta', 'deprecated']\n\n/** Anchor a component within the canvas frame. */\nexport type WindoPlacementBase = 'center' | 'fill' | 'top' | 'bottom' | 'left' | 'right' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right'\n\n/**\n * Where a component renders inside the canvas frame. Placements render flush by\n * default; append `-padding` to inset the component from the frame edges\n * (e.g. `top` sits flush at the top, `top-padding` adds breathing room).\n */\nexport type WindoPlacement = WindoPlacementBase | `${WindoPlacementBase}-padding`\n\nconst WINDO_PLACEMENT_BASE: readonly WindoPlacementBase[] = ['center', 'fill', 'top', 'bottom', 'left', 'right', 'top-left', 'top-right', 'bottom-left', 'bottom-right']\n\nexport const WINDO_PLACEMENTS: readonly WindoPlacement[] = [...WINDO_PLACEMENT_BASE, ...WINDO_PLACEMENT_BASE.map(p => `${p}-padding` as WindoPlacement)]\n\n/** A configured group. Components reference a group by its `slug`. */\nexport interface WindoGroup {\n name: string\n slug: string\n description?: string\n}\n\n/* ------------------------------------------------------------------ *\n * Context system\n * ------------------------------------------------------------------ */\n\nexport type WindoControlType = 'enum' | 'boolean' | 'string' | 'number'\n\n/** A single ambient control: a value plus the metadata to render its toggle. */\nexport interface WindoControlSpec<T = unknown> {\n type: WindoControlType\n label?: string\n default: T\n options?: readonly string[]\n min?: number\n max?: number\n step?: number\n}\n\nexport type WindoControlMap = Record<string, WindoControlSpec>\n\n/** Resolve a control map to the value object it produces. */\nexport type WindoControlValues<C extends WindoControlMap> = {\n [K in keyof C]: C[K] extends WindoControlSpec<infer T> ? T : never\n}\n\n/**\n * A named context. Two capabilities, either or both:\n * - `controls` → ambient values + UI toggles (free, no opt-in needed)\n * - `provider` → a React wrapper, mounted inside the iframe around components\n * that opt in via `uses`\n */\nexport interface WindoContextDefinition<Values = unknown, Provided = Values> {\n label?: string\n description?: string\n controls?: WindoControlMap\n provider?: ComponentType<{ children: ReactNode; values: Values; ctx: WindoRenderContext }>\n /** Derive the value exposed on `ctx.contexts[name]`. Defaults to the control values. */\n resolve?: (values: Values, ctx: WindoRenderContext) => Provided\n}\n\n// Contexts are each generic over a different control map `C`; TS has no existential\n// to hold `exists C. WindoContextDefinition<WindoControlValues<C>>`. `Values` sits in\n// contravariant positions (provider props, resolve arg) so no precise common supertype\n// exists — `any` is the single, contained variance hatch for this heterogeneous\n// registry. Mirrors WindoModule. Definition sites stay precise; this only erases at the\n// point of collection.\n// biome-ignore lint/suspicious/noExplicitAny: existential variance hatch for the heterogeneous context registry\nexport type WindoContextMap = Record<string, WindoContextDefinition<any, any>>\n\n/* ------------------------------------------------------------------ *\n * Render-time context\n * ------------------------------------------------------------------ */\n\nexport interface WindoViewport {\n width: number\n height: number\n name: 'mobile' | 'tablet' | 'desktop'\n}\n\n/** Console channel: `ctx.logger.log(…)` posts an entry to the chrome's Console tab. */\nexport interface WindoLogger {\n log: (...args: unknown[]) => void\n}\n\n/** How an action fires. `click` renders a toolbar button; the rest bind to the stage's pointer events. */\nexport type WindoActionTrigger = 'click' | 'enter' | 'exit' | 'hover'\n\nexport const WINDO_ACTION_TRIGGERS: readonly WindoActionTrigger[] = ['click', 'enter', 'exit', 'hover']\n\n/**\n * An out-of-band action that drives a component's state. `click` actions render as\n * toolbar buttons; `enter`/`exit`/`hover` bind to the stage's pointer events. `run`\n * receives the live ctx and an `active` flag — for `hover` it is `true` on\n * pointer-enter and `false` on pointer-leave; for the others it is always `true`.\n */\nexport interface WindoAction<State = unknown> {\n label: string\n /** Defaults to `click`. */\n on?: WindoActionTrigger\n run: (ctx: WindoRenderContext<State>, active: boolean) => void\n /** Greys out a `click` action's toolbar button. Evaluated against the live state. */\n disabled?: (ctx: WindoRenderContext<State>) => boolean\n}\n\n/** Live environment handed to every render-time function inside the iframe. */\nexport interface WindoRenderContext<State = unknown> {\n colorScheme: 'light' | 'dark'\n viewport: WindoViewport\n reducedMotion: boolean\n direction: 'ltr' | 'rtl'\n locale: string\n logger: WindoLogger\n /** Current component-local state, typed by the windo's `State` generic. */\n state: State\n /** Merge a patch into the component-local state and re-render. */\n setState: (patch: Partial<State>) => void\n /** Resolved values of opted-in contexts, keyed by context name. */\n contexts: Record<string, unknown>\n}\n\n/* ------------------------------------------------------------------ *\n * Authoring API\n * ------------------------------------------------------------------ */\n\n/** A variant: a label plus a partial prop patch. Renders in the gallery and is click-to-apply. */\nexport interface WindoVariant<Props> {\n label: string\n props: Partial<Props>\n}\n\n/** A row in the authored Props documentation table. */\nexport interface WindoPropDoc {\n name: string\n type: string\n default?: string\n desc?: string\n}\n\nexport type WindoDefaultProps<Props, State = unknown> = Props | ((ctx: WindoRenderContext<State>) => Props)\n\n/**\n * The object returned by a `windo(...)` factory.\n *\n * Keystone rule: the surrounding factory runs ONCE (definition-time) for static\n * fields (title, group, schema). Every function field below — `defaultProps`,\n * `actions`, `providers`, `component` — runs at render-time with the live `ctx`.\n * Never close over live values in the static factory body.\n */\nexport interface WindoDefinition<Props = unknown, State = unknown, GroupSlug extends string = string> {\n title: string\n group: GroupSlug\n status?: WindoStatus\n description?: string\n deprecation?: string\n placement?: WindoPlacement\n /** Initial component-local state. Its shape is the `State` generic; `ctx.state`/`ctx.setState` derive from it. */\n state?: State\n /** Out-of-band actions that drive state: toolbar buttons (`click`) and stage pointer triggers (`enter`/`exit`/`hover`). */\n actions?: WindoAction<State>[]\n /** zod schema: validator + parser for the JSON-editable prop subset. `z.output ⊆ Props`. */\n configurableProps?: z.ZodType\n /** Full props incl. functions/JSX. The editor's JSON overrides merge on top. */\n defaultProps: WindoDefaultProps<Props, State>\n /** Names of provider contexts this component opts into. */\n uses?: string[]\n variants?: WindoVariant<Props>[]\n /** Authored documentation table (not derived from the schema). */\n props?: WindoPropDoc[]\n /** Optional authored code snippet for the Code tab. */\n code?: (values: Props) => string\n /** A local provider wrapping just this windo (in addition to `uses`). */\n providers?: ComponentType<{ children: ReactNode; ctx: WindoRenderContext<State> }>\n component: (props: Props, ctx: WindoRenderContext<State>) => ReactNode\n}\n\n/** Argument handed to the `windo(w => ...)` factory. */\nexport interface WindoFactoryArg<Groups extends readonly WindoGroup[], Contexts extends WindoContextMap> {\n /** Configured groups keyed by slug. */\n groups: Record<Groups[number]['slug'], WindoGroup>\n contexts: Contexts\n}\n\n/**\n * The default export of a `*.windo.tsx` file. A branded, lazily-resolved\n * definition — the runtime calls `resolve(w)` with the config-derived factory arg.\n */\n// biome-ignore lint/suspicious/noExplicitAny: variance escape hatch for the heterogeneous WindoModule registry\nexport interface WindoModule<Props = any, State = any> {\n readonly __windo: true\n resolve: (w: WindoFactoryArg<readonly WindoGroup[], WindoContextMap>) => WindoDefinition<Props, State>\n}\n\n/* ------------------------------------------------------------------ *\n * Config\n * ------------------------------------------------------------------ */\n\nexport interface WindoConfig<Groups extends readonly WindoGroup[] = readonly WindoGroup[], Contexts extends WindoContextMap = WindoContextMap> {\n /** Configured groups. A component's `group` must be one of these slugs. */\n groups: Groups\n /** Named contexts available to components. */\n contexts?: Contexts\n /** Glob(s) for discovery, relative to project root. Default `**\\/*.windo.tsx`. */\n include?: string | string[]\n /** Title shown in the workbench chrome. */\n title?: string\n}\n\n/* ------------------------------------------------------------------ *\n * Schema descriptor (crosses the iframe boundary; renders the controls)\n * ------------------------------------------------------------------ */\n\nexport type WindoControlKind = 'string' | 'number' | 'boolean' | 'enum' | 'date' | 'array' | 'object' | 'unknown'\n\nexport interface WindoControlDescriptor {\n key: string\n kind: WindoControlKind\n optional: boolean\n options?: string[]\n min?: number\n max?: number\n description?: string\n}\n\nexport interface WindoSchemaDescriptor {\n fields: WindoControlDescriptor[]\n}\n\n/* ------------------------------------------------------------------ *\n * Runtime manifest + protocol payloads\n * ------------------------------------------------------------------ */\n\n/** Serialisable metadata for one action — drives the canvas toolbar. */\nexport interface WindoActionMeta {\n id: string\n label: string\n on: WindoActionTrigger\n}\n\n/** Static, serialisable metadata for one windo — drives the sidebar. */\nexport interface WindoManifestEntry {\n id: string\n title: string\n group: string\n status: WindoStatus\n description?: string\n deprecation?: string\n placement: WindoPlacement\n uses: string[]\n hasVariants: boolean\n actions: WindoActionMeta[]\n hasState: boolean\n}\n\nexport interface WindoVariantMeta {\n label: string\n props: Record<string, unknown>\n}\n\n/** Ambient environment pushed from the chrome down into the iframe. */\nexport interface WindoEnvState {\n colorScheme: 'light' | 'dark'\n viewport: WindoViewport\n reducedMotion: boolean\n direction: 'ltr' | 'rtl'\n locale: string\n /** Per-context control values, keyed by context name then control key. */\n contexts: Record<string, Record<string, unknown>>\n}\n\nexport interface WindoLogEntry {\n ts: number\n args: unknown[]\n}\n\nexport interface WindoFieldError {\n path: string\n message: string\n}\n\n/* ------------------------------------------------------------------ *\n * Context metadata (serialisable; drives the chrome's Context panel)\n * ------------------------------------------------------------------ */\n\nexport interface WindoContextControlMeta {\n key: string\n type: WindoControlType\n label?: string\n options?: string[]\n default: unknown\n min?: number\n max?: number\n step?: number\n}\n\nexport interface WindoContextMeta {\n name: string\n label?: string\n description?: string\n /** True when the context contributes controls (ambient values). */\n ambient: boolean\n /** True when the context mounts a provider (opt-in via `uses`). */\n hasProvider: boolean\n controls: WindoContextControlMeta[]\n}\n"],"mappings":"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","names":[]}