@nebulahome/package-sdk 1.5.0 → 1.6.0

package/CHANGELOG.md

@@ -3,6 +3,19 @@
 The SDK's version is the version of the package API the platform implements: a minor version adds
 to it, a major one breaks it, and a patch leaves it as it is.
 
+## 1.6.0
+
+- **The background.** `ui.background: defineBackground({ component, description })` is a
+  component the interface draws on every page, out of sight, for as long as somebody is signed in
+  and the package runs - for what must outlive a page, sound playing in the browser above all. It
+  is unmounted when the package stops, is turned off or removed, and mounted afresh by an update,
+  so what it starts belongs in effects. Its `description` (1-256 characters) is shown on the
+  package's page; the manifest records it as `ui.background`.
+- **`<Floating open label onClose?>`** draws a window of the package over the interface's pages,
+  from its background, page or card: in a corner of the page beside the rail, thrown from corner to
+  corner with a small bounce, one a package, hidden on the package's own page and on a phone.
+  `onClose` gives it a close button and says what closing does.
+
 ## 1.5.0
 
 - **The live channel.** A package's server and its open interfaces talk over the interface's own

package/README.md

@@ -182,18 +182,49 @@ A topic is a letter, then letters, digits and `.`, `_`, `:`, `-`; a message from
 most 1 MB as JSON, one from the interface 64 KB, and an interface sends at most 50 a second.
 Nothing answers a message: a call that wants an answer or an error stays `usePackageCall`.
 
+## The background and floating windows
+
+A component drawn on every page for as long as somebody is signed in and the package runs, for
+what must outlive a page, and a window floating over the pages (since 1.6):
+
+```ts
+// nebula.config.ts
+ui: {
+  background: defineBackground({
+    component: () => import('./src/ui/background.js'),
+    description: 'Keeps music playing in this browser when you leave the Music page.',
+  }),
+}
+```
+
+```tsx
+// src/ui/background.tsx: every hook works here; start things in effects, the unmount stops them
+export default function Background() {
+  const { t } = useTranslation();
+
+  return (
+    <Floating open={isPlaying} label={t('mini.label', 'Now playing')}>
+      <MiniPlayer />
+    </Floating>
+  );
+}
+```
+
+The window rests in a corner of the page beside the rail and is thrown from corner to corner; it is
+hidden on the package's own page and on a phone. `onClose` gives it a close button.
+
 ## Entry points
 
-| Import                    | What                                                                                                                                                                                                                                                            |
-| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `@nebulahome/package-sdk` | `definePackage`, `defineSettings`, `defineCard`, `defineEntityType`, `definePage`, `defineContainer`, `defineCompose`, `field`, entity id helpers, `SDK_VERSION`, the value types.                                                                              |
-| `/server`                 | `defineServer`, and the context `start` is given: settings (live or restart), devices and entities, typed custom entities, the rest of the house and its past, methods and the live channel for the interface, services between packages.                       |
-| `/ui`                     | The props of a page, a card and an entity view; hooks for the package, its methods and live topics, its settings, the house, its areas, its past and its pictures, the viewer, the theme, its strings; navigation inside the package's page and the platform's. |
-| `/sun`                    | Where the sun is at any moment, by the platform's own formulas.                                                                                                                                                                                                 |
-| `/components`             | The part of the interface's design system a package may draw with.                                                                                                                                                                                              |
-| `/vite`                   | `nebula()`, the Vite plugin that builds both halves: the interface in chunks with its CSS scoped to the package, the server bundled whole.                                                                                                                      |
-| `/testing`                | `createTestContext()`: run `start` in a unit test, every effect recorded.                                                                                                                                                                                       |
-| `/styles.css`             | The interface's Tailwind tokens, to `@reference`.                                                                                                                                                                                                               |
+| Import                    | What                                                                                                                                                                                                                                                                                      |
+| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `@nebulahome/package-sdk` | `definePackage`, `defineSettings`, `defineCard`, `defineEntityType`, `definePage`, `defineBackground`, `defineContainer`, `defineCompose`, `field`, entity id helpers, `SDK_VERSION`, the value types.                                                                                    |
+| `/server`                 | `defineServer`, and the context `start` is given: settings (live or restart), devices and entities, typed custom entities, the rest of the house and its past, methods and the live channel for the interface, services between packages.                                                 |
+| `/ui`                     | The props of a page, a background, a card and an entity view; `Floating`; hooks for the package, its methods and live topics, its settings, the house, its areas, its past and its pictures, the viewer, the theme, its strings; navigation inside the package's page and the platform's. |
+| `/sun`                    | Where the sun is at any moment, by the platform's own formulas.                                                                                                                                                                                                                           |
+| `/components`             | The part of the interface's design system a package may draw with.                                                                                                                                                                                                                        |
+| `/vite`                   | `nebula()`, the Vite plugin that builds both halves: the interface in chunks with its CSS scoped to the package, the server bundled whole.                                                                                                                                                |
+| `/testing`                | `createTestContext()`: run `start` in a unit test, every effect recorded.                                                                                                                                                                                                                 |
+| `/styles.css`             | The interface's Tailwind tokens, to `@reference`.                                                                                                                                                                                                                                         |
 
 The `nebulahome-package` command checks, builds and packs a package:
 

