@solidrt/flux-types 0.0.73 → 0.0.75

package/gui/font.d.ts

@@ -62,6 +62,13 @@ declare module "flux:font" {
      * stems to whole pixels as well, which a grid of cells drawn at whole
      * pixels (a terminal) wants; false (default) keeps the outline as the
      * font draws it. An msdf atlas is never hinted.
+     *
+     * "full" rounds every stem on its own, so it suits outline fonts, not
+     * pixel fonts: a font whose glyphs are pixel rectangles, drawn where a
+     * font pixel is a fraction of a device pixel (1.6 px, say), gets each
+     * row rounded to one pixel at the wider pitch and reads as dashes with
+     * blank rows between. Draw a pixel font unhinted at a whole-pixel
+     * scale instead.
      */
     hint?: boolean | "light" | "full"
     /** Debug label of the atlas texture. */

package/gui/microphone.d.ts

@@ -1,6 +1,7 @@
 // Microphone capture (gui-enabled runtime only). The imperative primitive;
 // @solidrt/core's createMicrophone wraps it with SolidJS reactivity. `open`
-// returns a bound session object, so the raw handle never leaves the runtime.
+// resolves to a bound session object: its methods are bound, and its `id` is
+// what a runtime module takes a reader of its own by.
 
 declare module "flux:microphone" {
   /** A microphone device from {@link listMicrophones}. */
@@ -21,19 +22,38 @@ declare module "flux:microphone" {
 
   /** An opened microphone session with controls bound to it. */
   type MicrophoneSession = {
+    /**
+     * The session's id: what the app hands a runtime module that reads this
+     * microphone on a thread of its own (`microphone_tap` in the runtime).
+     */
+    id: number
     /** The actual capture sample rate in Hz. */
     sampleRate: number
-    /** Drain the mono float samples captured since the last read. */
+    /**
+     * Drain the mono float samples captured since the last read. The session
+     * keeps a 10 s window of audio, so there is no obligation to poll: a read
+     * later than that gets the last 10 s and the older samples are lost (the
+     * runtime logs it). A runtime module reading the session hears every
+     * sample too; reads do not take from each other.
+     */
     read(): Float32Array
-    /** Release the device. */
+    /** Release the device. Every reader of the session, a module's included, ends. */
     close(): void
   }
 
-  /** List the available microphone devices. */
+  /**
+   * List the available microphone devices. Under a test that installed a
+   * clip as the microphone (`app.microphone` of `@solidrt/test`) the list is
+   * that one microphone, id 0.
+   */
   export function listMicrophones(): MicrophoneDevice[]
   /**
-   * Open a microphone. Synchronous: current platforms expose no audio permission
-   * prompt.
+   * Open a microphone. Opening is the permission request: on Android the
+   * RECORD_AUDIO prompt comes up and the app keeps running behind it; the
+   * other platforms show none. Resolves once capture runs. Rejects when the
+   * user denies the permission ("microphone permission denied"), when the
+   * device cannot be opened, and under a test when the sample rate differs
+   * from the installed clip's.
    */
-  export function open(options?: MicrophoneOpenOptions): MicrophoneSession
+  export function open(options?: MicrophoneOpenOptions): Promise<MicrophoneSession>
 }

package/gui/rendertree.d.ts

@@ -258,6 +258,12 @@ declare module "flux:rendertree" {
      * size: a 1x screen read from a distance) or `false` (the outline as
      * the font draws it). null restores the default: light below 2x,
      * off above.
+     *
+     * "full" rounds every stem on its own, so it suits outline fonts, not
+     * pixel fonts: a font whose glyphs are pixel rectangles, drawn where a
+     * font pixel is a fraction of a device pixel, gets each row rounded to
+     * one pixel at the wider pitch and reads as dashes with blank rows
+     * between. Draw a pixel font unhinted at a whole-pixel scale instead.
      */
     hint?: boolean | "light" | "full" | null
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solidrt/flux-types",
-  "version": "0.0.73",
+  "version": "0.0.75",
   "license": "MIT",
   "funding": "https://github.com/sponsors/wellawaretech",
   "author": "Antoine van Wel",