@nubisco/ui 2.8.1 → 3.0.0

package/dist/components/BlueprintCard.types.d.ts

@@ -11,30 +11,51 @@ export interface IBlueprintPortChannel {
     label: string;
 }
 /**
- * Visual shape for a single pin. Independent of `dataType` so an
- * `audio` port can render as a square (e.g. for an aux send) without
- * forcing the dataType taxonomy to grow new variants. When unset, the
- * shape is derived from `dataType` (see PIN_SHAPES inside
- * BlueprintCard.vue).
+ * Visual shape for a single pin.
  *
- *   - `'pill'` (default for most dataTypes): a 6x14 rounded pill —
- *     the canonical Blueprint connector tab.
- *   - `'diamond'`: rotated square, ~10x10. Reads as "control / event"
- *     rather than "audio / signal flow". MIDI and `control` ports
- *     default to this.
- *   - `'square'`: sharp 10x10 box. Good for typed-data ports
- *     (`color`, `asset`).
- *   - `'circle'`: small 8x8 dot. Good for boolean / single-bit
- *     ports where the smaller hit area visually de-emphasises the
- *     port relative to audio pins.
+ * Shape is the target a user aims a wire at, so it deliberately does NOT vary
+ * with `dataType`: a target that changes form per port is one they have to
+ * re-learn each time, and a rotated or shrunken silhouette converges with the
+ * default pill as soon as the canvas is zoomed out. What a port carries is
+ * expressed by `signal` (solid vs striped) and `color` instead, neither of
+ * which touches the pin's outline.
+ *
+ *   - `'pill'` (default): the canonical connector tab, flat against the card
+ *     and rounded on its outer end.
+ *   - `'square'`: a sharp box, tangent to the card edge.
+ *   - `'circle'`: a small dot. Its smaller target de-emphasises the port.
+ *
+ * Reach for a variant only when a port needs to be told apart from its
+ * immediate neighbours on the same card, never as a way to encode type.
  */
-export type TBlueprintPortShape = 'pill' | 'diamond' | 'square' | 'circle';
+export type TBlueprintPortShape = 'pill' | 'square' | 'circle';
 /**
  * Visual size for a single pin. Independent of shape. `'md'` is the
  * default — `'sm'` shrinks the pin (good for secondary / metadata
  * ports), `'lg'` enlarges (good for primary audio ins / outs that
  * need to be visually emphasised).
  */
+/**
+ * Whether a port carries a continuously varying quantity or discrete events.
+ *
+ * This is the library's own axis, deliberately independent of `dataType`,
+ * which is a domain taxonomy that will keep growing. Analog and digital is
+ * the distinction that changes how a port behaves rather than what it is
+ * called, and it drives two things:
+ *
+ *   - **Decoration.** Digital pins are striped, analog pins are solid. Same
+ *     silhouette either way: a pin is a target the user aims a wire at, and
+ *     changing its shape by type makes that aim less predictable for no gain.
+ *     Texture separates them without touching form or the colour channel,
+ *     which `dataType` already spends.
+ *   - **Activity.** An analog port shows a level, filling in proportion to
+ *     what is flowing. A digital port has no meaningful level, so it pulses
+ *     once per event instead. See `portLevels` and `activePorts`.
+ *
+ * Defaults are derived from `dataType`, so existing ports get the right
+ * behaviour without being touched. Set it explicitly to override.
+ */
+export type TBlueprintPortSignal = 'analog' | 'digital';
 export type TBlueprintPortSize = 'sm' | 'md' | 'lg';
 /**
  * How tightly a card packs its chrome. Set once on `NbBlueprint` and every
@@ -97,6 +118,12 @@ export interface IBlueprintPort {
      * connection.
      */
     size?: TBlueprintPortSize;
+    /**
+     * Whether this port carries a continuous quantity or discrete events.
+     * Beats the `dataType`-derived default. Drives the pin's decoration and
+     * which activity treatment it uses.
+     */
+    signal?: TBlueprintPortSignal;
 }
 /** Status indicator level */
 export type TBlueprintCardStatus = 'valid' | 'warning' | 'error' | 'none';
@@ -160,10 +187,17 @@ export interface IBlueprintCardProps {
      */
     showPortLabels?: TBlueprintPortLabelMode;
     /**
-     * Signal level per port id, 0 to 1. A port present here fills from the
-     * bottom in proportion to its level, so a quiet port looks quiet and a hot
-     * one looks hot. Ports in `activePorts` but absent here render as a solid
-     * fill instead.
+     * Signal level per port id, **0 to 1** (not 0 to 100), clamped. A port
+     * present here fills from the bottom in proportion to its level, so a quiet
+     * port looks quiet and a hot one looks hot. Ports in `activePorts` but
+     * absent here render as a solid fill instead.
+     *
+     * The scale is normalised on purpose: the library has no opinion on what
+     * the quantity is. An audio host maps dBFS onto 0 to 1 with whatever curve
+     * suits its meters, which is a decision only it can make.
+     *
+     * Only meaningful for analog ports. A digital port has no level; it pulses
+     * per event instead, driven by `activePorts`.
      *
      * This replaces the old behaviour, where every active port ran the same
      * looping ring forever and carried no information beyond "wired and live".

package/dist/components/BlueprintCard.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BlueprintCard.types.d.ts","sourceRoot":"","sources":["../../src/components/BlueprintCard.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"BlueprintCard.types.d.ts","sourceRoot":"","sources":["../../src/components/BlueprintCard.types.ts"],"names":[],"mappings":"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"}

package/dist/components/BlueprintCard.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BlueprintCard.vue.d.ts","sourceRoot":"","sources":["../../src/components/BlueprintCard.vue"],"names":[],"mappings":"AA6nDA,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EAEd,oBAAoB,EACpB,iBAAiB,EAGlB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAqgChE,QAAA,IAAI,OAAO,IAAW,CAAE;AACxB,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,CAAC;AAK/C,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6EAId,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AAWzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}
+{"version":3,"file":"BlueprintCard.vue.d.ts","sourceRoot":"","sources":["../../src/components/BlueprintCard.vue"],"names":[],"mappings":"AAsqDA,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EAEd,oBAAoB,EACpB,iBAAiB,EAIlB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAsiChE,QAAA,IAAI,OAAO,IAAW,CAAE;AACxB,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,CAAC;AAK/C,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6EAId,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AAWzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}