@nebulahome/package-sdk 0.0.0-stage → 1.0.1

package/dist/server.js

@@ -0,0 +1,17 @@
+import { t as SDK_VERSION } from "./chunks/version.js";
+//#region src/server/index.ts
+/**
+* Declares a package's server: the default export of its entry module.
+*
+* @param server - Its settings, if it reads them, and its `start`.
+* @returns The server, stamped with the SDK version it was built with.
+*/
+function defineServer(server) {
+	return {
+		...server,
+		kind: "nebula.server",
+		sdk: SDK_VERSION
+	};
+}
+//#endregion
+export { defineServer };

package/dist/styles.css

@@ -0,0 +1,549 @@
+/* @nebulahome/package-sdk/styles.css: @reference it; it draws nothing. */
+@import 'tailwindcss/theme.css' layer(theme);
+
+/*
+ * The design system's tokens and utilities, and nothing that draws.
+ *
+ * Apart from `styles.css` so that what is not the interface - a package's stylesheet, through
+ * `@nebulahome/package-sdk/styles.css` - can `@reference` the tokens without the interface's
+ * fonts, base styles and `@source`, which would make it emit every class the interface uses.
+ */
+
+/*
+ * The design tokens: the Nebula system (`design/tokens.json`, the source of truth).
+ *
+ * Dark is the home theme. The neutrals lean indigo (hue ~268), the way the logo does, and the
+ * accent is the logo's own hue. Surfaces are flat fills separated by 1px lines: depth comes from
+ * the step between grounds - canvas, rail, surface, surface-raised, surface-high - never from a
+ * gradient or a shadow. The only resting shadow belongs to a dialog. Light is a counterpart of
+ * each token, set in `styles.css`, never an inversion.
+ *
+ * Every colour in the application resolves through one of these. A hard-coded colour in a
+ * component is a review failure (RULES.md 15.3), and so is a pixel value: the sizes, the radii
+ * and the type steps are tokens for the same reason the colours are.
+ *
+ * `static`: every token is on the page as a CSS variable, whether the interface uses it or not,
+ * because a package's own stylesheet reads them - `var(--color-primary)` - and a token missing
+ * from the page would leave its rule with nothing (PACKAGES_DOCS.md 6.2).
+ */
+
+@theme static {
+  /* --- grounds, darkest to lightest -------------------------------------------------- */
+
+  /** The page. Near-black with an indigo lean; the sky of sign-in is painted straight onto it. */
+  --color-canvas: #05060c;
+
+  /** The sidebar, one step darker than the page, and a disabled field. */
+  --color-rail: #07080f;
+
+  /** Cards, panels, dialogs: anything that holds content. Flat, with a 1px `border`. */
+  --color-surface: #0c0e19;
+
+  /**
+   * Things sitting on a surface: fields, ghost buttons, the active nav row, icon chips, hovered
+   * rows, the track of a fat slider.
+   */
+  --color-surface-raised: #141729;
+
+  /**
+   * The one step above raised: the chosen segment, thin tracks, nested tiles, a disabled primary.
+   * Keep `foreground-muted` or brighter on it.
+   */
+  --color-surface-high: #1b1f35;
+
+  /** The off track of a switch. Nothing else. */
+  --color-control: #23273d;
+
+  /* --- lines --------------------------------------------------------------------------- */
+
+  /** Edges of cards and panels, dividers between rows, the rail's edge. It separates. */
+  --color-border: #1c2036;
+
+  /**
+   * Edges of controls: fields, ghost buttons, pills, outlined badges, dialogs, the active nav row.
+   * The fill step and the shape carry a control; the edge only finishes it.
+   */
+  --color-border-strong: #262b45;
+
+  /* --- text ---------------------------------------------------------------------------- */
+
+  /** Body text and headings. */
+  --color-foreground: #eceefb;
+
+  /** Labels, inactive navigation, field labels, secondary sentences. */
+  --color-foreground-muted: #a4a8c6;
+
+  /**
+   * Captions, counts, timestamps, hints, group labels, placeholders. 5.28:1 on `surface`, 4.87:1
+   * on `surface-raised`; 4.46:1 on `surface-high`, so not for small text there.
+   */
+  --color-foreground-subtle: #8084a6;
+
+  /** Disabled text only, never a placeholder. */
+  --color-foreground-disabled: #4b5072;
+
+  /* --- accent ---------------------------------------------------------------------------- */
+
+  /** The logo's hue: the one primary action, an on-state, focus, the active nav icon. */
+  --color-primary: #7c86ff;
+  --color-primary-hover: #9aa3ff;
+
+  /** Text and glyphs on top of the accent. */
+  --color-primary-foreground: #05060c;
+
+  /** A selection's tint, and an accent note's ground. */
+  --color-primary-soft: rgb(124 134 255 / 0.1);
+
+  /** The focus halo of a field. */
+  --color-primary-ring: rgb(124 134 255 / 0.25);
+
+  /**
+   * The handle of a switch that is on, and of a slider: the lightest thing on a control in both
+   * themes, so the part a finger moves never sinks into its track. Off, a switch's knob is
+   * `foreground-muted`.
+   */
+  --color-knob: #ffffff;
+
+  /* --- entities: what kind of thing a card is about ---------------------------------------- */
+
+  /** A light's warmth, never a warning: a lit lamp, the level a slider fills to. */
+  --color-lamp: #ffc247;
+  --color-lamp-soft: rgb(255 194 71 / 0.1);
+
+  /** Heating. */
+  --color-heat: #ff8a4c;
+
+  /** Scenes, aliases and computed things; the If lane of an automation. */
+  --color-violet: #a78bfa;
+
+  /** Sensors, charts, live scanning; the When lane of an automation. */
+  --color-cyan: #4fd0ee;
+
+  /* --- states ------------------------------------------------------------------------------ */
+
+  --color-success: #52cd86;
+  --color-warning: #edb345;
+  --color-danger: #f75d59;
+
+  /** The tinted grounds of a state: a health card that needs attention, a soft note. */
+  --color-success-soft: rgb(82 205 134 / 0.12);
+  --color-warning-soft: rgb(237 179 69 / 0.12);
+  --color-danger-soft: rgb(247 93 89 / 0.1);
+
+  /** The edge of something dangerous or waiting: a danger button, a warning note. */
+  --color-danger-line: rgb(247 93 89 / 0.45);
+  --color-warning-line: rgb(237 179 69 / 0.4);
+
+  /* --- glass: only for what floats over the sky or the page ----------------------------------- */
+
+  /** The card on the sky. */
+  --color-glass: rgb(12 14 25 / 0.78);
+
+  /** Fields on glass. */
+  --color-veil: rgb(5 6 12 / 0.55);
+
+  /** Behind a dialog. */
+  --color-scrim: rgb(5 6 12 / 0.72);
+
+  /*
+   * --- tag palette --------------------------------------------------------------------------
+   * Twelve hues with one meaning between them: a tag the owner made, or a vendor's monogram. They
+   * are the only colours here that carry no verdict, which is why a tag is a chip of its own and
+   * never a badge.
+   */
+  --color-tag-red: #ff7a70;
+  --color-tag-orange: #ffa057;
+  --color-tag-amber: #ffc247;
+  --color-tag-yellow: #f2d94b;
+  --color-tag-lime: #b8e04a;
+  --color-tag-green: #52cd86;
+  --color-tag-teal: #43d6b8;
+  --color-tag-cyan: #4fd0ee;
+  --color-tag-blue: #62a9ff;
+  --color-tag-indigo: #8b96ff;
+  --color-tag-violet: #b48cff;
+  --color-tag-pink: #ff7ac8;
+
+  /*
+   * --- energy -----------------------------------------------------------------------------
+   * The three sources of a house's power, each drawn in its own colour wherever its power flows:
+   * the panels green, the battery blue, the grid yellow. Then the house the energy card draws,
+   * which is night in the dark theme - dark walls, lit windows - and day in the light one.
+   */
+  --color-energy-solar: #52cd86;
+  --color-energy-battery: #62a9ff;
+  --color-energy-grid: #f2d94b;
+
+  --color-house-wall: #161a2c;
+  --color-house-wall-shade: #111423;
+  --color-house-roof: #1b1f35;
+  --color-house-roof-edge: #262b45;
+  --color-house-panel: #1a2244;
+  --color-house-panel-line: #34406e;
+  --color-house-window: #f1e2bf;
+  --color-house-window-frame: #383e5c;
+  --color-house-wire: #2a2f4a;
+  --color-house-ground: #0a0c17;
+  --color-house-device: #c9cde2;
+
+  /* The details a style adds: tiles, trim, shutters, siding, a garage, a sand-coloured house. */
+  --color-house-trim: #2f3553;
+  --color-house-plinth: #10132a;
+  --color-house-interior: #05060c;
+  --color-house-panel-frame: #565e82;
+  --color-house-panel-cell: #090c1c;
+  --color-house-panel-glare: #8fa3dc;
+
+  /* --- shape ---------------------------------------------------------------------------- */
+  /*
+   * A pill is a control; a rounded rectangle holds things. A control inside a card takes the step
+   * below the card so the curves stay concentric.
+   */
+
+  --radius-check: 5px;
+  --radius-chip: 8px;
+  --radius-field: 10px;
+  --radius-tile: 12px;
+  --radius-inner: 14px;
+  --radius-card: 16px;
+  --radius-panel: 18px;
+  --radius-dialog: 22px;
+  --radius-pill: 9999px;
+
+  /* --- type ------------------------------------------------------------------------------ */
+  /*
+   * Named for the job, not the size. Each step carries its own line height and tracking:
+   * tracking tightens as size grows and opens only for `label` and `code`.
+   */
+
+  /**
+   * The interface raising its voice: group labels, breadcrumbs, card tops, "STEP 3 OF 7". Mono,
+   * uppercase, `foreground-subtle` - always with `font-mono uppercase`.
+   */
+  --text-label: 11px;
+  --text-label--line-height: 1.3;
+  --text-label--letter-spacing: 0.08em;
+  --text-label--font-weight: 400;
+
+  /** Hints, counts and timestamps; a field's label at weight 500. */
+  --text-caption: 12px;
+  --text-caption--line-height: 1.45;
+
+  /** Secondary sentences, compact buttons, option labels in dense lists. */
+  --text-ui-sm: 13px;
+  --text-ui-sm--line-height: 1.45;
+
+  /** Body text and the label of every button, field and nav row. The default. */
+  --text-ui: 14px;
+  --text-ui--line-height: 1.45;
+  --text-ui--letter-spacing: -0.006em;
+
+  /** A row's title, a card's name, a tile's name. */
+  --text-title: 15px;
+  --text-title--line-height: 1.35;
+  --text-title--letter-spacing: -0.01em;
+
+  /** A panel's heading. */
+  --text-subhead: 16px;
+  --text-subhead--line-height: 1.3;
+  --text-subhead--letter-spacing: -0.014em;
+
+  /** A dialog's title. */
+  --text-headline-sm: 18px;
+  --text-headline-sm--line-height: 1.25;
+  --text-headline-sm--letter-spacing: -0.018em;
+
+  /** The sign-in card's title; the lockup's name at weight 600. */
+  --text-headline: 22px;
+  --text-headline--line-height: 1.25;
+  --text-headline--letter-spacing: -0.02em;
+
+  /** The page title, one per screen, with its meta beside it in `mono-ui`. */
+  --text-display: 30px;
+  --text-display--line-height: 1.15;
+  --text-display--letter-spacing: -0.03em;
+
+  /** The number an entity card is about; its unit follows at half size in `foreground-subtle`. */
+  --text-reading: 32px;
+  --text-reading--line-height: 1;
+  --text-reading--letter-spacing: -0.03em;
+
+  /** A state spelled in words on a card: Locked, Open, Paused. */
+  --text-reading-sm: 22px;
+  --text-reading-sm--line-height: 1.1;
+  --text-reading-sm--letter-spacing: -0.02em;
+
+  /** Versions, addresses, ids. With `font-mono`. */
+  --text-mono-caption: 12px;
+  --text-mono-caption--line-height: 1.45;
+
+  /** The meta beside a page title; keys and values in tables. With `font-mono`. */
+  --text-mono-ui: 13px;
+  --text-mono-ui--line-height: 1.45;
+
+  /** The clock card. With `font-mono`. */
+  --text-mono-reading: 40px;
+  --text-mono-reading--line-height: 1;
+  --text-mono-reading--letter-spacing: -0.04em;
+
+  /**
+   * A code read one character at a time: the six digits of a second factor, one per box. Opened
+   * right out, because a person is copying them across from a phone. With `font-mono`.
+   */
+  --text-code: 20px;
+  --text-code--line-height: 1.2;
+  --text-code--letter-spacing: 0.12em;
+
+  --tracking-code: 0.12em;
+
+  --font-sans: Geist, 'Helvetica Neue', Arial, sans-serif;
+  --font-mono: 'Geist Mono', ui-monospace, monospace;
+
+  /* --- control heights -------------------------------------------------------------------- */
+  /*
+   * So that a button and the field beside it line up without anybody measuring.
+   *
+   * Deliberately *not* `--spacing-control`, even though that is the namespace they belong to by
+   * meaning. Naming a value inside `--spacing-*` replaces the whole spacing namespace, which
+   * takes the numeric scale down with it: `p-2`, `gap-4` and `h-16` stop being generated
+   * everywhere in the application, and nothing reports it - the classes are simply absent and
+   * every margin collapses to zero. They are plain variables read by the `h-control` utilities
+   * below instead, which leaves Tailwind's own scale alone.
+   */
+
+  /** Compact buttons, icon buttons, a field in a dense row. */
+  --control-height-sm: 30px;
+
+  /** Buttons, search. */
+  --control-height: 36px;
+
+  /** Form fields. */
+  --control-height-field: 38px;
+
+  /** Sign-in fields. */
+  --control-height-lg: 44px;
+
+  /** The one button of an auth screen. */
+  --control-height-xl: 46px;
+
+  /* --- depth -------------------------------------------------------------------------------- */
+  /*
+   * Flat. A panel has no resting shadow; an entity card has the faint lit top edge of `edge`. A
+   * dialog and the sign-in card take `dialog`, a menu and a dragged card `float`, a focused
+   * field `focus`.
+   */
+
+  --shadow-edge: inset 0 1px 0 rgb(255 255 255 / 0.04);
+  --shadow-focus: 0 0 0 3px rgb(124 134 255 / 0.25);
+  --shadow-float: 0 24px 48px -12px rgb(0 0 0 / 0.7);
+  --shadow-dialog: 0 30px 80px -20px rgb(0 0 0 / 0.9);
+
+  /* --- motion ---------------------------------------------------------------------------- */
+
+  /**
+   * The orbit, while something is loading. One turn every 1.2 seconds.
+   *
+   * The interface holds the opening frame for a whole number of these, so that the mark comes to
+   * rest with its notch where it started rather than snapping there from wherever the animation
+   * had got to. `ORBIT_PERIOD_MS` in the web interface is this number, and a test keeps them
+   * together.
+   */
+  --animate-orbit: orbit 1.2s linear infinite;
+
+  /** The sky's layers: far clouds, near clouds and stars, each its own slow loop, there and back. */
+  --animate-sky-far: sky-far 95s ease-in-out infinite alternate;
+  --animate-sky-near: sky-near 70s ease-in-out infinite alternate;
+  --animate-sky-stars: sky-stars 120s ease-in-out infinite alternate;
+
+  /**
+   * A thing that has just arrived.
+   *
+   * Ease-out from an already-visible default, so a dropped frame leaves the element in place
+   * rather than invisible. Short enough that nobody waits for it.
+   */
+  --animate-rise: rise 160ms cubic-bezier(0.16, 1, 0.3, 1);
+  --animate-fade-in: fade-in 120ms ease-out;
+
+  /**
+   * Power moving along a wire of the energy card: its dashes travel one period of their pattern
+   * per turn. How long a turn takes is the card's to say, by the power on the wire, and which way
+   * the dashes go by `animation-direction`.
+   */
+  --animate-energy-flow: energy-flow 1.6s linear infinite;
+}
+
+/* One period of a wire's dash pattern, which is 12 units long: 2 drawn, 10 gap. */
+@keyframes energy-flow {
+  to {
+    stroke-dashoffset: -12;
+  }
+}
+
+/*
+ * One turn about the mark's centre.
+ *
+ * The whole mark turns, not the outer body alone. The ring has a notch cut where that body sits,
+ * and spinning the body out of its notch would take the logo apart rather than animate it.
+ */
+@keyframes orbit {
+  to {
+    transform: rotate(360deg);
+  }
+}
+
+/* The sky's layers drift a little each way and back: parallax, the near layer furthest. */
+@keyframes sky-far {
+  from {
+    transform: translate3d(1.5%, 0.5%, 0) scale(1.05);
+  }
+  to {
+    transform: translate3d(-2%, -1.5%, 0) scale(1.01);
+  }
+}
+
+@keyframes sky-near {
+  from {
+    transform: translate3d(-1.5%, 1%, 0) scale(1.02);
+  }
+  to {
+    transform: translate3d(1.5%, -1%, 0) scale(1.06);
+  }
+}
+
+@keyframes sky-stars {
+  from {
+    transform: translate3d(0, 0, 0);
+  }
+  to {
+    transform: translate3d(-0.6%, 0.4%, 0);
+  }
+}
+
+/* A dropdown or a dialog arriving: it starts almost where it ends. */
+@keyframes rise {
+  from {
+    opacity: 0;
+    transform: translateY(-4px);
+  }
+}
+
+@keyframes fade-in {
+  from {
+    opacity: 0;
+  }
+}
+
+/*
+ * Turning an SVG group about the middle of its own view box.
+ *
+ * A utility rather than an inline style, which RULES.md 15 does not allow, and Tailwind has no
+ * `transform-box` of its own. Without it the browser may measure the origin from the element's
+ * bounding box - and the group's bounding box is not the mark's centre, so the logo would orbit
+ * around a point slightly off itself.
+ */
+@utility origin-view-box {
+  transform-box: view-box;
+  transform-origin: center;
+}
+
+/*
+ * The control heights, as utilities rather than as spacing tokens.
+ *
+ * See the note beside `--control-height` for why they cannot live in `--spacing-*`.
+ */
+@utility h-control-sm {
+  height: var(--control-height-sm);
+}
+
+@utility h-control {
+  height: var(--control-height);
+}
+
+@utility h-control-field {
+  height: var(--control-height-field);
+}
+
+@utility h-control-lg {
+  height: var(--control-height-lg);
+}
+
+@utility h-control-xl {
+  height: var(--control-height-xl);
+}
+
+@utility size-control-sm {
+  width: var(--control-height-sm);
+  height: var(--control-height-sm);
+}
+
+@utility size-control {
+  width: var(--control-height);
+  height: var(--control-height);
+}
+
+/*
+ * A strip that still scrolls but draws no bar: a row of pills, or the narrow rail, where a bar
+ * would take its room out of the very things it scrolls.
+ */
+@utility scrollbar-none {
+  scrollbar-width: none;
+}
+
+/*
+ * The scrollbar's room kept whether or not one is drawn, so that content measured from its
+ * width - the dashboard's grid - does not narrow, and slide, the moment one appears.
+ */
+@utility scrollbar-stable {
+  scrollbar-gutter: stable;
+}
+
+/* The catalogue's grid: as many 220px tiles as fit, sharing what is left over. */
+@utility grid-tiles {
+  grid-template-columns: repeat(auto-fill, minmax(220px, 1fr));
+}
+
+/*
+ * An entity card's ground: a faint two-stop wash, and - when its entity is on - a 14% glow of
+ * the entity's colour at the top-left, the one place colour is allowed to spread. The colour is
+ * `--glow`, set by the card from its kind (`[--glow:var(--color-lamp)]`); unset, no glow.
+ */
+@utility entity-wash {
+  background-image:
+    radial-gradient(
+      120% 90% at 0% 0%,
+      color-mix(in srgb, var(--glow, transparent) 14%, transparent) 0%,
+      transparent 60%
+    ),
+    linear-gradient(
+      180deg,
+      color-mix(in srgb, var(--color-surface-raised) 60%, var(--color-surface)) 0%,
+      var(--color-surface) 55%
+    );
+  box-shadow: var(--shadow-edge);
+}
+
+/*
+ * A word marked inside running text - a formula's variable - without moving a letter.
+ *
+ * Padding would shift every glyph after it, and in the formula field that is fatal: the
+ * coloured words are drawn under a transparent input, and the caret belongs to the input. So the
+ * mark is a tint behind the word and the same tint spread two pixels round it as a shadow,
+ * which reads as a padded chip and takes no room at all. Drawn in the word's own colour, so one
+ * utility serves every colour of the palette.
+ */
+@utility token-halo {
+  border-radius: calc(var(--radius-chip) / 2);
+  background-color: color-mix(in srgb, currentColor 15%, transparent);
+  box-shadow: 0 0 0 2px color-mix(in srgb, currentColor 15%, transparent);
+  box-decoration-break: clone;
+}
+
+/**
+ * Figures that hold their column.
+ *
+ * A reading that changes in place must not move the layout, and a column of numbers must line
+ * up. Both are the same font feature.
+ */
+@utility tabular {
+  font-variant-numeric: tabular-nums;
+}

