@w6w/ui 0.2.0 → 0.2.11

package/CHANGELOG.md

@@ -9,6 +9,13 @@ repo's git history for exact dates and commits.
 
 ## [Unreleased]
 
+- `WorkflowFlowEditor` takes an optional `stepProblems` map (`StepProblems`, exported from `./flow`)
+  and paints a missing-connection error ring and tooltip on each affected app step, repainting live
+  when the map changes. The host owns detection; omitted, the canvas renders as before.
+- The step panel's Setup tab labels a connection that is absent from the loaded list "Missing
+  connection — choose another", and a failed connections fetch "Couldn't load connections" instead
+  of treating it as missing.
+
 ## [0.2.0]
 
 - New presentational lists, props in and callbacks out, so a host can compose its own pages:

package/dist/AppPicker.d.ts

@@ -1,10 +1,24 @@
 import { ReactNode } from 'react';
 import { AppSummary, ThemeMode } from './types.ts';
+/**
+ * The app's declared model-provider designation, or `null` when it declares
+ * none (A01). PRESENCE of `modelProvider` is the ONLY test — this never
+ * consults `categories`, so a category-`ai` app without a designation is not
+ * a provider and must never be surfaced as one.
+ */
+export declare function modelProviderOf(app: AppSummary): NonNullable<AppSummary["modelProvider"]> | null;
 export interface AppPickerProps {
     /** Fired when the user picks an app card. */
     onSelectApp: (app: AppSummary) => void;
     theme?: ThemeMode;
-    /** Optional pre-filter over the app list (e.g. only connectable apps). Applied CLIENT-side, on top of whatever page/list was fetched — never widens a fetch, only narrows what's shown. */
+    /**
+     * Optional pre-filter over the app list (e.g. only connectable apps).
+     * Applied CLIENT-side, on top of whatever page/list was fetched — never
+     * widens a fetch, only narrows what's shown. Because the server counted the
+     * apps this filter may then hide, a narrowing filter also removes the paged
+     * footer's denominator: the count reads `N apps`, never `N of total`.
+     * Prefer {@link ids} / {@link category} when the server can do the narrowing.
+     */
     filter?: (app: AppSummary) => boolean;
     /** Search-box placeholder. Defaults to "Search apps…". */
     searchPlaceholder?: string;
@@ -35,12 +49,42 @@ export interface AppPickerProps {
      * would be redundant.
      */
     categoryFilter?: boolean;
+    /**
+     * Render an opt-in model-provider filter BESIDE the category chips (crit 1,
+     * A01/A02): one toggle that narrows the list to apps carrying a
+     * `modelProvider` designation. It filters on the PRESENCE of `modelProvider`
+     * only — never on categories — so an undesignated category-`ai` app is never
+     * surfaced by it. Defaults to `false`, so no existing call site's behavior
+     * changes; the toggle itself is hidden when nothing in the visible catalog
+     * declares a provider (no dead-end filter, same rule as the category chips).
+     */
+    providerFilter?: boolean;
+    /**
+     * Opt-in bridge-support lookup, keyed by app id — the HOST passes this in,
+     * because this package never fetches (`GET /models/providers` carries
+     * `operations.complete` support and its `reasons`, and the host already
+     * holds that descriptor). Presence of an entry adds a chip beside the
+     * model-provider badge: "Bridge supported" when `supported`, else an
+     * "unsupported" chip carrying the entry's `reason` as both its text and its
+     * `title`. Omitting the prop (or an app having no entry) renders no chip at
+     * all, so every existing call site and snapshot is unchanged.
+     */
+    bridgeSupport?: ReadonlyMap<string, {
+        supported: boolean;
+        reason?: string;
+    }>;
     /**
      * Server-side `category` param for the bounded paged fetch (e.g. `"ai"` for
      * the AI tab) — sent to `W6WApi.listAppsPage`, never applied client-side.
      * Ignored when `apps` is supplied or the host has no `listAppsPage`.
      */
     category?: string;
+    /**
+     * Server-side id allow-list (`GET /apps?ids=a,b&paged=true`) for the bounded
+     * paged fetch: the page `total` is the FILTERED total, so the footer reads
+     * `N of N`. Sent to `listAppsPage`/`loadPage`; ignored when `apps` is supplied.
+     */
+    ids?: string[];
     /** Bounded page size for the paged fetch. Defaults to {@link DEFAULT_PAGE_LIMIT} (60). */
     pageLimit?: number;
     /**
@@ -55,6 +99,7 @@ export interface AppPickerProps {
         q?: string;
         cursor?: string;
         limit: number;
+        ids?: string[];
         signal: AbortSignal;
     }) => Promise<{
         apps: AppSummary[];
@@ -81,4 +126,4 @@ export interface AppPickerProps {
  *    with neither `listAppsPage` nor `listApps` settles into this same
  *    mode's existing empty state — no request, no throw.
  */
-export declare function AppPicker({ onSelectApp, theme, filter, searchPlaceholder, emptyMessage, search, emptyAction, apps: providedApps, categoryFilter, category, pageLimit, loadPage, }: AppPickerProps): import("react").JSX.Element;
+export declare function AppPicker({ onSelectApp, theme, filter, searchPlaceholder, emptyMessage, search, emptyAction, apps: providedApps, categoryFilter, providerFilter, bridgeSupport, category, ids, pageLimit, loadPage, }: AppPickerProps): import("react").JSX.Element;

package/dist/CanvasLayer.d.ts

@@ -0,0 +1,38 @@
+import { FlowCanvas } from './canvas-types.ts';
+export interface CanvasLayerProps {
+    canvas: FlowCanvas;
+    savePosition?: boolean;
+    /** Fired ONCE per finished edit (drop / blur / colour pick / format), never per frame. */
+    onChange?: (canvas: FlowCanvas) => void;
+    /**
+     * Fired once when a section is dropped after a drag, so the host can move the members by the
+     * same delta. When omitted, only the section's own position changes (via `onChange`).
+     */
+    onSectionDrop?: (id: string, delta: {
+        dx: number;
+        dy: number;
+    }) => void;
+    /** Ask the host to confirm-then-delete a note or section (the layer never deletes itself). */
+    onRequestDelete?: (kind: "note" | "section", id: string) => void;
+    /** Hides every control and disables drag. */
+    readOnly?: boolean;
+    /** Flow zoom, to turn screen-pixel drags into flow units. Resolved from the store in a flow. */
+    zoom?: number;
+    className?: string;
+    /**
+     * The element to portal into. Omit inside a React Flow: the enclosing flow's
+     * `.react-flow__viewport` is resolved from its DOM ref. Pass explicitly (tests, stories).
+     */
+    viewport?: Element | null;
+}
+export declare const SECTIONS_Z_INDEX = -2;
+export declare const NOTES_Z_INDEX = -1;
+/** The selected note's or section's toolbar sits above nodes and edges, unlike the box itself. */
+export declare const NOTE_TOOLBAR_Z_INDEX = 1000;
+/** The note colour palette offered by the toolbar (a custom colour is still accepted). */
+export declare const NOTE_COLORS: string[];
+/**
+ * Sections (z -2) and notes (z -1) rendered behind edges/nodes, inside the flow viewport; the
+ * selected note's or section's toolbar floats above everything.
+ */
+export declare function CanvasLayer(props: CanvasLayerProps): import("react").JSX.Element;

package/dist/{CodeBlock-Dot3Pd7P.js → CodeBlock-BqXDA35P.js}

@@ -1,6 +1,6 @@
 import { jsx as $ } from "react/jsx-runtime";
 import { createElement as K, useCallback as V, useMemo as ge } from "react";
-import { C as de } from "./Copyable-1niV9gUa.js";
+import { C as de } from "./Copyable-F4NTaG77.js";
 function re(e) {
   var t, a, l = "";
   if (typeof e == "string" || typeof e == "number") l += e;
@@ -2886,4 +2886,4 @@ function At(e) {
 export {
   At as C
 };
-//# sourceMappingURL=CodeBlock-Dot3Pd7P.js.map
+//# sourceMappingURL=CodeBlock-BqXDA35P.js.map