package/dist/chunks/node-build.js

@@ -6850,7 +6850,7 @@ function composeFileProblems(text, settingKeys) {
 * the two are compared before a package is installed or started (PACKAGES_DOCS.md 11).
 */
 /** The SDK's own version, `1.0.0`. */
-const SDK_VERSION = "1.5.0";
+const SDK_VERSION = "1.6.0";
 //#endregion
 //#region src/vite/catalogues.ts
 /**
@@ -12911,6 +12911,7 @@ function uiEntryCode(configPath, catalogues) {
 		"  kind: 'nebula.ui',",
 		`  sdk: ${JSON.stringify(SDK_VERSION)},`,
 		"  page: ui.page?.component,",
+		"  background: ui.background?.component,",
 		"  cards: ui.cards ?? {},",
 		"  entityViews: ui.entityViews ?? {},",
 		"  locales: {",

package/dist/chunks/node-config.js

@@ -6313,7 +6313,12 @@ const packageUiSchema = strictObject({
 	/** The cards it adds to the dashboard editor. */
 	cards: array(packageCardSchema).max(16).default([]),
 	/** Which of its entity types it draws itself, on an entity's page. */
-	entityViews: array(localIdSchema).max(16).default([])
+	entityViews: array(localIdSchema).max(16).default([]),
+	/**
+	* A component it draws on every page, for as long as somebody is signed in, and what it does in
+	* a sentence its page shows. Since package SDK 1.6.
+	*/
+	background: strictObject({ description: string().min(1).max(256) }).nullable().default(null)
 });
 /**
 * The words that appear more than once in a list.
@@ -6736,15 +6741,18 @@ function containersOf(containers, found) {
 * @param cardIds - The ids of the declared cards.
 * @param typeIds - The ids of the declared entity types.
 * @param found - Where problems go.
-* @returns Whether it has a page, its sidebar entry, and the types it draws.
+* @returns Whether it has a page, its sidebar entry, its background, and the types it draws.
 */
 function boundUi(ui, cardIds, typeIds, found) {
 	const bound = isRecord(ui) ? ui : {};
 	const page = bound["page"];
+	const background = bound["background"];
 	const cards = isRecord(bound["cards"]) ? bound["cards"] : {};
 	const views = isRecord(bound["entityViews"]) ? bound["entityViews"] : {};
 	if (page !== void 0 && (!isRecord(page) || page["kind"] !== "page")) found.add("ui.page", "must be a page, declared with definePage");
 	if (isRecord(page) && typeof page["component"] !== "function") found.add("ui.page.component", "must load the page's component: () => import('./page.js')");
+	if (background !== void 0 && (!isRecord(background) || background["kind"] !== "background")) found.add("ui.background", "must be a background, declared with defineBackground");
+	if (isRecord(background) && typeof background["component"] !== "function") found.add("ui.background.component", "must load the background's component: () => import('./background.js')");
 	for (const id of cardIds) if (typeof cards[id] !== "function") found.add(`ui.cards.${id}`, "the card has no component: () => import('./card.js')");
 	for (const id of Object.keys(cards).filter((each) => !cardIds.includes(each))) found.add(`ui.cards.${id}`, "is not one of the declared cards");
 	for (const [id, loader] of Object.entries(views)) if (!typeIds.includes(id)) found.add(`ui.entityViews.${id}`, "is not one of the declared entity types");
@@ -6753,8 +6761,9 @@ function boundUi(ui, cardIds, typeIds, found) {
 	return {
 		page: isRecord(page),
 		sidebar: isRecord(page) ? page["sidebar"] : void 0,
+		background: isRecord(background) ? { description: background["description"] } : null,
 		entityViews,
-		hasUi: isRecord(page) || cardIds.length > 0 || entityViews.length > 0
+		hasUi: isRecord(page) || isRecord(background) || cardIds.length > 0 || entityViews.length > 0
 	};
 }
 /**
@@ -6821,7 +6830,8 @@ function generatePackage(definition, options) {
 			page: ui.page,
 			...ui.sidebar === void 0 ? {} : { sidebar: ui.sidebar },
 			cards,
-			entityViews: ui.entityViews
+			entityViews: ui.entityViews,
+			...ui.background === null ? {} : { background: ui.background }
 		} } : {},
 		...settingFields.length > 0 ? { setup: releasePath(RELEASE_PATHS.setup) } : {},
 		containers,

package/dist/chunks/props.d.ts

@@ -43,6 +43,10 @@ type Loader<TProps> = () => Promise<PackageComponent<TProps> | {
 type PageProps = {
   readonly packageId: string;
 };
+/** What the package's background is given. Since 1.6. */
+type BackgroundProps = {
+  readonly packageId: string;
+};
 /** What a card is given. */
 type CardProps<TCard extends CardDefinition = CardDefinition> = {
   readonly packageId: string;
@@ -65,4 +69,4 @@ type EntityViewProps<TType extends EntityTypeDefinition = EntityTypeDefinition>
   readonly type: TType['id'];
 };
 //#endregion
-export { PageProps as a, CardSize as c, defineCard as d, PackageComponent as i, OptionsOf as l, EntityViewProps as n, CardDefinition as o, Loader as r, CardPadding as s, CardProps as t, SizeOf as u };
+export { PackageComponent as a, CardPadding as c, SizeOf as d, defineCard as f, Loader as i, CardSize as l, CardProps as n, PageProps as o, EntityViewProps as r, CardDefinition as s, BackgroundProps as t, OptionsOf as u };

package/dist/chunks/version.js

@@ -7,6 +7,6 @@
 * the two are compared before a package is installed or started (PACKAGES_DOCS.md 11).
 */
 /** The SDK's own version, `1.0.0`. */
-const SDK_VERSION = "1.5.0";
+const SDK_VERSION = "1.6.0";
 //#endregion
 export { SDK_VERSION as t };

package/dist/index.d.ts

@@ -1,5 +1,22 @@
 import { $ as PlaybackState, A as SecretOptions, B as field, C as ListField, D as NumberOptions, E as NumberField, F as TextOptions, G as CapabilityState, H as CapabilityCommands, I as TimestampField, J as CustomValue, K as CapabilityStates, L as TimestampOptions, M as ShownWhen, N as Simplify, O as OptionField, P as TextField, Q as LawnMowerActivity, R as ValueField, S as FormValues, T as NoFields, U as CapabilityName, V as CapabilityCommand, W as CapabilityParams, X as EntityStateClass, Y as DeclaredCapabilities, Z as ImageContentType, _ as ChoiceOption, a as SettingsOf, at as VacuumActivity, b as Field, c as CommandDeclaration, ct as EntityDomain, d as EntityTypeDefinition, dt as isEntityId, et as ReportedCapabilityState, f as ValuesOf, ft as parseEntityId, g as ChoiceField, h as BooleanOptions, i as SettingsDefinition, it as ThermostatMode, j as SettingField, k as SecretField, l as CommandDeclarations, lt as EntityId, m as BooleanField, n as JsonPrimitive, nt as SelectOption, o as defineSettings, ot as VacuumRoom, p as defineEntityType, q as CommandableCapability, r as JsonValue, rt as ThermostatAction, s as ArgsOf, st as ENTITY_DOMAINS, t as JsonObject, tt as ReportedStates, u as CommandsOf, ut as ParsedEntityId, v as ChoiceOptions, w as ListOptions, x as Fields, y as EntityValues, z as ValueOfField } from "./chunks/json.js";
-import { a as PageProps, c as CardSize, d as defineCard, i as PackageComponent, l as OptionsOf, n as EntityViewProps, o as CardDefinition, r as Loader, s as CardPadding, t as CardProps, u as SizeOf } from "./chunks/props.js";
+import { a as PackageComponent, c as CardPadding, d as SizeOf, f as defineCard, i as Loader, l as CardSize, n as CardProps, o as PageProps, r as EntityViewProps, s as CardDefinition, t as BackgroundProps, u as OptionsOf } from "./chunks/props.js";
+//#region src/definitions/background.d.ts
+/** The package's background, as declared. */
+type BackgroundDefinition = {
+  readonly kind: 'background';
+  readonly component: Loader<BackgroundProps>;
+  /** What it does, in a sentence the package's page shows. At most 256 characters. */
+  readonly description: string;
+};
+/**
+ * Declares the package's background. A package has at most one: `ui.background` is a single
+ * field.
+ *
+ * @param background - Its component's loader, and what it does.
+ * @returns The background, for `definePackage`'s `ui.background`.
+ */
+export declare function defineBackground(background: Omit<BackgroundDefinition, 'kind'>): BackgroundDefinition;
+//#endregion
 //#region src/definitions/containers.d.ts
 /**
  * `defineContainer` and `defineCompose`: what a package runs beside or instead of its process
@@ -145,6 +162,8 @@ type PackageRequires = {
 type PackageUi<TCards extends readonly CardDefinition[], TTypes extends readonly EntityTypeDefinition[]> = {
   /** Its own page. */
   readonly page?: PageDefinition;
+  /** What it draws on every page, for as long as somebody is signed in. Since 1.6. */
+  readonly background?: BackgroundDefinition;
   /** A component for every declared card, by its id. */
   readonly cards?: { readonly [TId in TCards[number]['id']]: Loader<CardPropsFor<TCards, TId>>; };
   /** Views of the entity types it draws itself, by their ids. */
@@ -202,4 +221,4 @@ export declare function definePackage<const TCards extends readonly CardDefiniti
 /** The SDK's own version, `1.0.0`. */
 export declare const SDK_VERSION: string;
 //#endregion
-export { type ArgsOf, type BooleanField, type BooleanOptions, type CapabilityCommand, type CapabilityCommands, type CapabilityName, type CapabilityParams, type CapabilityState, type CapabilityStates, type CardDefinition, type CardPadding, type CardProps, type CardSize, type ChoiceField, type ChoiceOption, type ChoiceOptions, type CommandDeclaration, type CommandDeclarations, type CommandableCapability, type CommandsOf, type ComposeDefinition, type ContainerCondition, type ContainerDefinition, type ContainerPort, type CustomValue, type DeclaredCapabilities, ENTITY_DOMAINS, type EntityDomain, type EntityId, type EntityStateClass, type EntityTypeDefinition, type EntityValues, type EntityViewProps, type Field, type Fields, type FormValues, type ImageContentType, type JsonObject, type JsonPrimitive, type JsonValue, type LawnMowerActivity, type ListField, type ListOptions, type Loader, type NoFields, type NumberField, type NumberOptions, type OptionField, type OptionsOf, type PackageCategory, type PackageComponent, type PackageConfig, type PackageDefinition, type PackageRequires, type PackageUi, type PageDefinition, type PageProps, type ParsedEntityId, type PlaybackState, type ReportedCapabilityState, type ReportedStates, type SecretField, type SecretOptions, type SelectOption, type SettingField, type SettingPlaceholder, type SettingsDefinition, type SettingsOf, type ShownWhen, type SidebarEntry, type Simplify, type SizeOf, type TextField, type TextOptions, type ThermostatAction, type ThermostatMode, type TimestampField, type TimestampOptions, type VacuumActivity, type VacuumRoom, type ValueField, type ValueOfField, type ValuesOf, type When, defineCard, defineEntityType, defineSettings, field, isEntityId, parseEntityId };
+export { type ArgsOf, type BackgroundDefinition, type BackgroundProps, type BooleanField, type BooleanOptions, type CapabilityCommand, type CapabilityCommands, type CapabilityName, type CapabilityParams, type CapabilityState, type CapabilityStates, type CardDefinition, type CardPadding, type CardProps, type CardSize, type ChoiceField, type ChoiceOption, type ChoiceOptions, type CommandDeclaration, type CommandDeclarations, type CommandableCapability, type CommandsOf, type ComposeDefinition, type ContainerCondition, type ContainerDefinition, type ContainerPort, type CustomValue, type DeclaredCapabilities, ENTITY_DOMAINS, type EntityDomain, type EntityId, type EntityStateClass, type EntityTypeDefinition, type EntityValues, type EntityViewProps, type Field, type Fields, type FormValues, type ImageContentType, type JsonObject, type JsonPrimitive, type JsonValue, type LawnMowerActivity, type ListField, type ListOptions, type Loader, type NoFields, type NumberField, type NumberOptions, type OptionField, type OptionsOf, type PackageCategory, type PackageComponent, type PackageConfig, type PackageDefinition, type PackageRequires, type PackageUi, type PageDefinition, type PageProps, type ParsedEntityId, type PlaybackState, type ReportedCapabilityState, type ReportedStates, type SecretField, type SecretOptions, type SelectOption, type SettingField, type SettingPlaceholder, type SettingsDefinition, type SettingsOf, type ShownWhen, type SidebarEntry, type Simplify, type SizeOf, type TextField, type TextOptions, type ThermostatAction, type ThermostatMode, type TimestampField, type TimestampOptions, type VacuumActivity, type VacuumRoom, type ValueField, type ValueOfField, type ValuesOf, type When, defineCard, defineEntityType, defineSettings, field, isEntityId, parseEntityId };

package/dist/index.js

@@ -1,4 +1,20 @@
 import { t as SDK_VERSION } from "./chunks/version.js";
+//#region src/definitions/background.ts
+/**
+* Declares the package's background. A package has at most one: `ui.background` is a single
+* field.
+*
+* @param background - Its component's loader, and what it does.
+* @returns The background, for `definePackage`'s `ui.background`.
+*/
+/* @__NO_SIDE_EFFECTS__ */
+function defineBackground(background) {
+	return {
+		...background,
+		kind: "background"
+	};
+}
+//#endregion
 //#region src/definitions/card.ts
 /**
 * Declares a card.
@@ -240,4 +256,4 @@ const field = {
 	})
 };
 //#endregion
-export { ENTITY_DOMAINS, SDK_VERSION, defineCard, defineCompose, defineContainer, defineEntityType, definePackage, definePage, defineSettings, field, isEntityId, parseEntityId };
+export { ENTITY_DOMAINS, SDK_VERSION, defineBackground, defineCard, defineCompose, defineContainer, defineEntityType, definePackage, definePage, defineSettings, field, isEntityId, parseEntityId };

package/dist/ui.d.ts

@@ -1,5 +1,5 @@
 import { G as CapabilityState, H as CapabilityCommands, S as FormValues, Y as DeclaredCapabilities, ct as EntityDomain, d as EntityTypeDefinition, f as ValuesOf, i as SettingsDefinition, lt as EntityId, q as CommandableCapability, r as JsonValue, s as ArgsOf, t as JsonObject, u as CommandsOf, z as ValueOfField } from "./chunks/json.js";
-import { a as PageProps, n as EntityViewProps, t as CardProps } from "./chunks/props.js";
+import { n as CardProps, o as PageProps, r as EntityViewProps, t as BackgroundProps } from "./chunks/props.js";
 import { a as TelemetryResolution, i as TelemetryPoint, n as HistorySeries, r as StateHistoryPoint, t as ChangeCause } from "./chunks/history.js";
 import { AnchorHTMLAttributes, ComponentType, ReactElement, ReactNode } from "react";
 //#region src/ui/types.d.ts
@@ -315,6 +315,20 @@ type PlatformLinkProps = LinkAttributes & {
 type PageActionsProps = {
   readonly children?: ReactNode;
 };
+/**
+ * A window of the package floating over the interface's pages, in a corner of the page beside the
+ * rail: one a package, thrown from corner to corner, hidden on the package's own page and on a
+ * phone. Since 1.6.
+ */
+type FloatingProps = {
+  /** Whether it is shown. */
+  readonly open: boolean;
+  /** What a screen reader calls it, in the viewer's language. */
+  readonly label: string;
+  /** What closing it does; without it the window has no close button. */
+  readonly onClose?: () => void;
+  readonly children?: ReactNode;
+};
 /** What a toast says. Since 1.4. */
 type ToastMessage = {
   /** A few words, no full stop. */
@@ -381,6 +395,8 @@ type UiHost = {
   readonly usePackageLive: <TData = JsonValue>(topic: string, options?: LiveOptions) => LiveState<TData>;
   /** Since 1.5. */
   readonly usePackageSend: () => PackageSend;
+  /** Since 1.6. */
+  readonly Floating: ComponentType<FloatingProps>;
 };
 //#endregion
 //#region src/ui/index.d.ts
@@ -588,5 +604,15 @@ export declare function PlatformLink(props: PlatformLinkProps): ReactElement;
  * @returns The actions.
  */
 export declare function PageActions(props: PageActionsProps): ReactElement;
+/**
+ * A window floating over the interface's pages, from the package's background, page or card -
+ * drawn while the component that draws it is, so a background's outlives every page. The
+ * interface gives the frame, the throwing from corner to corner and the close button; what is
+ * inside is the package's own. Since 1.6.
+ *
+ * @param props - Whether it is shown, what it is called, what closing it does, and what it holds.
+ * @returns The window.
+ */
+export declare function Floating(props: FloatingProps): ReactElement;
 //#endregion
-export type { AreaActions, AreaDraft, AreaKind, AreaView, CardProps, ChangeCause, CustomEntityState, EntitiesFilter, EntityPicture, EntityView, EntityViewProps, History, HistoryQuery, HistorySeries, HistoryWindow, LiveOptions, LiveState, Locale, Mutation, MutationOptions, PackageCall, PackageInfo, PackageLinkProps, PackageNavigate, PackageRoute, PackageSend, PackageSettings, PageActionsProps, PageProps, PictureOptions, PlatformLinkProps, PlatformNavigate, PlatformTarget, PluralEnglish, RpcOptions, RpcState, SendCommand, SettingsPatch, StateHistoryPoint, Telemetry, TelemetryPoint, TelemetryQuery, TelemetryResolution, Theme, ToastMessage, Toasts, Translate, Translation, TranslationValues, UiHost, Viewer, VisibleSettings };
+export type { AreaActions, AreaDraft, AreaKind, AreaView, BackgroundProps, CardProps, ChangeCause, CustomEntityState, EntitiesFilter, EntityPicture, EntityView, EntityViewProps, FloatingProps, History, HistoryQuery, HistorySeries, HistoryWindow, LiveOptions, LiveState, Locale, Mutation, MutationOptions, PackageCall, PackageInfo, PackageLinkProps, PackageNavigate, PackageRoute, PackageSend, PackageSettings, PageActionsProps, PageProps, PictureOptions, PlatformLinkProps, PlatformNavigate, PlatformTarget, PluralEnglish, RpcOptions, RpcState, SendCommand, SettingsPatch, StateHistoryPoint, Telemetry, TelemetryPoint, TelemetryQuery, TelemetryResolution, Theme, ToastMessage, Toasts, Translate, Translation, TranslationValues, UiHost, Viewer, VisibleSettings };

package/dist/ui.js

@@ -320,5 +320,17 @@ function PlatformLink(props) {
 function PageActions(props) {
 	return createElement(ui("PageActions", "1.3"), props);
 }
+/**
+* A window floating over the interface's pages, from the package's background, page or card -
+* drawn while the component that draws it is, so a background's outlives every page. The
+* interface gives the frame, the throwing from corner to corner and the close button; what is
+* inside is the package's own. Since 1.6.
+*
+* @param props - Whether it is shown, what it is called, what closing it does, and what it holds.
+* @returns The window.
+*/
+function Floating(props) {
+	return createElement(ui("Floating", "1.6"), props);
+}
 //#endregion
-export { PackageLink, PageActions, PlatformLink, useAreaActions, useAreas, useCommand, useCustomEntity, useEntities, useEntity, useEntityPicture, useLocale, usePackage, usePackageCall, usePackageLive, usePackageMutation, usePackageNavigate, usePackageRoute, usePackageRpc, usePackageSend, usePackageSettings, usePlatformNavigate, usePortalContainer, useStateHistory, useTelemetry, useTheme, useToast, useTranslation, useViewer };
+export { Floating, PackageLink, PageActions, PlatformLink, useAreaActions, useAreas, useCommand, useCustomEntity, useEntities, useEntity, useEntityPicture, useLocale, usePackage, usePackageCall, usePackageLive, usePackageMutation, usePackageNavigate, usePackageRoute, usePackageRpc, usePackageSend, usePackageSettings, usePlatformNavigate, usePortalContainer, useStateHistory, useTelemetry, useTheme, useToast, useTranslation, useViewer };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nebulahome/package-sdk",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Write a NebulaHome package: declare it, build it, and run it on the platform.",
   "license": "MIT",
   "type": "module",
@@ -100,10 +100,10 @@
     "vitest": "^4.1.11",
     "yaml": "^2.9.0",
     "zod": "^4.5.4",
-    "@nebulahome/contracts": "2026.10.0-alpha.23",
-    "@nebulahome/eslint-config": "2026.10.0-alpha.23",
-    "@nebulahome/ui": "2026.10.0-alpha.23",
-    "@nebulahome/tsconfig": "2026.10.0-alpha.23"
+    "@nebulahome/tsconfig": "2026.10.0-alpha.32",
+    "@nebulahome/contracts": "2026.10.0-alpha.32",
+    "@nebulahome/eslint-config": "2026.10.0-alpha.32",
+    "@nebulahome/ui": "2026.10.0-alpha.32"
   },
   "scripts": {
     "build": "tsdown && node scripts/build-styles.js",