@glasshome/widget-sdk 1.8.1 → 1.9.0

package/dist/deprecations.js

@@ -40,6 +40,22 @@ var e = "https://glasshome.app/docs/widget-sdk/config", t = [
 		docsUrl: e,
 		sourcePattern: "\\bareaId\\s*:\\s*z\\.string\\("
 	},
+	{
+		id: "ctx.dimensions",
+		since: "1.9.0",
+		removeIn: "2.0.0",
+		replacement: "useWidgetDimensions()",
+		docsUrl: "https://glasshome.app/docs/widget-api-reference",
+		sourcePattern: "\\.dimensions\\(\\)"
+	},
+	{
+		id: "direct-ui-import",
+		since: "1.9.0",
+		removeIn: "2.0.0",
+		replacement: "the same export from \"@glasshome/widget-sdk\"",
+		docsUrl: "https://glasshome.app/docs/widget-styling",
+		sourcePattern: "from\\s+[\"']@glasshome/ui(/[^\"']*)?[\"']"
+	},
 	{
 		id: "raw-zod-config",
 		since: "1.4.0",

package/dist/framework/config/index.d.ts

@@ -13,7 +13,9 @@ import { z, type ZodType } from "zod";
  * key is optional. Erasing it silently diverges `Infer` from raw `z.infer` (a key
  * becomes `x: T | undefined` instead of `x?: T`), so the concrete types are load-bearing.
  *
- * SchemaForm renders a FLAT object only; `field.group` is the sole nested exception.
+ * SchemaForm renders a flat object plus the nested shapes declared here:
+ * `field.group` (one level), `field.list` (array of items, depth 1), and
+ * `field.variants` (discriminated union, legal top-level or inside a list).
  */
 /** A single config field. Structurally a zod schema producing `T`. */
 export type Field<T> = ZodType<T>;
@@ -91,6 +93,35 @@ declare function group<S extends ConfigShape>(shape: S, o: {
 }): Field<{
     [K in keyof S]: Infer<S[K]>;
 }>;
+type ListOpts = {
+    title: string;
+    description?: string;
+    min?: number;
+    max: number;
+    addLabel?: string;
+    /** Field name whose value captions the collapsed item row. Must exist in
+     * every item (for variants: in `shared` or common to all variants). A name,
+     * not a function: it has to survive JSON serialization. */
+    labelField?: string;
+};
+type VariantShapes = Record<string, ConfigShape>;
+type VariantsOpts<V extends VariantShapes, S extends ConfigShape> = {
+    title: string;
+    description?: string;
+    /** Display names for the discriminator Select, keyed by variant kind. */
+    labels?: {
+        [K in keyof V]?: string;
+    };
+    /** Fields merged into every variant (variant-specific fields win on collision). */
+    shared?: S;
+};
+type VariantsOutput<D extends string, V extends VariantShapes, S extends ConfigShape> = {
+    [K in keyof V & string]: z.output<z.ZodObject<{
+        [P in D]: z.ZodLiteral<K>;
+    } & S & V[K]>>;
+}[keyof V & string];
+declare function list<Item extends ZodType>(item: Item, o: ListOpts): Field<Array<z.output<Item>>>;
+declare function variants<D extends string, V extends VariantShapes, S extends ConfigShape = Record<never, never>>(discriminator: D, variantShapes: V, o: VariantsOpts<V, S>): Field<VariantsOutput<D, V, S>>;
 export declare const field: {
     title: typeof title;
     text: typeof text;
@@ -103,6 +134,8 @@ export declare const field: {
     icon: typeof icon;
     stringList: typeof stringList;
     group: typeof group;
+    list: typeof list;
+    variants: typeof variants;
 };
 export declare function defineConfig<S extends ConfigShape>(shape: S): z.ZodObject<{ -readonly [P in keyof S]: S[P]; }, z.core.$strip>;
 export {};

package/dist/framework/core/Widget.d.ts

@@ -2,8 +2,8 @@
  * Widget — main container component.
  *
  * Renders the shell (gradient, border highlight, channel vars) and provides
- * a minimal context (isEditMode, updateConfig) for slot components and host
- * RPC. All visual scale (icon size, text size, padding, gap, content layout
+ * a minimal context (updateConfig, host RPC) plus the measured-size context
+ * for `useWidgetDimensions()`. All visual scale (icon size, text size, padding, gap, content layout
  * direction, slider fill orientation) lives in pure CSS via container queries
  * on `.glasshome-widget`. The widget reacts to its own rendered box without
  * any JS measurement.

package/dist/framework/dialogs/validate-config.d.ts

@@ -0,0 +1,8 @@
+import type { ZodType } from "zod";
+/**
+ * Save-gate for the widget dialog's schema editor: runs the widget's real zod
+ * config schema over the draft. Returns readable message strings for the
+ * SchemaForm `errors` prop, or null when the draft is valid. Cross-item rules
+ * (zod `.check()` on an array) land at the list path, e.g. "nodes: <message>".
+ */
+export declare function validateConfigDraft(schema: ZodType, draft: Record<string, unknown>): string[] | null;

package/dist/framework/hooks/index.d.ts

@@ -3,7 +3,8 @@
  *
  * Hooks for widget development: context, dialog, entity group.
  */
-export { type ReactiveWidgetContext, type ServiceCallFn, useWidgetContext, WidgetCtx, } from "./use-widget-context";
+export { type ReactiveWidgetContext, type ServiceCallFn, useWidgetContext, WidgetCtx, type WidgetDimensions, } from "./use-widget-context";
+export { useWidgetDimensions, type WidgetDimensionsAccessor, WidgetSizeCtx, } from "./use-widget-dimensions";
 export { useIntersectionPause } from "./use-intersection-pause";
 export { useReducedMotion } from "./use-reduced-motion";
 export { useWidgetDialog, type WidgetDialogReturn } from "./use-widget-dialog";

package/dist/framework/hooks/use-widget-context.d.ts

@@ -3,13 +3,9 @@
  *
  * Visual scale (icon size, text size, padding, layout direction) lives in
  * CSS via container queries on `.glasshome-widget`. This context only
- * carries:
- *   - host RPC (updateConfig)
- *   - edit-mode flag
- *   - raw measured dimensions (for widgets that branch rendered content
- *     based on size — e.g. hide a forecast strip on small chips).
- *
- * Widgets decide their own thresholds; there is no shared size tier.
+ * carries host RPC (updateConfig, dialog opener, service calls) plus the
+ * deprecated `dimensions` accessor; size reads go through
+ * `useWidgetDimensions()`, which only exists inside `<Widget>`.
  */
 export interface WidgetDimensions {
     width: number;
@@ -19,9 +15,12 @@ export interface WidgetDimensions {
     validated there against the widget's granted capabilities. */
 export type ServiceCallFn = (domain: string, service: string, serviceData?: Record<string, unknown>, target?: Record<string, unknown>) => Promise<void>;
 export interface ReactiveWidgetContext {
-    isEditMode: () => boolean;
     updateConfig: (config: Record<string, unknown>) => void;
-    /** Measured shell dimensions in CSS px. (0,0) before first layout. */
+    /**
+     * Measured shell dimensions in CSS px. (0,0) before first layout.
+     * @deprecated since 1.9.0, removed in 2.0.0. Use `useWidgetDimensions()`
+     * (throws outside `<Widget>` instead of silently reading the host stub).
+     */
     dimensions: () => WidgetDimensions;
     /** Host RPC: `useWidgetDialog` registers its opener here so the host can
         open the widget's dialog on a chosen tab. Called with `null` on cleanup. */

package/dist/framework/hooks/use-widget-dimensions.d.ts

@@ -0,0 +1,14 @@
+import type { WidgetDimensions } from "./use-widget-context";
+export type WidgetDimensionsAccessor = () => WidgetDimensions;
+/**
+ * Provided only by `<Widget>` (ResizeObserver-measured shell box). Unlike
+ * `WidgetCtx`, the host's pre-`<Widget>` stub never provides it, so a read
+ * from the wrong scope throws instead of silently returning (0,0).
+ */
+export declare const WidgetSizeCtx: import("solid-js").Context<WidgetDimensionsAccessor | undefined>;
+/**
+ * Reactive accessor for the widget shell's measured dimensions (CSS px,
+ * (0,0) before first layout). Must be called inside `<Widget>`; called from
+ * the top-level widget scope it throws instead of freezing on the host stub.
+ */
+export declare function useWidgetDimensions(): WidgetDimensionsAccessor;

package/dist/framework/index.d.ts

@@ -37,7 +37,7 @@ export { WidgetTitle } from "./components/WidgetTitle";
 export { WidgetValue } from "./components/WidgetValue";
 export { WidgetSliderFill } from "./backgrounds/WidgetSliderFill";
 export { WidgetDialog, type WidgetDialogProps, type WidgetDialogTab } from "./dialogs";
-export { type AggregationPreset, type ReactiveWidgetContext, type ServiceCallFn, type UseWidgetEntityGroupOptions, type UseWidgetEntityGroupResult, useIntersectionPause, useReducedMotion, useWidgetContext, useWidgetDialog, useWidgetEntityGroup, WidgetCtx, type WidgetDialogReturn, } from "./hooks";
+export { type AggregationPreset, type ReactiveWidgetContext, type ServiceCallFn, type UseWidgetEntityGroupOptions, type UseWidgetEntityGroupResult, useIntersectionPause, useReducedMotion, useWidgetContext, useWidgetDialog, useWidgetDimensions, useWidgetEntityGroup, WidgetCtx, type WidgetDialogReturn, type WidgetDimensions, type WidgetDimensionsAccessor, WidgetSizeCtx, } from "./hooks";
 export { type GestureHandlers, useWidgetGestures } from "./gestures/use-widget-gestures";
 export { injectTokens, type SvgColorKey, svgColors, type Tone, ToneSchema, } from "./theming";
 export { widgetFields } from "./fields";

package/dist/host/index.js

@@ -1,4 +1,4 @@
-import { n as e, t } from "../tokens-Bdfb1xYe.js";
+import { n as e, t } from "../tokens-CFl0mCx4.js";
 import { ErrorBoundary as n, createComponent as r } from "solid-js";
 import { render as i } from "solid-js/web";
 //#region src/host/instantiate-widget.ts

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export { defineWidget } from "./define-widget";
 export * from "./data";
 export * from "./framework";
 export { monotoneCubicPath } from "./shared/spline";
+export * from "./ui";
 export { formatSchemaError, WidgetManifestSchema } from "./schemas";
 export { isDark } from "./theme";
 export type { GridSize, WidgetContext, WidgetDefinition, WidgetExample, WidgetManifest, } from "./types";