@ikalogic/at1000 0.8.0 → 0.10.0

package/build/hmi-Chid1Vvo.d.mts

@@ -0,0 +1,236 @@
+import { i as EventsApi } from "./events-BVDWI2tr.mjs";
+import { UpFetch } from "up-fetch";
+import * as v from "valibot";
+//#region src/api/hmi.d.ts
+declare const screenText: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 1024, undefined>]>;
+type ScreenText = v.InferOutput<typeof screenText>;
+declare const text: v.ObjectSchema<{
+  readonly text: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 1024, undefined>]>;
+}, undefined>;
+declare const color: v.ObjectSchema<{
+  readonly text: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.LengthAction<string, 7, undefined>, v.HexColorAction<string, undefined>]>, undefined>;
+  readonly progress: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.LengthAction<string, 7, undefined>, v.HexColorAction<string, undefined>]>, undefined>;
+  readonly background: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.LengthAction<string, 7, undefined>, v.HexColorAction<string, undefined>]>, undefined>;
+}, undefined>;
+type Color = v.InferOutput<typeof color>;
+declare const progressValue: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 100, undefined>]>;
+type ProgressValue = v.InferOutput<typeof progressValue>;
+declare const progress: v.ObjectSchema<{
+  readonly progress: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 100, undefined>]>;
+}, undefined>;
+type Progress = v.InferOutput<typeof progress>;
+declare const playbackConfiguration: v.ObjectSchema<{
+  readonly sound_id: v.PicklistSchema<["success", "warning", "failure", "notification_1", "notification_2", "imperial_march"], undefined>;
+  readonly volume: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 100, undefined>]>;
+}, undefined>;
+type PlaybackConfiguration = v.InferOutput<typeof playbackConfiguration>;
+declare const internalKnobEvent: v.ObjectSchema<{
+  readonly button_pressed: v.BooleanSchema<undefined>;
+  readonly button_held: v.BooleanSchema<undefined>;
+  readonly rotation_delta: v.NumberSchema<undefined>;
+}, undefined>;
+declare const knobEvent: Omit<v.ObjectSchema<{
+  readonly button_pressed: v.BooleanSchema<undefined>;
+  readonly button_held: v.BooleanSchema<undefined>;
+  readonly rotation_delta: v.NumberSchema<undefined>;
+}, undefined>, "entries" | "~run" | "~standard" | "~types"> & {
+  readonly entries: Omit<{
+    readonly button_pressed: v.BooleanSchema<undefined>;
+    readonly button_held: v.BooleanSchema<undefined>;
+    readonly rotation_delta: v.NumberSchema<undefined>;
+  }, "button_held">;
+  readonly "~standard": v.StandardProps<{
+    button_pressed: boolean;
+    rotation_delta: number;
+  }, {
+    button_pressed: boolean;
+    rotation_delta: number;
+  }>;
+  readonly "~run": (dataset: v.UnknownDataset, config: v.Config<v.BaseIssue<unknown>>) => v.OutputDataset<{
+    button_pressed: boolean;
+    rotation_delta: number;
+  }, v.BooleanIssue | v.NumberIssue | v.ObjectIssue>;
+  readonly "~types"?: {
+    readonly input: {
+      button_pressed: boolean;
+      rotation_delta: number;
+    };
+    readonly output: {
+      button_pressed: boolean;
+      rotation_delta: number;
+    };
+    readonly issue: v.BooleanIssue | v.NumberIssue | v.ObjectIssue;
+  } | undefined;
+};
+type KnobEvent = v.InferOutput<typeof knobEvent>;
+declare const promptChoice: v.ObjectSchema<{
+  readonly label: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxBytesAction<string, 64, undefined>, v.RegexAction<string, "Choice labels must not be blank">, v.CheckAction<string, "Choice labels must not contain control characters">]>;
+  readonly color: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.LengthAction<string, 7, undefined>, v.HexColorAction<string, undefined>]>, undefined>;
+}, undefined>;
+type PromptChoice = v.InferOutput<typeof promptChoice>;
+declare const promptRequest: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+  readonly text: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxBytesAction<string, 256, undefined>, v.RegexAction<string, "Prompt text must not be blank">, v.CheckAction<string, "Prompt text permits line feeds but no other control characters">]>;
+  readonly choices: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.UnionSchema<[v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxBytesAction<string, 64, undefined>, v.RegexAction<string, "Choice labels must not be blank">, v.CheckAction<string, "Choice labels must not contain control characters">]>, v.ObjectSchema<{
+    readonly label: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxBytesAction<string, 64, undefined>, v.RegexAction<string, "Choice labels must not be blank">, v.CheckAction<string, "Choice labels must not contain control characters">]>;
+    readonly color: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.LengthAction<string, 7, undefined>, v.HexColorAction<string, undefined>]>, undefined>;
+  }, undefined>], undefined>, v.TransformAction<string | {
+    label: string;
+    color?: string | undefined;
+  }, {
+    label: string;
+    color?: string | undefined;
+  }>]>, undefined>, v.MinLengthAction<{
+    label: string;
+    color?: string | undefined;
+  }[], 1, undefined>, v.MaxLengthAction<{
+    label: string;
+    color?: string | undefined;
+  }[], 32, undefined>]>;
+  readonly default_index: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 31, undefined>]>, undefined>;
+  readonly timeout_ms: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1000, undefined>, v.MaxValueAction<number, 1800000, undefined>]>, undefined>;
+}, undefined>, v.CheckAction<{
+  text: string;
+  choices: {
+    label: string;
+    color?: string | undefined;
+  }[];
+  default_index?: number | undefined;
+  timeout_ms?: number | undefined;
+}, "default_index must be below the number of choices">]>;
+/** Wire shape, where every choice is an object. */
+type PromptRequest = v.InferOutput<typeof promptRequest>;
+/** Accepted shape, where a choice may be a bare label string. */
+type PromptRequestInput = v.InferInput<typeof promptRequest>;
+declare const promptSelection: v.ObjectSchema<{
+  readonly label: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxBytesAction<string, 64, undefined>, v.RegexAction<string, "Choice labels must not be blank">, v.CheckAction<string, "Choice labels must not contain control characters">]>;
+  readonly index: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 31, undefined>]>;
+}, undefined>;
+type PromptSelection = v.InferOutput<typeof promptSelection>;
+/**
+ * `selection` is always present: the choice under the knob while pending, the
+ * confirmed choice when selected, and the last highlighted choice when the prompt
+ * was cancelled or timed out.
+ */
+declare const promptState: v.ObjectSchema<{
+  readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+  readonly status: v.PicklistSchema<["pending", "selected", "cancelled", "timed_out"], undefined>;
+  readonly selection: v.ObjectSchema<{
+    readonly label: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxBytesAction<string, 64, undefined>, v.RegexAction<string, "Choice labels must not be blank">, v.CheckAction<string, "Choice labels must not contain control characters">]>;
+    readonly index: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 31, undefined>]>;
+  }, undefined>;
+  readonly reason: v.OptionalSchema<v.PicklistSchema<["client_cancelled", "session_ended", "panel_exit", "display_replaced"], undefined>, undefined>;
+}, undefined>;
+type PromptState = v.InferOutput<typeof promptState>;
+type PromptStatus = PromptState['status'];
+/** @hideconstructor */
+declare class HmiApi {
+  private readonly fetch;
+  private readonly events;
+  constructor(fetch: UpFetch, events: EventsApi);
+  /**
+   * Resets the HMI.
+   */
+  reset(): Promise<void>;
+  /**
+   * Shows a single-choice prompt on the LCD and waits for the operator to answer.
+   *
+   * A choice may be a bare label string. `default_index` selects the initially
+   * highlighted choice and defaults to 0. Screen changes, resets, knob reads, and
+   * other prompts conflict while the prompt is pending.
+   *
+   * The wait rides the `hmi.prompt` event. Every event re-arms a
+   * `timeout_ms + 2000 ms` window, and a window that expires costs one read before
+   * the wait resumes: the device deadline stops as soon as the operator turns the
+   * knob, so a prompt somebody is answering is never abandoned locally.
+   *
+   * Cancellation and timeout are results. HTTP errors and local aborts reject the
+   * promise. On failure, cancellation is attempted without replacing the original
+   * error.
+   */
+  prompt(request: PromptRequestInput, options?: {
+    signal?: AbortSignal;
+  }): Promise<PromptState>;
+  private createPrompt;
+  private getPrompt;
+  private cancelPrompt;
+  /** Settles with `work`, or rejects as soon as `signal` aborts. */
+  private untilAborted;
+  /**
+   * Access the screen API.
+   * @returns The screen instance.
+   */
+  screen(): Screen;
+  /**
+   * Access the audio API.
+   * @returns The audio instance.
+   */
+  audio(): Audio;
+  /**
+   * Access the knob API.
+   * @returns The knob instance.
+   */
+  knob(): Knob;
+}
+/** @hideconstructor */
+declare class Screen {
+  private readonly fetch;
+  constructor(fetch: UpFetch);
+  /**
+   * Prints text to the screen.
+   * @param data The text to print.
+   * @returns The printed text.
+   */
+  print(data: ScreenText): Promise<string>;
+  /**
+   * Sets the screen colors.
+   * @param colors The colors to set.
+   * @returns The updated colors.
+   */
+  colors(colors: Color): Promise<Color>;
+  /**
+   * Sets the screen progress.
+   * @param data The progress value to set.
+   * @returns The updated progress.
+   */
+  progress(data: ProgressValue): Promise<Progress>;
+  /**
+   * Clears the screen.
+   */
+  clear(): Promise<void>;
+  /**
+   * Clears the text on the screen.
+   */
+  clear_text(): Promise<void>;
+}
+/** @hideconstructor */
+declare class Audio {
+  private readonly fetch;
+  constructor(fetch: UpFetch);
+  /**
+   * Plays a sound.
+   * @param config The configuration (sound_id, volume).
+   * @returns The play configuration.
+   */
+  play(config: PlaybackConfiguration): Promise<PlaybackConfiguration>;
+}
+/** @hideconstructor */
+declare class Knob {
+  private readonly fetch;
+  constructor(fetch: UpFetch);
+  read_event: () => Promise<{
+    button_pressed: boolean;
+    button_held: boolean;
+    rotation_delta: number;
+  }>;
+  is_button_held: () => Promise<boolean>;
+  is_knob_turned: () => Promise<boolean>;
+  /**
+   * Waits for a knob event and returns it.
+   * @param timeout_ms The timeout in milliseconds.
+   * @returns The knob event or null if the timeout was reached.
+   */
+  wait_event(timeout_ms?: number): Promise<KnobEvent | null>;
+}
+//#endregion
+export { text as S, color as _, KnobEvent as a, progress as b, ProgressValue as c, PromptRequestInput as d, PromptSelection as f, ScreenText as g, Screen as h, Knob as i, PromptChoice as l, PromptStatus as m, Color as n, PlaybackConfiguration as o, PromptState as p, HmiApi as r, Progress as s, Audio as t, PromptRequest as u, internalKnobEvent as v, promptState as x, playbackConfiguration as y };
+//# sourceMappingURL=hmi-Chid1Vvo.d.mts.map

