@glasshome/widget-sdk 0.2.5 → 0.3.3

package/dist/define-widget.d.ts

@@ -2,8 +2,8 @@ import type { WidgetDefinition } from "./types";
 /**
  * Define a widget and return its definition for registration with the dashboard.
  *
- * The dashboard renders widgets as plain SolidJS components via <Dynamic>,
- * so no Web Component registration is needed.
+ * When `configSchema` (Zod) is provided, auto-populates `manifest.schema` (JSON Schema)
+ * and `manifest.defaultConfig` for backward compatibility with existing consumers.
  *
  * @template C - Widget configuration type
  */

package/dist/framework/dialogs/WidgetDialog.d.ts

@@ -1,4 +1,5 @@
 import { type Component, type JSX } from "solid-js";
+import type { ZodType } from "zod";
 export interface WidgetDialogTab {
     id: string;
     label: string;
@@ -21,11 +22,15 @@ export interface WidgetDialogProps {
     maxWidth?: "sm" | "md" | "lg" | "xl" | "2xl" | "3xl" | "4xl";
     defaultTab?: string;
     headerActions?: JSX.Element;
+    configSchema?: ZodType;
+    config?: Record<string, unknown>;
+    onConfigSave?: (config: Record<string, unknown>) => void;
     ResponsiveDialog: Component<any>;
     ResponsiveDialogContent: Component<any>;
     ResponsiveDialogHeader: Component<any>;
     ResponsiveDialogTitle: Component<any>;
     ResponsiveDialogDescription: Component<any>;
     Button: Component<any>;
+    SchemaForm?: Component<any>;
 }
 export declare function WidgetDialog(props: WidgetDialogProps): JSX.Element;

package/dist/framework/fields.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+/**
+ * Pre-built Zod field helpers for common widget config patterns.
+ * Each helper returns a Zod schema with `.meta()` annotations that
+ * SchemaForm uses to render the appropriate UI (entity picker, area picker, etc.).
+ */
+export declare const widgetFields: {
+    /** Optional display name override (renders as text input) */
+    title: () => z.ZodOptional<z.ZodString>;
+    /** Multi-select entity picker for a HA domain */
+    entityIds: (domain: string) => z.ZodDefault<z.ZodArray<z.ZodString>>;
+    /** Single-select entity picker for a HA domain */
+    singleEntity: (domain: string) => z.ZodDefault<z.ZodArray<z.ZodString>>;
+    /** Area picker dropdown */
+    areaId: () => z.ZodOptional<z.ZodString>;
+};

package/dist/framework/index.d.ts

@@ -51,5 +51,7 @@ export { typography } from "./design-system/typography";
 export { WIDGET_Z, type WidgetZIndex } from "./design-system/z-index";
 export { type AdaptiveIconColors, deriveAdaptiveIconColors, GRADIENT_NAMES, GRADIENT_PRESET_KEYS, GRADIENT_PRESETS, type GradientPreset, getGradient, getGradientFromString, gradientColorPresets, stateColors, type WidgetColorPreset, } from "./theming";
 export { applyCssVars, applyLayout, builtInVariants, classicGlass, compactHorizontal, composeVariants, createFlexLayout, extendVariant, getBuiltInVariant, getBuiltInVariantIds, isBuiltInVariant, mergeVariants, minimal, } from "./variants";
+export { widgetFields } from "./fields";
+export { extractDefaults, toFormSchema } from "./to-form-schema";
 export { allEntitiesInState, anyEntityInState, calculateLightGroup, calculateSensorGroup, cn, countActiveEntities, countAvailableEntities, countEntitiesByState, createEmptyStateConfig, type EmptyStateConfigOptions, formatValue, getEntityAttribute, getEntityState, interpretValue, isEntityActive, isEntityAvailable, type LightGroupResult, type SensorGroupResult, type SensorGroupType, type WidgetEmptyStateConfig, } from "./utils";
 export type { AbsoluteLayoutStrategy, BaseComponentProps, ColorVariant, CustomLayoutStrategy, ElementConfig, EntityView, FlexLayoutStrategy, GestureConfig, GradientConfig, GridLayoutStrategy, HoldGestureConfig, ImageOverlay, InteractionConfig, LayoutStrategy, PositionConfig, SlideGestureConfig, SpacingScale, VariantPlugins, VariantRegistry, WidgetContextValue, WidgetDimensions, WidgetElement, WidgetOrientation, WidgetSize, WidgetStyles, WidgetVariant, WidgetVariantConfig, } from "./types";

package/dist/framework/to-form-schema.d.ts

@@ -0,0 +1,16 @@
+import { type ZodType } from "zod";
+/**
+ * Convert a Zod config schema to JSON Schema with custom metadata injected.
+ *
+ * Widget field helpers attach metadata via `.meta()` (e.g. `{ domain: "light" }`,
+ * `{ formType: "area-picker" }`). The `override` callback reads these from
+ * `z.globalRegistry` and merges them into the JSON Schema output so the
+ * form renderer can detect custom field types.
+ */
+export declare function toFormSchema(schema: ZodType): object;
+/**
+ * Extract default config values from a Zod schema.
+ * Fields with `.default()` get their default value; optional fields without
+ * defaults are omitted. Returns empty object on parse failure.
+ */
+export declare function extractDefaults(schema: ZodType): Record<string, unknown>;