@garretapp/sdk 0.1.1 → 0.1.2

package/dist/{chunk-ZJYHRC5C.js → chunk-YBYF7JQS.js}

@@ -189,6 +189,10 @@ function getGarret() {
     },
     onOpenSettings: () => () => {
     },
+    onRefresh: () => () => {
+    },
+    setTitle: () => {
+    },
     surfaces: { open: nope, onClosed: () => () => {
     } },
     window: { setAspectRatio: () => {

package/dist/{platform-DnI7gJTx.d.cts → platform-DjRN9xTv.d.cts}

@@ -117,6 +117,10 @@ interface GarretPlatform {
     onActiveChange(cb: (active: boolean) => void): () => void;
     /** The host (frame ⋯→Settings) asks this widget to open its own config UI. */
     onOpenSettings(cb: () => void): () => void;
+    /** The host (frame ⋯→Refresh) asks this widget to reload its data. */
+    onRefresh(cb: () => void): () => void;
+    /** Set this placement's title in the board frame header (persisted in the board config). */
+    setTitle(title: string): void;
     /** Open sibling surfaces (same package) as floating windows. Requires the `windows` capability. */
     surfaces: SurfaceApi;
     /** Controls for this UI's own surface window (no-op for a board-placed widget). */

package/dist/{platform-CZHtdUK0.d.ts → platform-K2c4rKaG.d.ts}

@@ -117,6 +117,10 @@ interface GarretPlatform {
     onActiveChange(cb: (active: boolean) => void): () => void;
     /** The host (frame ⋯→Settings) asks this widget to open its own config UI. */
     onOpenSettings(cb: () => void): () => void;
+    /** The host (frame ⋯→Refresh) asks this widget to reload its data. */
+    onRefresh(cb: () => void): () => void;
+    /** Set this placement's title in the board frame header (persisted in the board config). */
+    setTitle(title: string): void;
     /** Open sibling surfaces (same package) as floating windows. Requires the `windows` capability. */
     surfaces: SurfaceApi;
     /** Controls for this UI's own surface window (no-op for a board-placed widget). */

package/dist/react.cjs

@@ -222,6 +222,10 @@ function getGarret() {
     },
     onOpenSettings: () => () => {
     },
+    onRefresh: () => () => {
+    },
+    setTitle: () => {
+    },
     surfaces: { open: nope, onClosed: () => () => {
     } },
     window: { setAspectRatio: () => {
@@ -428,6 +432,12 @@ function useOpenSettings(cb) {
   ref.current = cb;
   react.useEffect(() => g.onOpenSettings(() => ref.current()), [g]);
 }
+function useRefresh(cb) {
+  const g = getGarret();
+  const ref = react.useRef(cb);
+  ref.current = cb;
+  react.useEffect(() => g.onRefresh(() => ref.current()), [g]);
+}
 function useInstanceConfig(defaults) {
   const g = getGarret();
   const [cfg, setCfg] = react.useState(defaults);
@@ -493,4 +503,5 @@ exports.useHostEvent = useHostEvent;
 exports.useInstanceConfig = useInstanceConfig;
 exports.useOpenSettings = useOpenSettings;
 exports.useProps = useProps;
+exports.useRefresh = useRefresh;
 exports.useStream = useStream;

package/dist/react.d.cts

@@ -1,6 +1,6 @@
 import { G as GarretError, E as EventMap, H as HostClient, f as StreamCall } from './types-BxSYAH_H.cjs';
-import { G as GarretPlatform } from './platform-DnI7gJTx.cjs';
-export { S as SurfaceApi, a as SurfaceHandle, b as SurfaceOpenOptions, W as WindowControls } from './platform-DnI7gJTx.cjs';
+import { G as GarretPlatform } from './platform-DjRN9xTv.cjs';
+export { S as SurfaceApi, a as SurfaceHandle, b as SurfaceOpenOptions, W as WindowControls } from './platform-DjRN9xTv.cjs';
 import { ReactNode } from 'react';
 import './protocol-Do0BJdeE.cjs';
 
@@ -112,6 +112,8 @@ declare function useConfig<T>(): [T, (patch: Partial<T>) => void, (value: T) =>
 declare function useActive(): boolean;
 /** Run `cb` when the host (frame ⋯→Settings) asks this widget to reveal its own config UI. */
 declare function useOpenSettings(cb: () => void): void;
+/** Run `cb` when the host (frame ⋯→Refresh) asks this widget to reload. */
+declare function useRefresh(cb: () => void): void;
 /** Per-placement config backed by `g.instanceStorage` (isolated per widget instance). Loads once the
  *  runtime binds (calls before bind reject); `set` writes through to storage + state. `loaded` gates
  *  the first data fetch so you don't fetch with defaults before the saved config arrives. */
@@ -126,4 +128,4 @@ declare function useInstanceConfig<T extends Record<string, unknown>>(defaults:
  *  time), so this re-renders when the runtime binds. The `T` is an unchecked cast — validate it yourself. */
 declare function useProps<T = Record<string, unknown>>(): T;
 
-export { Accordion, Badge, Dot, EmptyState, ErrorState, Field, FieldGroup, GarretError, GarretPlatform, Item, NumberInput, Scroll, Select, SettingsPanel, type StreamStatus, Switch, TextInput, type Tone, type UseStreamResult, useActive, useConfig, useGarret, useHost, useHostEvent, useInstanceConfig, useOpenSettings, useProps, useStream };
+export { Accordion, Badge, Dot, EmptyState, ErrorState, Field, FieldGroup, GarretError, GarretPlatform, Item, NumberInput, Scroll, Select, SettingsPanel, type StreamStatus, Switch, TextInput, type Tone, type UseStreamResult, useActive, useConfig, useGarret, useHost, useHostEvent, useInstanceConfig, useOpenSettings, useProps, useRefresh, useStream };

package/dist/react.d.ts

@@ -1,6 +1,6 @@
 import { G as GarretError, E as EventMap, H as HostClient, f as StreamCall } from './types-BxSYAH_H.js';
-import { G as GarretPlatform } from './platform-CZHtdUK0.js';
-export { S as SurfaceApi, a as SurfaceHandle, b as SurfaceOpenOptions, W as WindowControls } from './platform-CZHtdUK0.js';
+import { G as GarretPlatform } from './platform-K2c4rKaG.js';
+export { S as SurfaceApi, a as SurfaceHandle, b as SurfaceOpenOptions, W as WindowControls } from './platform-K2c4rKaG.js';
 import { ReactNode } from 'react';
 import './protocol-Do0BJdeE.js';
 
@@ -112,6 +112,8 @@ declare function useConfig<T>(): [T, (patch: Partial<T>) => void, (value: T) =>
 declare function useActive(): boolean;
 /** Run `cb` when the host (frame ⋯→Settings) asks this widget to reveal its own config UI. */
 declare function useOpenSettings(cb: () => void): void;
+/** Run `cb` when the host (frame ⋯→Refresh) asks this widget to reload. */
+declare function useRefresh(cb: () => void): void;
 /** Per-placement config backed by `g.instanceStorage` (isolated per widget instance). Loads once the
  *  runtime binds (calls before bind reject); `set` writes through to storage + state. `loaded` gates
  *  the first data fetch so you don't fetch with defaults before the saved config arrives. */
@@ -126,4 +128,4 @@ declare function useInstanceConfig<T extends Record<string, unknown>>(defaults:
  *  time), so this re-renders when the runtime binds. The `T` is an unchecked cast — validate it yourself. */
 declare function useProps<T = Record<string, unknown>>(): T;
 
-export { Accordion, Badge, Dot, EmptyState, ErrorState, Field, FieldGroup, GarretError, GarretPlatform, Item, NumberInput, Scroll, Select, SettingsPanel, type StreamStatus, Switch, TextInput, type Tone, type UseStreamResult, useActive, useConfig, useGarret, useHost, useHostEvent, useInstanceConfig, useOpenSettings, useProps, useStream };
+export { Accordion, Badge, Dot, EmptyState, ErrorState, Field, FieldGroup, GarretError, GarretPlatform, Item, NumberInput, Scroll, Select, SettingsPanel, type StreamStatus, Switch, TextInput, type Tone, type UseStreamResult, useActive, useConfig, useGarret, useHost, useHostEvent, useInstanceConfig, useOpenSettings, useProps, useRefresh, useStream };

package/dist/react.js

@@ -1,4 +1,4 @@
-import { getGarret, getRuntime, getHostTransport, createHostClient, getInstanceId } from './chunk-ZJYHRC5C.js';
+import { getGarret, getRuntime, getHostTransport, createHostClient, getInstanceId } from './chunk-YBYF7JQS.js';
 import { GarretError } from './chunk-ENIDFSMM.js';
 export { GarretError } from './chunk-ENIDFSMM.js';
 import { useState, useMemo, useEffect, useRef, useCallback } from 'react';
@@ -197,6 +197,12 @@ function useOpenSettings(cb) {
   ref.current = cb;
   useEffect(() => g.onOpenSettings(() => ref.current()), [g]);
 }
+function useRefresh(cb) {
+  const g = getGarret();
+  const ref = useRef(cb);
+  ref.current = cb;
+  useEffect(() => g.onRefresh(() => ref.current()), [g]);
+}
 function useInstanceConfig(defaults) {
   const g = getGarret();
   const [cfg, setCfg] = useState(defaults);
@@ -239,4 +245,4 @@ function useProps() {
   return props;
 }
 
-export { Accordion, Badge, Dot, EmptyState, ErrorState, Field, FieldGroup, Item, NumberInput, Scroll, Select, SettingsPanel, Switch, TextInput, useActive, useConfig, useGarret, useHost, useHostEvent, useInstanceConfig, useOpenSettings, useProps, useStream };
+export { Accordion, Badge, Dot, EmptyState, ErrorState, Field, FieldGroup, Item, NumberInput, Scroll, Select, SettingsPanel, Switch, TextInput, useActive, useConfig, useGarret, useHost, useHostEvent, useInstanceConfig, useOpenSettings, useProps, useRefresh, useStream };

package/dist/ui.cjs

@@ -217,6 +217,10 @@ function getGarret() {
     },
     onOpenSettings: () => () => {
     },
+    onRefresh: () => () => {
+    },
+    setTitle: () => {
+    },
     surfaces: { open: nope, onClosed: () => () => {
     } },
     window: { setAspectRatio: () => {

package/dist/ui.d.cts

@@ -1,7 +1,7 @@
 import { T as Transport } from './protocol-Do0BJdeE.cjs';
 import { E as EventMap, H as HostClient } from './types-BxSYAH_H.cjs';
 export { C as Capability, G as GarretError, M as Manifest, S as Stream, f as StreamCall, g as defineConfig, h as defineManifest } from './types-BxSYAH_H.cjs';
-export { G as GarretPlatform, c as GarretRuntime, d as SecretsApi, e as ServiceClient, f as StorageApi, S as SurfaceApi, a as SurfaceHandle, b as SurfaceOpenOptions, W as WindowControls, g as getGarret, h as getHostTransport, i as getInstanceId, j as getRuntime } from './platform-DnI7gJTx.cjs';
+export { G as GarretPlatform, c as GarretRuntime, d as SecretsApi, e as ServiceClient, f as StorageApi, S as SurfaceApi, a as SurfaceHandle, b as SurfaceOpenOptions, W as WindowControls, g as getGarret, h as getHostTransport, i as getInstanceId, j as getRuntime } from './platform-DjRN9xTv.cjs';
 
 /**
  * UI-side host client — a typed proxy over the wire (protocol.ts). Every call returns ONE handle

package/dist/ui.d.ts

@@ -1,7 +1,7 @@
 import { T as Transport } from './protocol-Do0BJdeE.js';
 import { E as EventMap, H as HostClient } from './types-BxSYAH_H.js';
 export { C as Capability, G as GarretError, M as Manifest, S as Stream, f as StreamCall, g as defineConfig, h as defineManifest } from './types-BxSYAH_H.js';
-export { G as GarretPlatform, c as GarretRuntime, d as SecretsApi, e as ServiceClient, f as StorageApi, S as SurfaceApi, a as SurfaceHandle, b as SurfaceOpenOptions, W as WindowControls, g as getGarret, h as getHostTransport, i as getInstanceId, j as getRuntime } from './platform-CZHtdUK0.js';
+export { G as GarretPlatform, c as GarretRuntime, d as SecretsApi, e as ServiceClient, f as StorageApi, S as SurfaceApi, a as SurfaceHandle, b as SurfaceOpenOptions, W as WindowControls, g as getGarret, h as getHostTransport, i as getInstanceId, j as getRuntime } from './platform-K2c4rKaG.js';
 
 /**
  * UI-side host client — a typed proxy over the wire (protocol.ts). Every call returns ONE handle

package/dist/ui.js

@@ -1,3 +1,3 @@
 export { defineConfig, defineManifest } from './chunk-RZJO3X6O.js';
-export { createHostClient, getGarret, getHostTransport, getInstanceId, getRuntime } from './chunk-ZJYHRC5C.js';
+export { createHostClient, getGarret, getHostTransport, getInstanceId, getRuntime } from './chunk-YBYF7JQS.js';
 export { GarretError } from './chunk-ENIDFSMM.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@garretapp/sdk",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Build extensions for Garret — one SDK for both web widgets and full-access native extensions. Host runtime (defineHost), UI client + React hooks. See docs/garret.html.",
   "license": "MIT",
   "author": "Sudharsan Selvaraj",