package/build/hmi-Chid1Vvo.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hmi-Chid1Vvo.d.mts","names":[],"sources":["../src/api/hmi.ts"],"mappings":";;;;cAKM,YAAU,EAAA,yBAAA,EAAA,yBAAA,EAAA;KACJ,aAAa,EAAE,mBAAmB;cAEjC,MAAI,EAAA;;;cAIJ,OAAK,EAAA;;;;;KAKN,QAAQ,EAAE,mBAAmB;cAEnC,eAAa,EAAA,yBAAA,EAAA,yBAAA,EAAA,sCAAA,EAAA;KACP,gBAAgB,EAAE,mBAAmB;cACpC,UAAQ,EAAA;;;KACT,WAAW,EAAE,mBAAmB;cAE/B,uBAAqB,EAAA;;;;KAOtB,wBAAwB,EAAE,mBAAmB;cAE5C,mBAAiB,EAAA;;;;;cAKxB,WAAS,KAAA,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KACH,YAAY,EAAE,mBAAmB;cASvC,cAAY,EAAA;;;;KACN,eAAe,EAAE,mBAAmB;cAS1C,eAAa,EAAA,yBAAA,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAsBP,gBAAgB,EAAE,mBAAmB;;KAErC,qBAAqB,EAAE,kBAAkB;cAE/C,iBAAe,EAAA;;;;KACT,kBAAkB,EAAE,mBAAmB;;;;;;cAOtC,aAAW,EAAA;;;;;;;;;KAQZ,cAAc,EAAE,mBAAmB;KACnC,eAAe;;cAQd;mBACkB;mBAAiC;EAA9D,YAA6B,OAAO,SAA0B,QAAQ;;;;EAKtE,SAAS;;;;;;;;;;;;;;;;;EAoBH,OACJ,SAAS,oBACT;IAAY,SAAS;MACpB,QAAQ;UAoEH;UAQA;UAIA;;UAQM;;;;;EAkBd,UAAU;;;;;EAQV,SAAS;;;;;EAQT,QAAQ;;;cAMG;mBACkB;EAA7B,YAA6B,OAAO;;;;;;EAO9B,MAAM,MAAM,aAAa;;;;;;EAc/B,OAAO,QAAQ,QAAQ,QAAQ;;;;;;EAazB,SAAS,MAAM,gBAAgB,QAAQ;;;;EAkB7C,SAAS;;;;EAOT,cAAc;;;cAMH;mBACkB;EAA7B,YAA6B,OAAO;;;;;;EAO9B,KAAK,QAAQ,wBAAwB,QAAQ;;;cAUxC;mBACkB;EAA7B,YAA6B,OAAO;EAEpC,kBAAU;;;;;EAEV,sBAAc;EACd,sBAAc;;;;;;EAOR,WAAW,sBAAsB,QAAQ"}

package/build/hmi-OyVDyqU-.d.cts

