@nebulahome/package-sdk 1.1.0 → 1.3.0

package/dist/ui.js

@@ -173,6 +173,56 @@ function useTranslation() {
 	return lent === void 0 ? ENGLISH : lent();
 }
 /**
+* The recorded changes of some entities over a window, live as the window moves: what a chart of
+* an on/off thing, an activity list or a replay of a day is drawn from. Read with the viewer's
+* permissions: an entity they may not read has no points.
+*
+* @param query - Which entities (at most 64), which window, how often to read it again.
+* @returns Each entity's changes, oldest first, and whether the read is still on its way.
+*/
+function useStateHistory(query) {
+	return ui("useStateHistory", "1.2")(query);
+}
+/**
+* The numeric readings of some entities over a window: what a sensor's chart is drawn from. A
+* long window is read in buckets of a minute, an hour or a day, each with its lowest and highest.
+*
+* @param query - Which entities (at most 64), which window, which resolution (`auto` by default).
+* @returns Each entity's readings, oldest first, and the resolution they were read at.
+*/
+function useTelemetry(query) {
+	return ui("useTelemetry", "1.2")(query);
+}
+/**
+* The areas of the house: the house itself (with its position, when set), its floors and its
+* rooms, as the owner arranged them.
+*
+* @returns Them, in the owner's order.
+*/
+function useAreas() {
+	return ui("useAreas", "1.2")();
+}
+/**
+* Adds, renames and removes the house's floors and rooms, as the platform's areas page does, with
+* the viewer's permissions: `canEdit` says whether they hold them. Since 1.3.
+*
+* @returns What changes the areas.
+*/
+function useAreaActions() {
+	return ui("useAreaActions", "1.3")();
+}
+/**
+* A camera's latest still, fetched again every so often, or an image entity's picture, fetched
+* again when it changes: an address an `<img>` shows, let go of when a newer one replaces it.
+*
+* @param entityId - A `camera.*` or an `image.*` entity.
+* @param options - How often a still is fetched again, and whether at all.
+* @returns The address, or null before there is one.
+*/
+function useEntityPicture(entityId, options) {
+	return ui("useEntityPicture", "1.2")(entityId, options);
+}
+/**
 * The theme the interface draws in, for what draws its own colours: a canvas, a chart.
 *
 * @returns Light or dark.
@@ -230,5 +280,15 @@ function PackageLink(props) {
 function PlatformLink(props) {
 	return createElement(ui("PlatformLink", "1.0"), props);
 }
+/**
+* Buttons and links drawn in the header of the package's page, in place of the platform's own:
+* the page's actions, beside its title. On a card or a view it draws nothing. Since 1.3.
+*
+* @param props - What the header shows.
+* @returns The actions.
+*/
+function PageActions(props) {
+	return createElement(ui("PageActions", "1.3"), props);
+}
 //#endregion
-export { PackageLink, PlatformLink, useCommand, useCustomEntity, useEntities, useEntity, useLocale, usePackage, usePackageCall, usePackageMutation, usePackageNavigate, usePackageRoute, usePackageRpc, usePackageSettings, usePlatformNavigate, usePortalContainer, useTheme, useTranslation, useViewer };
+export { PackageLink, PageActions, PlatformLink, useAreaActions, useAreas, useCommand, useCustomEntity, useEntities, useEntity, useEntityPicture, useLocale, usePackage, usePackageCall, usePackageMutation, usePackageNavigate, usePackageRoute, usePackageRpc, usePackageSettings, usePlatformNavigate, usePortalContainer, useStateHistory, useTelemetry, useTheme, useTranslation, useViewer };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nebulahome/package-sdk",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "Write a NebulaHome package: declare it, build it, and run it on the platform.",
   "license": "MIT",
   "type": "module",
@@ -32,6 +32,10 @@
       "types": "./dist/ui.d.ts",
       "default": "./dist/ui.js"
     },
+    "./sun": {
+      "types": "./dist/sun.d.ts",
+      "default": "./dist/sun.js"
+    },
     "./components": {
       "types": "./dist/components.d.ts",
       "default": "./dist/components.js"
@@ -97,9 +101,9 @@
     "yaml": "^2.9.0",
     "zod": "^4.5.4",
     "@nebulahome/contracts": "0.0.0",
+    "@nebulahome/eslint-config": "0.0.0",
     "@nebulahome/tsconfig": "0.0.0",
-    "@nebulahome/ui": "0.0.0",
-    "@nebulahome/eslint-config": "0.0.0"
+    "@nebulahome/ui": "0.0.0"
   },
   "scripts": {
     "build": "tsdown && node scripts/build-styles.js",