@swiftbrowser/web 0.18.3 → 0.21.0

package/src/symbols.ts

@@ -294,6 +294,7 @@ import {
   Puzzle,
   QrCode,
   Rabbit,
+  Rainbow,
   Radio,
   RectangleHorizontal,
   RectangleVertical,
@@ -748,6 +749,9 @@ export const SF_SYMBOLS: Readonly<Record<string, SymbolGlyph>> = {
   bolt: outline(Zap),
   'bolt.fill': solid(Zap),
   sparkles: outline(Sparkles),
+  // Apple Intelligence's mark: the sparkles stand in for it.
+  'apple.intelligence': outline(Sparkles),
+  rainbow: outline(Rainbow),
 
   // Chevrons and arrows
   'chevron.left': outline(ChevronLeft),
@@ -773,6 +777,7 @@ export const SF_SYMBOLS: Readonly<Record<string, SymbolGlyph>> = {
   'arrow.left.circle': outline(CircleArrowLeft),
   'arrow.right.circle': outline(CircleArrowRight),
   'arrow.up.circle': outline(CircleArrowUp),
+  'arrow.up.circle.fill': knockout(CircleArrowUp),
   'arrow.down.circle': outline(CircleArrowDown),
   'arrow.down.to.line': outline(ArrowDownToLine),
   'arrow.up.to.line': outline(ArrowUpFromLine),
@@ -898,6 +903,7 @@ export const SF_SYMBOLS: Readonly<Record<string, SymbolGlyph>> = {
   'pause.circle': outline(CirclePause),
   'pause.circle.fill': knockout(CirclePause),
   'stop.circle': outline(CircleStop),
+  'stop.circle.fill': knockout(CircleStop),
   pause: outline(Pause),
   'pause.fill': solid(Pause),
   stop: outline(Square),

package/src/viewRegistry.ts

@@ -0,0 +1,58 @@
+/**
+ * The page's half of `ViewRegistry` (docs/ops-protocol.md, "Registered
+ * views"): a view a package draws itself, by name, which the `registered`
+ * element kind names. A native app registers a SwiftUI view under the same
+ * name (SwiftBrowserNative's `ViewRegistry`), so one component
+ * (`RegisteredView` in @swiftbrowser/react) is a SwiftUI view in the app and
+ * the package's own DOM on a page, drawing what never crosses the bridge
+ * (an audio node's frames, a map's tiles).
+ *
+ * ```ts
+ * ViewRegistry.register('Meter', (context) => {
+ *   const element = document.createElement('canvas');
+ *   return { element, update: (props) => …, dispose: () => … };
+ * });
+ * ```
+ */
+
+/** What a builder gets: the element's id, its props as the app wrote them, and a way to answer (`onEvent`). */
+export interface RegisteredViewContext {
+  readonly id: number;
+  readonly props: Record<string, unknown>;
+  /** Sends a value to the element's `onEvent` in the app. */
+  send(value: unknown): void;
+}
+
+/** A built view: its element, which fills the box the layout gives it, and what to do as props change or it goes. */
+export interface RegisteredViewInstance {
+  readonly element: HTMLElement;
+  update?(props: Record<string, unknown>): void;
+  dispose?(): void;
+}
+
+export type RegisteredViewBuilder = (context: RegisteredViewContext) => RegisteredViewInstance | HTMLElement;
+
+const builders = new Map<string, RegisteredViewBuilder>();
+
+export const ViewRegistry = {
+  /** Registers `builder` under `name`, replacing one registered before; elements made after use it. */
+  register(name: string, builder: RegisteredViewBuilder): void {
+    builders.set(name, builder);
+  },
+
+  unregister(name: string): void {
+    builders.delete(name);
+  },
+
+  isRegistered(name: string): boolean {
+    return builders.has(name);
+  },
+
+  /** The view registered under `name`, built; undefined when there is none. */
+  make(name: string, context: RegisteredViewContext): RegisteredViewInstance | undefined {
+    const builder = builders.get(name);
+    if (!builder) return undefined;
+    const made = builder(context);
+    return made instanceof HTMLElement ? { element: made } : made;
+  },
+};