@@ -0,0 +1,236 @@
+import { i as EventsApi } from "./events-BVDWI2tr.cjs";
+import { UpFetch } from "up-fetch";
+import * as v from "valibot";
+//#region src/api/hmi.d.ts
+declare const screenText: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 1024, undefined>]>;
+type ScreenText = v.InferOutput<typeof screenText>;
+declare const text: v.ObjectSchema<{
+  readonly text: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 1024, undefined>]>;
+}, undefined>;
+declare const color: v.ObjectSchema<{
+  readonly text: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.LengthAction<string, 7, undefined>, v.HexColorAction<string, undefined>]>, undefined>;
+  readonly progress: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.LengthAction<string, 7, undefined>, v.HexColorAction<string, undefined>]>, undefined>;
+  readonly background: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.LengthAction<string, 7, undefined>, v.HexColorAction<string, undefined>]>, undefined>;
+}, undefined>;
+type Color = v.InferOutput<typeof color>;
+declare const progressValue: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 100, undefined>]>;
+type ProgressValue = v.InferOutput<typeof progressValue>;
+declare const progress: v.ObjectSchema<{
+  readonly progress: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 100, undefined>]>;
+}, undefined>;
+type Progress = v.InferOutput<typeof progress>;
+declare const playbackConfiguration: v.ObjectSchema<{
+  readonly sound_id: v.PicklistSchema<["success", "warning", "failure", "notification_1", "notification_2", "imperial_march"], undefined>;
+  readonly volume: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 100, undefined>]>;
+}, undefined>;
+type PlaybackConfiguration = v.InferOutput<typeof playbackConfiguration>;
+declare const internalKnobEvent: v.ObjectSchema<{
+  readonly button_pressed: v.BooleanSchema<undefined>;
+  readonly button_held: v.BooleanSchema<undefined>;
+  readonly rotation_delta: v.NumberSchema<undefined>;
+}, undefined>;
+declare const knobEvent: Omit<v.ObjectSchema<{
+  readonly button_pressed: v.BooleanSchema<undefined>;
+  readonly button_held: v.BooleanSchema<undefined>;
+  readonly rotation_delta: v.NumberSchema<undefined>;
+}, undefined>, "entries" | "~run" | "~standard" | "~types"> & {
+  readonly entries: Omit<{
+    readonly button_pressed: v.BooleanSchema<undefined>;
+    readonly button_held: v.BooleanSchema<undefined>;
+    readonly rotation_delta: v.NumberSchema<undefined>;
+  }, "button_held">;
+  readonly "~standard": v.StandardProps<{
+    button_pressed: boolean;
+    rotation_delta: number;
+  }, {
+    button_pressed: boolean;
+    rotation_delta: number;
+  }>;
+  readonly "~run": (dataset: v.UnknownDataset, config: v.Config<v.BaseIssue<unknown>>) => v.OutputDataset<{
+    button_pressed: boolean;
+    rotation_delta: number;
+  }, v.BooleanIssue | v.NumberIssue | v.ObjectIssue>;
+  readonly "~types"?: {
+    readonly input: {
+      button_pressed: boolean;
+      rotation_delta: number;
+    };
+    readonly output: {
+      button_pressed: boolean;
+      rotation_delta: number;
+    };
+    readonly issue: v.BooleanIssue | v.NumberIssue | v.ObjectIssue;
+  } | undefined;
+};
+type KnobEvent = v.InferOutput<typeof knobEvent>;
+declare const promptChoice: v.ObjectSchema<{
+  readonly label: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxBytesAction<string, 64, undefined>, v.RegexAction<string, "Choice labels must not be blank">, v.CheckAction<string, "Choice labels must not contain control characters">]>;
+  readonly color: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.LengthAction<string, 7, undefined>, v.HexColorAction<string, undefined>]>, undefined>;
+}, undefined>;
+type PromptChoice = v.InferOutput<typeof promptChoice>;
+declare const promptRequest: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+  readonly text: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxBytesAction<string, 256, undefined>, v.RegexAction<string, "Prompt text must not be blank">, v.CheckAction<string, "Prompt text permits line feeds but no other control characters">]>;
+  readonly choices: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.UnionSchema<[v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxBytesAction<string, 64, undefined>, v.RegexAction<string, "Choice labels must not be blank">, v.CheckAction<string, "Choice labels must not contain control characters">]>, v.ObjectSchema<{
+    readonly label: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxBytesAction<string, 64, undefined>, v.RegexAction<string, "Choice labels must not be blank">, v.CheckAction<string, "Choice labels must not contain control characters">]>;
+    readonly color: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.LengthAction<string, 7, undefined>, v.HexColorAction<string, undefined>]>, undefined>;
+  }, undefined>], undefined>, v.TransformAction<string | {
+    label: string;
+    color?: string | undefined;
+  }, {
+    label: string;
+    color?: string | undefined;
+  }>]>, undefined>, v.MinLengthAction<{
+    label: string;
+    color?: string | undefined;
+  }[], 1, undefined>, v.MaxLengthAction<{
+    label: string;
+    color?: string | undefined;
+  }[], 32, undefined>]>;
+  readonly default_index: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 31, undefined>]>, undefined>;
+  readonly timeout_ms: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1000, undefined>, v.MaxValueAction<number, 1800000, undefined>]>, undefined>;
+}, undefined>, v.CheckAction<{
+  text: string;
+  choices: {
+    label: string;
+    color?: string | undefined;
+  }[];
+  default_index?: number | undefined;
+  timeout_ms?: number | undefined;
+}, "default_index must be below the number of choices">]>;
+/** Wire shape, where every choice is an object. */
+type PromptRequest = v.InferOutput<typeof promptRequest>;
+/** Accepted shape, where a choice may be a bare label string. */
+type PromptRequestInput = v.InferInput<typeof promptRequest>;
+declare const promptSelection: v.ObjectSchema<{
+  readonly label: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxBytesAction<string, 64, undefined>, v.RegexAction<string, "Choice labels must not be blank">, v.CheckAction<string, "Choice labels must not contain control characters">]>;
+  readonly index: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 31, undefined>]>;
+}, undefined>;
+type PromptSelection = v.InferOutput<typeof promptSelection>;
+/**
+ * `selection` is always present: the choice under the knob while pending, the
+ * confirmed choice when selected, and the last highlighted choice when the prompt
+ * was cancelled or timed out.
+ */
+declare const promptState: v.ObjectSchema<{
+  readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+  readonly status: v.PicklistSchema<["pending", "selected", "cancelled", "timed_out"], undefined>;
+  readonly selection: v.ObjectSchema<{
+    readonly label: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxBytesAction<string, 64, undefined>, v.RegexAction<string, "Choice labels must not be blank">, v.CheckAction<string, "Choice labels must not contain control characters">]>;
+    readonly index: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 31, undefined>]>;
+  }, undefined>;
+  readonly reason: v.OptionalSchema<v.PicklistSchema<["client_cancelled", "session_ended", "panel_exit", "display_replaced"], undefined>, undefined>;
+}, undefined>;
+type PromptState = v.InferOutput<typeof promptState>;
+type PromptStatus = PromptState['status'];
+/** @hideconstructor */
+declare class HmiApi {
+  private readonly fetch;
+  private readonly events;
+  constructor(fetch: UpFetch, events: EventsApi);
+  /**
+   * Resets the HMI.
+   */
+  reset(): Promise<void>;
+  /**
+   * Shows a single-choice prompt on the LCD and waits for the operator to answer.
+   *
+   * A choice may be a bare label string. `default_index` selects the initially
+   * highlighted choice and defaults to 0. Screen changes, resets, knob reads, and
+   * other prompts conflict while the prompt is pending.
+   *
+   * The wait rides the `hmi.prompt` event. Every event re-arms a
+   * `timeout_ms + 2000 ms` window, and a window that expires costs one read before
+   * the wait resumes: the device deadline stops as soon as the operator turns the
+   * knob, so a prompt somebody is answering is never abandoned locally.
+   *
+   * Cancellation and timeout are results. HTTP errors and local aborts reject the
+   * promise. On failure, cancellation is attempted without replacing the original
+   * error.
+   */
+  prompt(request: PromptRequestInput, options?: {
+    signal?: AbortSignal;
+  }): Promise<PromptState>;
+  private createPrompt;
+  private getPrompt;
+  private cancelPrompt;
+  /** Settles with `work`, or rejects as soon as `signal` aborts. */
+  private untilAborted;
+  /**
+   * Access the screen API.
+   * @returns The screen instance.
+   */
+  screen(): Screen;
+  /**
+   * Access the audio API.
+   * @returns The audio instance.
+   */
+  audio(): Audio;
+  /**
+   * Access the knob API.
+   * @returns The knob instance.
+   */
+  knob(): Knob;
+}
+/** @hideconstructor */
+declare class Screen {
+  private readonly fetch;
+  constructor(fetch: UpFetch);
+  /**
+   * Prints text to the screen.
+   * @param data The text to print.
+   * @returns The printed text.
+   */
+  print(data: ScreenText): Promise<string>;
+  /**
+   * Sets the screen colors.
+   * @param colors The colors to set.
+   * @returns The updated colors.
+   */
+  colors(colors: Color): Promise<Color>;
+  /**
+   * Sets the screen progress.
+   * @param data The progress value to set.
+   * @returns The updated progress.
+   */
+  progress(data: ProgressValue): Promise<Progress>;
+  /**
+   * Clears the screen.
+   */
+  clear(): Promise<void>;
+  /**
+   * Clears the text on the screen.
+   */
+  clear_text(): Promise<void>;
+}
+/** @hideconstructor */
+declare class Audio {
+  private readonly fetch;
+  constructor(fetch: UpFetch);
+  /**
+   * Plays a sound.
+   * @param config The configuration (sound_id, volume).
+   * @returns The play configuration.
+   */
+  play(config: PlaybackConfiguration): Promise<PlaybackConfiguration>;
+}
+/** @hideconstructor */
+declare class Knob {
+  private readonly fetch;
+  constructor(fetch: UpFetch);
+  read_event: () => Promise<{
+    button_pressed: boolean;
+    button_held: boolean;
+    rotation_delta: number;
+  }>;
+  is_button_held: () => Promise<boolean>;
+  is_knob_turned: () => Promise<boolean>;
+  /**
+   * Waits for a knob event and returns it.
+   * @param timeout_ms The timeout in milliseconds.
+   * @returns The knob event or null if the timeout was reached.
+   */
+  wait_event(timeout_ms?: number): Promise<KnobEvent | null>;
+}
+//#endregion
+export { text as S, color as _, KnobEvent as a, progress as b, ProgressValue as c, PromptRequestInput as d, PromptSelection as f, ScreenText as g, Screen as h, Knob as i, PromptChoice as l, PromptStatus as m, Color as n, PlaybackConfiguration as o, PromptState as p, HmiApi as r, Progress as s, Audio as t, PromptRequest as u, internalKnobEvent as v, promptState as x, playbackConfiguration as y };
+//# sourceMappingURL=hmi-OyVDyqU-.d.cts.map