package/dist/testing.d.ts

@@ -0,0 +1,117 @@
+import { V as CapabilityCommand, et as ReportedCapabilityState, i as SettingsDefinition, lt as EntityId, r as JsonValue, t as JsonObject } from "./chunks/json.js";
+import { C as StateChange, _ as ServerContext, f as ReportOptions, h as RpcCaller, l as EntitySnapshot, o as DeviceInput, t as Awaitable } from "./chunks/context.js";
+//#region src/testing/index.d.ts
+/** What a test context starts with. */
+export type TestContextOptions<TSettings extends SettingsDefinition | undefined> = {
+  /** The package's id: `test-package` when not said. */
+  readonly id?: string;
+  /** The release: `0.0.0` when not said. */
+  readonly version?: string;
+  /** The package's settings declaration, whose defaults apply. */
+  readonly definition?: TSettings;
+  /** What the owner saved. */
+  readonly settings?: JsonObject;
+  /** Entities of the house `ctx.entities` reads. */
+  readonly entities?: readonly EntitySnapshot[];
+  readonly dataDir?: string;
+  readonly cacheDir?: string;
+};
+/** One report the package made. */
+export type RecordedReport = {
+  readonly entityId: EntityId;
+  readonly state: ReportedCapabilityState;
+  readonly options?: ReportOptions;
+};
+/** One line the package logged. */
+export type RecordedLog = {
+  readonly level: 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+  readonly fields: Readonly<Record<string, unknown>>;
+  readonly message: string | undefined;
+};
+/** A context with no platform behind it, and what the package did with it. */
+export type TestContext<TSettings extends SettingsDefinition | undefined> = {
+  /** The context to hand `start`. */
+  readonly ctx: ServerContext<TSettings>;
+  /** The last list `devices.sync` was given. */
+  readonly synced: () => readonly DeviceInput[] | undefined;
+  readonly reports: {
+    /** Every report, in order. */
+    readonly all: readonly RecordedReport[];
+    /**
+     * The newest state reported for one entity.
+     *
+     * @param entityId - The entity.
+     * @returns Its state, or undefined when it was never reported.
+     */
+    readonly last: (entityId: EntityId) => ReportedCapabilityState | undefined;
+  };
+  /** Every line logged. */
+  readonly logs: readonly RecordedLog[];
+  /**
+   * Routes a command as the platform would: to the entity type's handler for a custom one, to
+   * `devices.onCommand` otherwise.
+   *
+   * @param command - The command.
+   * @returns Once handled; rejects with the handler's failure.
+   */
+  readonly sendCommand: (command: CapabilityCommand) => Promise<void>;
+  /**
+   * Calls one of the package's methods, through its input schema.
+   *
+   * @param method - The method.
+   * @param input - What it is handed.
+   * @param caller - Who calls; a test user when not said.
+   * @returns What it answered.
+   */
+  readonly callRpc: (method: string, input?: JsonValue, caller?: RpcCaller) => Promise<JsonValue | undefined>;
+  /**
+   * Calls one of the services the package provides.
+   *
+   * @param name - The service.
+   * @param input - What it is handed.
+   * @param caller - The calling package's id; `test` when not said.
+   * @returns What it answered.
+   */
+  readonly callService: (name: string, input?: unknown, caller?: string) => Promise<JsonValue | undefined>;
+  /**
+   * Changes settings as the owner would: when every field changed is live, the process hears
+   * it; otherwise the platform would restart it, which the test does if it wants to.
+   *
+   * @param patch - What changes.
+   * @returns Whether the platform would restart the package.
+   */
+  readonly changeSettings: (patch: JsonObject) => Promise<{
+    readonly isRestart: boolean;
+  }>;
+  /**
+   * Puts an entity of the house where `ctx.entities` reads it.
+   *
+   * @param snapshot - The entity.
+   */
+  readonly setEntity: (snapshot: EntitySnapshot) => void;
+  /**
+   * Changes an entity of the house, as `ctx.entities.subscribe` hears it.
+   *
+   * @param change - The change.
+   * @returns Once every handler ran.
+   */
+  readonly emitStateChange: (change: StateChange) => Promise<void>;
+  /**
+   * Answers a service the package calls.
+   *
+   * @param target - The package or service called.
+   * @param name - The service.
+   * @param handler - What it answers.
+   */
+  readonly answerService: (target: string, name: string, handler: (input: JsonValue | undefined) => Awaitable<unknown>) => void;
+  /** Asks the package to stop: aborts `ctx.signal`. */
+  readonly stop: () => void;
+};
+/**
+ * Builds a context with no platform behind it.
+ *
+ * @param options - Its id, settings and the house it reads.
+ * @returns The context, and what the package does with it.
+ */
+export declare function createTestContext<TSettings extends SettingsDefinition | undefined = undefined>(options?: TestContextOptions<TSettings>): TestContext<TSettings>;
+//#endregion