package/build/hmi-OyVDyqU-.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hmi-OyVDyqU-.d.cts","names":[],"sources":["../src/api/hmi.ts"],"mappings":";;;;cAKM,YAAU,EAAA,yBAAA,EAAA,yBAAA,EAAA;KACJ,aAAa,EAAE,mBAAmB;cAEjC,MAAI,EAAA;;;cAIJ,OAAK,EAAA;;;;;KAKN,QAAQ,EAAE,mBAAmB;cAEnC,eAAa,EAAA,yBAAA,EAAA,yBAAA,EAAA,sCAAA,EAAA;KACP,gBAAgB,EAAE,mBAAmB;cACpC,UAAQ,EAAA;;;KACT,WAAW,EAAE,mBAAmB;cAE/B,uBAAqB,EAAA;;;;KAOtB,wBAAwB,EAAE,mBAAmB;cAE5C,mBAAiB,EAAA;;;;;cAKxB,WAAS,KAAA,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KACH,YAAY,EAAE,mBAAmB;cASvC,cAAY,EAAA;;;;KACN,eAAe,EAAE,mBAAmB;cAS1C,eAAa,EAAA,yBAAA,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAsBP,gBAAgB,EAAE,mBAAmB;;KAErC,qBAAqB,EAAE,kBAAkB;cAE/C,iBAAe,EAAA;;;;KACT,kBAAkB,EAAE,mBAAmB;;;;;;cAOtC,aAAW,EAAA;;;;;;;;;KAQZ,cAAc,EAAE,mBAAmB;KACnC,eAAe;;cAQd;mBACkB;mBAAiC;EAA9D,YAA6B,OAAO,SAA0B,QAAQ;;;;EAKtE,SAAS;;;;;;;;;;;;;;;;;EAoBH,OACJ,SAAS,oBACT;IAAY,SAAS;MACpB,QAAQ;UAoEH;UAQA;UAIA;;UAQM;;;;;EAkBd,UAAU;;;;;EAQV,SAAS;;;;;EAQT,QAAQ;;;cAMG;mBACkB;EAA7B,YAA6B,OAAO;;;;;;EAO9B,MAAM,MAAM,aAAa;;;;;;EAc/B,OAAO,QAAQ,QAAQ,QAAQ;;;;;;EAazB,SAAS,MAAM,gBAAgB,QAAQ;;;;EAkB7C,SAAS;;;;EAOT,cAAc;;;cAMH;mBACkB;EAA7B,YAA6B,OAAO;;;;;;EAO9B,KAAK,QAAQ,wBAAwB,QAAQ;;;cAUxC;mBACkB;EAA7B,YAA6B,OAAO;EAEpC,kBAAU;;;;;EAEV,sBAAc;EACd,sBAAc;;;;;;EAOR,WAAW,sBAAsB,QAAQ"}

package/build/hmi.cjs

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./rolldown-runtime-BocRIvOZ.cjs");let t=require("valibot");t=e.t(t,1);const n=t.pipe(t.string(),t.maxLength(1024)),r=t.object({text:n}),i=t.optional(t.pipe(t.string(),t.length(7),t.hexColor())),a=t.object({text:i,progress:i,background:i}),o=t.pipe(t.number(),t.minValue(0),t.maxValue(100)),s=t.object({progress:o}),c=t.object({sound_id:t.picklist([`success`,`warning`,`failure`,`notification_1`,`notification_2`,`imperial_march`]),volume:t.pipe(t.number(),t.minValue(0),t.maxValue(100))}),l=t.object({button_pressed:t.boolean(),button_held:t.boolean(),rotation_delta:t.number()});t.omit(l,[`button_held`]);var u=class{fetch;constructor(e){this.fetch=e}reset(){return this.fetch(`/hmi/reset`,{method:`POST`,parseResponse:()=>{}})}screen(){return new d(this.fetch)}audio(){return new f(this.fetch)}knob(){return new p(this.fetch)}},d=class{fetch;constructor(e){this.fetch=e}async print(e){return(await this.fetch(`/hmi/screen/text`,{method:`POST`,body:t.parse(r,{text:e}),schema:r})).text}colors(e){return this.fetch(`/hmi/screen/colors`,{method:`PATCH`,body:t.parse(a,e),schema:a})}async progress(e){return e==0?await this.fetch(`/hmi/screen/progress`,{method:`DELETE`,parseResponse:()=>({progress:0})}):this.fetch(`/hmi/screen/progress`,{method:`PUT`,body:t.parse(s,{progress:e}),schema:s})}clear(){return this.fetch(`/hmi/screen/clear`,{method:`POST`,parseResponse:()=>{}})}clear_text(){return this.fetch(`/hmi/screen/text`,{method:`DELETE`,parseResponse:()=>{}})}},f=class{fetch;constructor(e){this.fetch=e}async play(e){return this.fetch(`/hmi/speaker/play`,{method:`POST`,body:t.parse(c,e),schema:c})}},p=class{fetch;constructor(e){this.fetch=e}read_event=()=>this.fetch(`/hmi/knob/get_knob_event`,{schema:l});is_button_held=async()=>(await this.read_event()).button_held;is_knob_turned=async()=>Math.abs((await this.read_event()).rotation_delta)>=4;async wait_event(e){await this.read_event();let t=0,n=Math.min(50,(e??500)/10),r=Date.now();for(;e===void 0||Date.now()-r<e;){let e=await this.read_event();if(t+=e.rotation_delta,e.button_pressed||Math.abs(t)>=4)return{button_pressed:e.button_pressed,rotation_delta:Math.sign(t)};await new Promise(e=>setTimeout(e,n))}return null}};exports.Audio=f,exports.HmiApi=u,exports.Knob=p,exports.Screen=d,exports.color=a,exports.internalKnobEvent=l,exports.playbackConfiguration=c,exports.progress=s,exports.text=r;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./rolldown-runtime-BocRIvOZ.cjs");let t=require("valibot");t=e.t(t,1);const n=t.pipe(t.string(),t.maxLength(1024)),r=t.object({text:n}),i=t.optional(t.pipe(t.string(),t.length(7),t.hexColor())),a=t.object({text:i,progress:i,background:i}),o=t.pipe(t.number(),t.minValue(0),t.maxValue(100)),s=t.object({progress:o}),c=t.object({sound_id:t.picklist([`success`,`warning`,`failure`,`notification_1`,`notification_2`,`imperial_march`]),volume:t.pipe(t.number(),t.minValue(0),t.maxValue(100))}),l=t.object({button_pressed:t.boolean(),button_held:t.boolean(),rotation_delta:t.number()});t.omit(l,[`button_held`]);const u=t.pipe(t.string(),t.maxBytes(64),t.regex(/\S/u,`Choice labels must not be blank`),t.check(e=>!/\p{Cc}/u.test(e),`Choice labels must not contain control characters`)),d=t.pipe(t.number(),t.integer(),t.minValue(0),t.maxValue(31)),f=t.object({label:u,color:i}),p=t.pipe(t.union([u,f]),t.transform(e=>typeof e==`string`?{label:e}:e)),m=t.pipe(t.object({text:t.pipe(t.string(),t.maxBytes(256),t.regex(/\S/u,`Prompt text must not be blank`),t.check(e=>!/[^\P{Cc}\n]/u.test(e),`Prompt text permits line feeds but no other control characters`)),choices:t.pipe(t.array(p),t.minLength(1),t.maxLength(32)),default_index:t.optional(d),timeout_ms:t.optional(t.pipe(t.number(),t.integer(),t.minValue(1e3),t.maxValue(18e5)))}),t.check(e=>e.default_index===void 0||e.default_index<e.choices.length,`default_index must be below the number of choices`)),h=t.object({label:u,index:d}),g=t.object({id:t.pipe(t.string(),t.minLength(1)),status:t.picklist([`pending`,`selected`,`cancelled`,`timed_out`]),selection:h,reason:t.optional(t.picklist([`client_cancelled`,`session_ended`,`panel_exit`,`display_replaced`]))});var _=class{fetch;events;constructor(e,t){this.fetch=e,this.events=t}reset(){return this.fetch(`/hmi/reset`,{method:`POST`,parseResponse:()=>{}})}async prompt(e,t){let n=t?.signal;n?.throwIfAborted();let r=(e.timeout_ms??6e4)+2e3,i,a,o=!1;try{let t=await this.createPrompt(e);i=t.id,n?.throwIfAborted();let s=[],c;a=this.events.on(`hmi.prompt`,e=>{e.data.id===t.id&&(s.push(e.data),c?.())}),o=!this.events.connected,await this.events.connect();let l=async()=>{if(s.length===0){let{promise:e,resolve:t}=Promise.withResolvers(),i=setTimeout(t,r);c=t;try{await this.untilAborted(e,n)}finally{clearTimeout(i),c=void 0}}return s.shift()},u=await this.untilAborted(this.getPrompt(t.id),n);for(;u.status===`pending`;)u=await l()??await this.untilAborted(this.getPrompt(t.id),n);return u}catch(e){if(i!==void 0)try{await this.cancelPrompt(i)}catch{}throw e}finally{a?.(),o&&this.events.close()}}createPrompt(e){return this.fetch(`/hmi/prompts`,{method:`POST`,body:t.parse(m,e),schema:g})}getPrompt(e){return this.fetch(`/hmi/prompts/${encodeURIComponent(e)}`,{schema:g})}cancelPrompt(e){return this.fetch(`/hmi/prompts/${encodeURIComponent(e)}`,{method:`DELETE`,schema:g})}async untilAborted(e,t){if(!t)return await e;let n;try{let r=new Promise((e,r)=>{n=()=>r(t.reason),t.addEventListener(`abort`,n,{once:!0})});return await Promise.race([e,r])}finally{n&&t.removeEventListener(`abort`,n)}}screen(){return new v(this.fetch)}audio(){return new y(this.fetch)}knob(){return new b(this.fetch)}},v=class{fetch;constructor(e){this.fetch=e}async print(e){return(await this.fetch(`/hmi/screen/text`,{method:`POST`,body:t.parse(r,{text:e}),schema:r})).text}colors(e){return this.fetch(`/hmi/screen/colors`,{method:`PATCH`,body:t.parse(a,e),schema:a})}async progress(e){return e==0?await this.fetch(`/hmi/screen/progress`,{method:`DELETE`,parseResponse:()=>({progress:0})}):this.fetch(`/hmi/screen/progress`,{method:`PUT`,body:t.parse(s,{progress:e}),schema:s})}clear(){return this.fetch(`/hmi/screen/clear`,{method:`POST`,parseResponse:()=>{}})}clear_text(){return this.fetch(`/hmi/screen/text`,{method:`DELETE`,parseResponse:()=>{}})}},y=class{fetch;constructor(e){this.fetch=e}async play(e){return this.fetch(`/hmi/speaker/play`,{method:`POST`,body:t.parse(c,e),schema:c})}},b=class{fetch;constructor(e){this.fetch=e}read_event=()=>this.fetch(`/hmi/knob/get_knob_event`,{schema:l});is_button_held=async()=>(await this.read_event()).button_held;is_knob_turned=async()=>Math.abs((await this.read_event()).rotation_delta)>=4;async wait_event(e){await this.read_event();let t=0,n=Math.min(50,(e??500)/10),r=Date.now();for(;e===void 0||Date.now()-r<e;){let e=await this.read_event();if(t+=e.rotation_delta,e.button_pressed||Math.abs(t)>=4)return{button_pressed:e.button_pressed,rotation_delta:Math.sign(t)};await new Promise(e=>setTimeout(e,n))}return null}};exports.Audio=y,exports.HmiApi=_,exports.Knob=b,exports.Screen=v,exports.color=a,exports.internalKnobEvent=l,exports.playbackConfiguration=c,exports.progress=s,exports.promptState=g,exports.text=r;
 //# sourceMappingURL=hmi.cjs.map

package/build/hmi.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"hmi.cjs","names":["v"],"sources":["../src/api/hmi.ts"],"sourcesContent":["import type { UpFetch } from 'up-fetch';\nimport * as v from 'valibot';\n\nconst screenText = v.pipe(v.string(), v.maxLength(1024));\nexport type ScreenText = v.InferOutput<typeof screenText>;\n\nexport const text = v.object({ text: screenText });\ntype Text = v.InferOutput<typeof text>;\n\nconst optionalHexColor = v.optional(v.pipe(v.string(), v.length(7), v.hexColor()));\nexport const color = v.object({\n  text: optionalHexColor,\n  progress: optionalHexColor,\n  background: optionalHexColor,\n});\nexport type Color = v.InferOutput<typeof color>;\n\nconst progressValue = v.pipe(v.number(), v.minValue(0), v.maxValue(100));\nexport type ProgressValue = v.InferOutput<typeof progressValue>;\nexport const progress = v.object({ progress: progressValue });\nexport type Progress = v.InferOutput<typeof progress>;\n\nexport const playbackConfiguration = v.object({\n  sound_id: v.picklist(\n    ['success', 'warning', 'failure', 'notification_1', 'notification_2',\n      'imperial_march'] as const,\n  ),\n  volume: v.pipe(v.number(), v.minValue(0), v.maxValue(100)),\n});\nexport type PlaybackConfiguration = v.InferOutput<typeof playbackConfiguration>;\n\nexport const internalKnobEvent = v.object({\n  button_pressed: v.boolean(),\n  button_held: v.boolean(),\n  rotation_delta: v.number(),\n});\nconst knobEvent = v.omit(internalKnobEvent, ['button_held']);\nexport type KnobEvent = v.InferOutput<typeof knobEvent>;\n\n/** @hideconstructor */\nexport class HmiApi {\n  constructor(private readonly fetch: UpFetch) {}\n\n  /**\n   * Resets the HMI.\n   */\n  reset(): Promise<void> {\n    return this.fetch('/hmi/reset', { method: 'POST', parseResponse: () => {} });\n  }\n\n  /**\n   * Access the screen API.\n   * @returns The screen instance.\n   */\n  screen(): Screen {\n    return new Screen(this.fetch);\n  }\n\n  /**\n   * Access the audio API.\n   * @returns The audio instance.\n   */\n  audio(): Audio {\n    return new Audio(this.fetch);\n  }\n\n  /**\n   * Access the knob API.\n   * @returns The knob instance.\n   */\n  knob(): Knob {\n    return new Knob(this.fetch);\n  }\n}\n\n/** @hideconstructor */\nexport class Screen {\n  constructor(private readonly fetch: UpFetch) {}\n\n  /**\n   * Prints text to the screen.\n   * @param data The text to print.\n   * @returns The printed text.\n   */\n  async print(data: ScreenText): Promise<string> {\n    return (await this.fetch('/hmi/screen/text', {\n      method: 'POST',\n      body: v.parse(text, { text: data } satisfies Text),\n      schema: text,\n    }))\n      .text;\n  }\n\n  /**\n   * Sets the screen colors.\n   * @param colors The colors to set.\n   * @returns The updated colors.\n   */\n  colors(colors: Color): Promise<Color> {\n    return this.fetch('/hmi/screen/colors', {\n      method: 'PATCH',\n      body: v.parse(color, colors satisfies Color),\n      schema: color,\n    });\n  }\n\n  /**\n   * Sets the screen progress.\n   * @param data The progress value to set.\n   * @returns The updated progress.\n   */\n  async progress(data: ProgressValue): Promise<Progress> {\n    if (data == 0) {\n      return await this.fetch('/hmi/screen/progress', {\n        method: 'DELETE',\n        parseResponse: () => ({ progress: 0 }),\n      });\n    }\n\n    return this.fetch('/hmi/screen/progress', {\n      method: 'PUT',\n      body: v.parse(progress, { progress: data } satisfies Progress),\n      schema: progress,\n    });\n  }\n\n  /**\n   * Clears the screen.\n   */\n  clear(): Promise<void> {\n    return this.fetch('/hmi/screen/clear', { method: 'POST', parseResponse: () => {} });\n  }\n\n  /**\n   * Clears the text on the screen.\n   */\n  clear_text(): Promise<void> {\n    return this.fetch('/hmi/screen/text', { method: 'DELETE', parseResponse: () => {} });\n  }\n}\n\n/** @hideconstructor */\nexport class Audio {\n  constructor(private readonly fetch: UpFetch) {}\n\n  /**\n   * Plays a sound.\n   * @param config The configuration (sound_id, volume).\n   * @returns The play configuration.\n   */\n  async play(config: PlaybackConfiguration): Promise<PlaybackConfiguration> {\n    return this.fetch('/hmi/speaker/play', {\n      method: 'POST',\n      body: v.parse(playbackConfiguration, config),\n      schema: playbackConfiguration,\n    });\n  }\n}\n\n/** @hideconstructor */\nexport class Knob {\n  constructor(private readonly fetch: UpFetch) {}\n\n  read_event = () => this.fetch('/hmi/knob/get_knob_event', { schema: internalKnobEvent });\n\n  is_button_held = async () => (await this.read_event()).button_held;\n  is_knob_turned = async () => Math.abs((await this.read_event()).rotation_delta) >= 4;\n\n  /**\n   * Waits for a knob event and returns it.\n   * @param timeout_ms The timeout in milliseconds.\n   * @returns The knob event or null if the timeout was reached.\n   */\n  async wait_event(timeout_ms?: number): Promise<KnobEvent | null> {\n    await this.read_event(); // Discard any previous events\n    let delta = 0;\n\n    const interval = Math.min(50, (timeout_ms ?? 500) / 10);\n\n    const startTime = Date.now();\n    while (timeout_ms !== undefined ? Date.now() - startTime < timeout_ms : true) {\n      const knobEvent = await this.read_event();\n      delta += knobEvent.rotation_delta;\n\n      if (knobEvent.button_pressed || Math.abs(delta) >= 4) {\n        return { button_pressed: knobEvent.button_pressed, rotation_delta: Math.sign(delta) };\n      }\n      await new Promise((resolve) => setTimeout(resolve, interval));\n    }\n\n    return null;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"hmi.cjs","names":["v"],"sources":["../src/api/hmi.ts"],"sourcesContent":["import type { UpFetch } from 'up-fetch';\nimport * as v from 'valibot';\n\nimport type { EventsApi } from './events';\n\nconst screenText = v.pipe(v.string(), v.maxLength(1024));\nexport type ScreenText = v.InferOutput<typeof screenText>;\n\nexport const text = v.object({ text: screenText });\ntype Text = v.InferOutput<typeof text>;\n\nconst optionalHexColor = v.optional(v.pipe(v.string(), v.length(7), v.hexColor()));\nexport const color = v.object({\n  text: optionalHexColor,\n  progress: optionalHexColor,\n  background: optionalHexColor,\n});\nexport type Color = v.InferOutput<typeof color>;\n\nconst progressValue = v.pipe(v.number(), v.minValue(0), v.maxValue(100));\nexport type ProgressValue = v.InferOutput<typeof progressValue>;\nexport const progress = v.object({ progress: progressValue });\nexport type Progress = v.InferOutput<typeof progress>;\n\nexport const playbackConfiguration = v.object({\n  sound_id: v.picklist(\n    ['success', 'warning', 'failure', 'notification_1', 'notification_2',\n      'imperial_march'] as const,\n  ),\n  volume: v.pipe(v.number(), v.minValue(0), v.maxValue(100)),\n});\nexport type PlaybackConfiguration = v.InferOutput<typeof playbackConfiguration>;\n\nexport const internalKnobEvent = v.object({\n  button_pressed: v.boolean(),\n  button_held: v.boolean(),\n  rotation_delta: v.number(),\n});\nconst knobEvent = v.omit(internalKnobEvent, ['button_held']);\nexport type KnobEvent = v.InferOutput<typeof knobEvent>;\n\nconst promptLabel = v.pipe(\n  v.string(),\n  v.maxBytes(64),\n  v.regex(/\\S/u, 'Choice labels must not be blank'),\n  v.check((value) => !/\\p{Cc}/u.test(value), 'Choice labels must not contain control characters'),\n);\nconst promptIndex = v.pipe(v.number(), v.integer(), v.minValue(0), v.maxValue(31));\nconst promptChoice = v.object({ label: promptLabel, color: optionalHexColor });\nexport type PromptChoice = v.InferOutput<typeof promptChoice>;\n\n// A choice may be written as a bare label. Position identifies a choice, so two\n// choices may carry the same label.\nconst promptChoiceInput = v.pipe(\n  v.union([promptLabel, promptChoice]),\n  v.transform((choice): PromptChoice => (typeof choice === 'string' ? { label: choice } : choice)),\n);\n\nconst promptRequest = v.pipe(\n  v.object({\n    text: v.pipe(\n      v.string(),\n      v.maxBytes(256),\n      v.regex(/\\S/u, 'Prompt text must not be blank'),\n      v.check(\n        (value) => !/[^\\P{Cc}\\n]/u.test(value),\n        'Prompt text permits line feeds but no other control characters',\n      ),\n    ),\n    choices: v.pipe(v.array(promptChoiceInput), v.minLength(1), v.maxLength(32)),\n    default_index: v.optional(promptIndex),\n    timeout_ms: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1000), v.maxValue(1800000))),\n  }),\n  v.check(\n    (request) =>\n      request.default_index === undefined || request.default_index < request.choices.length,\n    'default_index must be below the number of choices',\n  ),\n);\n/** Wire shape, where every choice is an object. */\nexport type PromptRequest = v.InferOutput<typeof promptRequest>;\n/** Accepted shape, where a choice may be a bare label string. */\nexport type PromptRequestInput = v.InferInput<typeof promptRequest>;\n\nconst promptSelection = v.object({ label: promptLabel, index: promptIndex });\nexport type PromptSelection = v.InferOutput<typeof promptSelection>;\n\n/**\n * `selection` is always present: the choice under the knob while pending, the\n * confirmed choice when selected, and the last highlighted choice when the prompt\n * was cancelled or timed out.\n */\nexport const promptState = v.object({\n  id: v.pipe(v.string(), v.minLength(1)),\n  status: v.picklist(['pending', 'selected', 'cancelled', 'timed_out']),\n  selection: promptSelection,\n  reason: v.optional(\n    v.picklist(['client_cancelled', 'session_ended', 'panel_exit', 'display_replaced']),\n  ),\n});\nexport type PromptState = v.InferOutput<typeof promptState>;\nexport type PromptStatus = PromptState['status'];\n\n// The device deadline applied when `timeout_ms` is omitted, and the slack the local\n// event window adds on top of it.\nconst defaultPromptTimeoutMs = 60_000;\nconst promptEventGraceMs = 2_000;\n\n/** @hideconstructor */\nexport class HmiApi {\n  constructor(private readonly fetch: UpFetch, private readonly events: EventsApi) {}\n\n  /**\n   * Resets the HMI.\n   */\n  reset(): Promise<void> {\n    return this.fetch('/hmi/reset', { method: 'POST', parseResponse: () => {} });\n  }\n\n  /**\n   * Shows a single-choice prompt on the LCD and waits for the operator to answer.\n   *\n   * A choice may be a bare label string. `default_index` selects the initially\n   * highlighted choice and defaults to 0. Screen changes, resets, knob reads, and\n   * other prompts conflict while the prompt is pending.\n   *\n   * The wait rides the `hmi.prompt` event. Every event re-arms a\n   * `timeout_ms + 2000 ms` window, and a window that expires costs one read before\n   * the wait resumes: the device deadline stops as soon as the operator turns the\n   * knob, so a prompt somebody is answering is never abandoned locally.\n   *\n   * Cancellation and timeout are results. HTTP errors and local aborts reject the\n   * promise. On failure, cancellation is attempted without replacing the original\n   * error.\n   */\n  async prompt(\n    request: PromptRequestInput,\n    options?: { signal?: AbortSignal },\n  ): Promise<PromptState> {\n    const signal = options?.signal;\n    signal?.throwIfAborted();\n    const windowMs = (request.timeout_ms ?? defaultPromptTimeoutMs) + promptEventGraceMs;\n\n    let id: string | undefined;\n    let unsubscribe: (() => void) | undefined;\n    let openedEvents = false;\n    try {\n      // Do not abort creation: its response supplies the ID needed for cancellation.\n      const created = await this.createPrompt(request);\n      id = created.id;\n      signal?.throwIfAborted();\n\n      // Subscribing after creation cannot lose anything, because the read below\n      // covers the gap. That is cheaper than ordering the socket before the POST.\n      const inbox: PromptState[] = [];\n      let wake: (() => void) | undefined;\n      unsubscribe = this.events.on('hmi.prompt', (event) => {\n        if (event.data.id !== created.id) return;\n        inbox.push(event.data);\n        wake?.();\n      });\n      openedEvents = !this.events.connected;\n      await this.events.connect();\n\n      // Resolves the next state for this prompt, or undefined once the window expires.\n      // The inbox, not the resolution value, carries the events, so a second event\n      // arriving before the waiter resumes cannot be dropped.\n      const nextEvent = async (): Promise<PromptState | undefined> => {\n        if (inbox.length === 0) {\n          const { promise, resolve } = Promise.withResolvers<void>();\n          const timer = setTimeout(resolve, windowMs);\n          wake = resolve;\n          try {\n            await this.untilAborted(promise, signal);\n          } finally {\n            clearTimeout(timer);\n            wake = undefined;\n          }\n        }\n        return inbox.shift();\n      };\n\n      let state = await this.untilAborted(this.getPrompt(created.id), signal);\n      while (state.status === 'pending') {\n        // An empty window means a stalled or reconnecting socket, never a reason to\n        // cancel: read once, then wait again.\n        const delivered = await nextEvent();\n        state = delivered ?? await this.untilAborted(this.getPrompt(created.id), signal);\n      }\n      return state;\n    } catch (error) {\n      if (id !== undefined) {\n        try {\n          await this.cancelPrompt(id);\n        } catch {\n          // The server deadline still applies if cancellation cannot reach the device.\n        }\n      }\n      throw error;\n    } finally {\n      unsubscribe?.();\n      // A socket the application opened stays open; it may still be listening.\n      if (openedEvents) this.events.close();\n    }\n  }\n\n  private createPrompt(request: PromptRequestInput): Promise<PromptState> {\n    return this.fetch('/hmi/prompts', {\n      method: 'POST',\n      body: v.parse(promptRequest, request),\n      schema: promptState,\n    });\n  }\n\n  private getPrompt(id: string): Promise<PromptState> {\n    return this.fetch(`/hmi/prompts/${encodeURIComponent(id)}`, { schema: promptState });\n  }\n\n  private cancelPrompt(id: string): Promise<PromptState> {\n    return this.fetch(`/hmi/prompts/${encodeURIComponent(id)}`, {\n      method: 'DELETE',\n      schema: promptState,\n    });\n  }\n\n  /** Settles with `work`, or rejects as soon as `signal` aborts. */\n  private async untilAborted<T>(work: Promise<T>, signal?: AbortSignal): Promise<T> {\n    if (!signal) return await work;\n    let onAbort: (() => void) | undefined;\n    try {\n      const aborted = new Promise<never>((_, reject) => {\n        onAbort = () => reject(signal.reason);\n        signal.addEventListener('abort', onAbort, { once: true });\n      });\n      return await Promise.race([work, aborted]);\n    } finally {\n      if (onAbort) signal.removeEventListener('abort', onAbort);\n    }\n  }\n\n  /**\n   * Access the screen API.\n   * @returns The screen instance.\n   */\n  screen(): Screen {\n    return new Screen(this.fetch);\n  }\n\n  /**\n   * Access the audio API.\n   * @returns The audio instance.\n   */\n  audio(): Audio {\n    return new Audio(this.fetch);\n  }\n\n  /**\n   * Access the knob API.\n   * @returns The knob instance.\n   */\n  knob(): Knob {\n    return new Knob(this.fetch);\n  }\n}\n\n/** @hideconstructor */\nexport class Screen {\n  constructor(private readonly fetch: UpFetch) {}\n\n  /**\n   * Prints text to the screen.\n   * @param data The text to print.\n   * @returns The printed text.\n   */\n  async print(data: ScreenText): Promise<string> {\n    return (await this.fetch('/hmi/screen/text', {\n      method: 'POST',\n      body: v.parse(text, { text: data } satisfies Text),\n      schema: text,\n    }))\n      .text;\n  }\n\n  /**\n   * Sets the screen colors.\n   * @param colors The colors to set.\n   * @returns The updated colors.\n   */\n  colors(colors: Color): Promise<Color> {\n    return this.fetch('/hmi/screen/colors', {\n      method: 'PATCH',\n      body: v.parse(color, colors satisfies Color),\n      schema: color,\n    });\n  }\n\n  /**\n   * Sets the screen progress.\n   * @param data The progress value to set.\n   * @returns The updated progress.\n   */\n  async progress(data: ProgressValue): Promise<Progress> {\n    if (data == 0) {\n      return await this.fetch('/hmi/screen/progress', {\n        method: 'DELETE',\n        parseResponse: () => ({ progress: 0 }),\n      });\n    }\n\n    return this.fetch('/hmi/screen/progress', {\n      method: 'PUT',\n      body: v.parse(progress, { progress: data } satisfies Progress),\n      schema: progress,\n    });\n  }\n\n  /**\n   * Clears the screen.\n   */\n  clear(): Promise<void> {\n    return this.fetch('/hmi/screen/clear', { method: 'POST', parseResponse: () => {} });\n  }\n\n  /**\n   * Clears the text on the screen.\n   */\n  clear_text(): Promise<void> {\n    return this.fetch('/hmi/screen/text', { method: 'DELETE', parseResponse: () => {} });\n  }\n}\n\n/** @hideconstructor */\nexport class Audio {\n  constructor(private readonly fetch: UpFetch) {}\n\n  /**\n   * Plays a sound.\n   * @param config The configuration (sound_id, volume).\n   * @returns The play configuration.\n   */\n  async play(config: PlaybackConfiguration): Promise<PlaybackConfiguration> {\n    return this.fetch('/hmi/speaker/play', {\n      method: 'POST',\n      body: v.parse(playbackConfiguration, config),\n      schema: playbackConfiguration,\n    });\n  }\n}\n\n/** @hideconstructor */\nexport class Knob {\n  constructor(private readonly fetch: UpFetch) {}\n\n  read_event = () => this.fetch('/hmi/knob/get_knob_event', { schema: internalKnobEvent });\n\n  is_button_held = async () => (await this.read_event()).button_held;\n  is_knob_turned = async () => Math.abs((await this.read_event()).rotation_delta) >= 4;\n\n  /**\n   * Waits for a knob event and returns it.\n   * @param timeout_ms The timeout in milliseconds.\n   * @returns The knob event or null if the timeout was reached.\n   */\n  async wait_event(timeout_ms?: number): Promise<KnobEvent | null> {\n    await this.read_event(); // Discard any previous events\n    let delta = 0;\n\n    const interval = Math.min(50, (timeout_ms ?? 500) / 10);\n\n    const startTime = Date.now();\n    while (timeout_ms !== undefined ? Date.now() - startTime < timeout_ms : true) {\n      const knobEvent = await this.read_event();\n      delta += knobEvent.rotation_delta;\n\n      if (knobEvent.button_pressed || Math.abs(delta) >= 4) {\n        return { button_pressed: knobEvent.button_pressed, rotation_delta: Math.sign(delta) };\n      }\n      await new Promise((resolve) => setTimeout(resolve, interval));\n    }\n\n    return null;\n  }\n}\n"],"mappings":"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"}

package/build/hmi.d.cts

@@ -1,2 +1,2 @@
-import { a as KnobEvent, c as ProgressValue, d as color, f as internalKnobEvent, h as text, i as Knob, l as Screen, m as progress, n as Color, o as PlaybackConfiguration, p as playbackConfiguration, r as HmiApi, s as Progress, t as Audio, u as ScreenText } from "./hmi-BEMiVKDF.cjs";
-export { Audio, Color, HmiApi, Knob, KnobEvent, PlaybackConfiguration, Progress, ProgressValue, Screen, ScreenText, color, internalKnobEvent, playbackConfiguration, progress, text };
+import { S as text, _ as color, a as KnobEvent, b as progress, c as ProgressValue, d as PromptRequestInput, f as PromptSelection, g as ScreenText, h as Screen, i as Knob, l as PromptChoice, m as PromptStatus, n as Color, o as PlaybackConfiguration, p as PromptState, r as HmiApi, s as Progress, t as Audio, u as PromptRequest, v as internalKnobEvent, x as promptState, y as playbackConfiguration } from "./hmi-OyVDyqU-.cjs";
+export { Audio, Color, HmiApi, Knob, KnobEvent, PlaybackConfiguration, Progress, ProgressValue, PromptChoice, PromptRequest, PromptRequestInput, PromptSelection, PromptState, PromptStatus, Screen, ScreenText, color, internalKnobEvent, playbackConfiguration, progress, promptState, text };

package/build/hmi.d.mts

@@ -1,2 +1,2 @@
-import { a as KnobEvent, c as ProgressValue, d as color, f as internalKnobEvent, h as text, i as Knob, l as Screen, m as progress, n as Color, o as PlaybackConfiguration, p as playbackConfiguration, r as HmiApi, s as Progress, t as Audio, u as ScreenText } from "./hmi-BEMiVKDF.mjs";
-export { Audio, Color, HmiApi, Knob, KnobEvent, PlaybackConfiguration, Progress, ProgressValue, Screen, ScreenText, color, internalKnobEvent, playbackConfiguration, progress, text };
+import { S as text, _ as color, a as KnobEvent, b as progress, c as ProgressValue, d as PromptRequestInput, f as PromptSelection, g as ScreenText, h as Screen, i as Knob, l as PromptChoice, m as PromptStatus, n as Color, o as PlaybackConfiguration, p as PromptState, r as HmiApi, s as Progress, t as Audio, u as PromptRequest, v as internalKnobEvent, x as promptState, y as playbackConfiguration } from "./hmi-Chid1Vvo.mjs";
+export { Audio, Color, HmiApi, Knob, KnobEvent, PlaybackConfiguration, Progress, ProgressValue, PromptChoice, PromptRequest, PromptRequestInput, PromptSelection, PromptState, PromptStatus, Screen, ScreenText, color, internalKnobEvent, playbackConfiguration, progress, promptState, text };

package/build/hmi.mjs

@@ -1,2 +1,2 @@
-import*as e from"valibot";const t=e.pipe(e.string(),e.maxLength(1024)),n=e.object({text:t}),r=e.optional(e.pipe(e.string(),e.length(7),e.hexColor())),i=e.object({text:r,progress:r,background:r}),a=e.pipe(e.number(),e.minValue(0),e.maxValue(100)),o=e.object({progress:a}),s=e.object({sound_id:e.picklist([`success`,`warning`,`failure`,`notification_1`,`notification_2`,`imperial_march`]),volume:e.pipe(e.number(),e.minValue(0),e.maxValue(100))}),c=e.object({button_pressed:e.boolean(),button_held:e.boolean(),rotation_delta:e.number()});e.omit(c,[`button_held`]);var l=class{fetch;constructor(e){this.fetch=e}reset(){return this.fetch(`/hmi/reset`,{method:`POST`,parseResponse:()=>{}})}screen(){return new u(this.fetch)}audio(){return new d(this.fetch)}knob(){return new f(this.fetch)}},u=class{fetch;constructor(e){this.fetch=e}async print(t){return(await this.fetch(`/hmi/screen/text`,{method:`POST`,body:e.parse(n,{text:t}),schema:n})).text}colors(t){return this.fetch(`/hmi/screen/colors`,{method:`PATCH`,body:e.parse(i,t),schema:i})}async progress(t){return t==0?await this.fetch(`/hmi/screen/progress`,{method:`DELETE`,parseResponse:()=>({progress:0})}):this.fetch(`/hmi/screen/progress`,{method:`PUT`,body:e.parse(o,{progress:t}),schema:o})}clear(){return this.fetch(`/hmi/screen/clear`,{method:`POST`,parseResponse:()=>{}})}clear_text(){return this.fetch(`/hmi/screen/text`,{method:`DELETE`,parseResponse:()=>{}})}},d=class{fetch;constructor(e){this.fetch=e}async play(t){return this.fetch(`/hmi/speaker/play`,{method:`POST`,body:e.parse(s,t),schema:s})}},f=class{fetch;constructor(e){this.fetch=e}read_event=()=>this.fetch(`/hmi/knob/get_knob_event`,{schema:c});is_button_held=async()=>(await this.read_event()).button_held;is_knob_turned=async()=>Math.abs((await this.read_event()).rotation_delta)>=4;async wait_event(e){await this.read_event();let t=0,n=Math.min(50,(e??500)/10),r=Date.now();for(;e===void 0||Date.now()-r<e;){let e=await this.read_event();if(t+=e.rotation_delta,e.button_pressed||Math.abs(t)>=4)return{button_pressed:e.button_pressed,rotation_delta:Math.sign(t)};await new Promise(e=>setTimeout(e,n))}return null}};export{d as Audio,l as HmiApi,f as Knob,u as Screen,i as color,c as internalKnobEvent,s as playbackConfiguration,o as progress,n as text};
+import*as e from"valibot";const t=e.pipe(e.string(),e.maxLength(1024)),n=e.object({text:t}),r=e.optional(e.pipe(e.string(),e.length(7),e.hexColor())),i=e.object({text:r,progress:r,background:r}),a=e.pipe(e.number(),e.minValue(0),e.maxValue(100)),o=e.object({progress:a}),s=e.object({sound_id:e.picklist([`success`,`warning`,`failure`,`notification_1`,`notification_2`,`imperial_march`]),volume:e.pipe(e.number(),e.minValue(0),e.maxValue(100))}),c=e.object({button_pressed:e.boolean(),button_held:e.boolean(),rotation_delta:e.number()});e.omit(c,[`button_held`]);const l=e.pipe(e.string(),e.maxBytes(64),e.regex(/\S/u,`Choice labels must not be blank`),e.check(e=>!/\p{Cc}/u.test(e),`Choice labels must not contain control characters`)),u=e.pipe(e.number(),e.integer(),e.minValue(0),e.maxValue(31)),d=e.object({label:l,color:r}),f=e.pipe(e.union([l,d]),e.transform(e=>typeof e==`string`?{label:e}:e)),p=e.pipe(e.object({text:e.pipe(e.string(),e.maxBytes(256),e.regex(/\S/u,`Prompt text must not be blank`),e.check(e=>!/[^\P{Cc}\n]/u.test(e),`Prompt text permits line feeds but no other control characters`)),choices:e.pipe(e.array(f),e.minLength(1),e.maxLength(32)),default_index:e.optional(u),timeout_ms:e.optional(e.pipe(e.number(),e.integer(),e.minValue(1e3),e.maxValue(18e5)))}),e.check(e=>e.default_index===void 0||e.default_index<e.choices.length,`default_index must be below the number of choices`)),m=e.object({label:l,index:u}),h=e.object({id:e.pipe(e.string(),e.minLength(1)),status:e.picklist([`pending`,`selected`,`cancelled`,`timed_out`]),selection:m,reason:e.optional(e.picklist([`client_cancelled`,`session_ended`,`panel_exit`,`display_replaced`]))});var g=class{fetch;events;constructor(e,t){this.fetch=e,this.events=t}reset(){return this.fetch(`/hmi/reset`,{method:`POST`,parseResponse:()=>{}})}async prompt(e,t){let n=t?.signal;n?.throwIfAborted();let r=(e.timeout_ms??6e4)+2e3,i,a,o=!1;try{let t=await this.createPrompt(e);i=t.id,n?.throwIfAborted();let s=[],c;a=this.events.on(`hmi.prompt`,e=>{e.data.id===t.id&&(s.push(e.data),c?.())}),o=!this.events.connected,await this.events.connect();let l=async()=>{if(s.length===0){let{promise:e,resolve:t}=Promise.withResolvers(),i=setTimeout(t,r);c=t;try{await this.untilAborted(e,n)}finally{clearTimeout(i),c=void 0}}return s.shift()},u=await this.untilAborted(this.getPrompt(t.id),n);for(;u.status===`pending`;)u=await l()??await this.untilAborted(this.getPrompt(t.id),n);return u}catch(e){if(i!==void 0)try{await this.cancelPrompt(i)}catch{}throw e}finally{a?.(),o&&this.events.close()}}createPrompt(t){return this.fetch(`/hmi/prompts`,{method:`POST`,body:e.parse(p,t),schema:h})}getPrompt(e){return this.fetch(`/hmi/prompts/${encodeURIComponent(e)}`,{schema:h})}cancelPrompt(e){return this.fetch(`/hmi/prompts/${encodeURIComponent(e)}`,{method:`DELETE`,schema:h})}async untilAborted(e,t){if(!t)return await e;let n;try{let r=new Promise((e,r)=>{n=()=>r(t.reason),t.addEventListener(`abort`,n,{once:!0})});return await Promise.race([e,r])}finally{n&&t.removeEventListener(`abort`,n)}}screen(){return new _(this.fetch)}audio(){return new v(this.fetch)}knob(){return new y(this.fetch)}},_=class{fetch;constructor(e){this.fetch=e}async print(t){return(await this.fetch(`/hmi/screen/text`,{method:`POST`,body:e.parse(n,{text:t}),schema:n})).text}colors(t){return this.fetch(`/hmi/screen/colors`,{method:`PATCH`,body:e.parse(i,t),schema:i})}async progress(t){return t==0?await this.fetch(`/hmi/screen/progress`,{method:`DELETE`,parseResponse:()=>({progress:0})}):this.fetch(`/hmi/screen/progress`,{method:`PUT`,body:e.parse(o,{progress:t}),schema:o})}clear(){return this.fetch(`/hmi/screen/clear`,{method:`POST`,parseResponse:()=>{}})}clear_text(){return this.fetch(`/hmi/screen/text`,{method:`DELETE`,parseResponse:()=>{}})}},v=class{fetch;constructor(e){this.fetch=e}async play(t){return this.fetch(`/hmi/speaker/play`,{method:`POST`,body:e.parse(s,t),schema:s})}},y=class{fetch;constructor(e){this.fetch=e}read_event=()=>this.fetch(`/hmi/knob/get_knob_event`,{schema:c});is_button_held=async()=>(await this.read_event()).button_held;is_knob_turned=async()=>Math.abs((await this.read_event()).rotation_delta)>=4;async wait_event(e){await this.read_event();let t=0,n=Math.min(50,(e??500)/10),r=Date.now();for(;e===void 0||Date.now()-r<e;){let e=await this.read_event();if(t+=e.rotation_delta,e.button_pressed||Math.abs(t)>=4)return{button_pressed:e.button_pressed,rotation_delta:Math.sign(t)};await new Promise(e=>setTimeout(e,n))}return null}};export{v as Audio,g as HmiApi,y as Knob,_ as Screen,i as color,c as internalKnobEvent,s as playbackConfiguration,o as progress,h as promptState,n as text};
 //# sourceMappingURL=hmi.mjs.map