@vectoriox/iox-ui 5.15.0 → 5.16.0

package/index.d.ts

@@ -184,9 +184,11 @@ declare class BuilderImageComponent {
     alt: string;
     nodeId: string;
     /**
-     * What a MARKED image shows while it has no source (design-system DS3) — set by each renderer from
-     * the shared `emptyImageSrc` (`@vectoriox/iox-ui/design-core`): the "Add image" label on the canvas,
-     * the blank on the live site, `null` for an unmarked image, which therefore renders as before.
+     * What a MARKED image shows WHENEVER it has no source (design-system DS3) — set by each renderer
+     * from the shared `emptyImagePlaceholder` (`@vectoriox/iox-ui/design-core`): the "Add image" label
+     * on the canvas, the blank on the live site, `null` for an unmarked image, which therefore renders
+     * as before. It does not depend on `src`, so clearing the source (a binding emptied, a context slot
+     * not yet filled) shows it with no re-render; a renderer re-sets it only when the MARKER changes.
      */
     emptySrc: string | null;
     /**
@@ -200,8 +202,16 @@ declare class BuilderImageComponent {
      * filled when the visitor interacts (see element-context-state-plan.md).
      */
     get srcAttr(): string | null;
+    private get showsPlaceholder();
     /** `data-iox-empty` while the placeholder stands in — the hook the shared fill rule keys on. */
     get emptyAttr(): '' | null;
+    /**
+     * The placeholder is not the author's picture, so it never carries the author's alt: it is
+     * decorative (`alt=""`) and hidden from assistive technology — on the live site, in Preview and on
+     * the canvas alike (the canvas label is painted inside the placeholder, not announced as content).
+     */
+    get altAttr(): string;
+    get ariaHiddenAttr(): 'true' | null;
     static ɵfac: i0.ɵɵFactoryDeclaration<BuilderImageComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<BuilderImageComponent, "img[iox-img]", never, { "src": { "alias": "src"; "required": false; }; "alt": { "alias": "alt"; "required": false; }; "nodeId": { "alias": "nodeId"; "required": false; }; "emptySrc": { "alias": "emptySrc"; "required": false; }; }, {}, never, never, false, never>;
 }
@@ -247,6 +257,11 @@ declare class BuilderIconComponent {
 /**
  * Directive-host link: the `<a>` IS the host — no wrapper. Content is the label; styles come from
  * `.iox-node` (the legacy `style` input is kept for builder compat but no longer inline-applied).
+ *
+ * Outside a preview (`IS_PREVIEW` unprovided — the editing canvas, the design sampler) the link keeps
+ * its real `href` so it LOOKS like the live site's (the UA link styles key on it) and stays clickable
+ * so the canvas can select it, but no click navigates: plain, modified (cmd/ctrl/shift) and middle
+ * clicks all have their default cancelled here.
  */
 declare class BuilderLinkComponent {
     isPreview: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vectoriox/iox-ui",
-  "version": "5.15.0",
+  "version": "5.16.0",
   "peerDependencies": {
     "@angular/common": ">=20.0.0",
     "@angular/core": ">=20.0.0",

package/src/design-core/empty-image.ts

@@ -41,12 +41,21 @@ export function emptyImageLabelSrc(label: string): string {
 }
 
 /**
- * The `src` a node's Image renders when its own source is empty: the canvas label (when `label` is
- * given) or the live blank for a MARKED node; `null` — render exactly as before — for an unmarked
- * node or one that has a source.
+ * What a node's Image shows WHENEVER its source is empty: the canvas label (when `label` is given) or
+ * the live blank for a MARKED node; `null` — render exactly as before — for an unmarked node. It does
+ * not look at the source, so a renderer computes it once per marker/label and the component falls
+ * back to it the moment its source is cleared (a binding emptied, a context slot not yet filled).
  */
-export function emptyImageSrc(node: { elementStyle?: string | null } | null | undefined, src: unknown, label?: string | null): string | null {
-    if (src != null && src !== '') return null;
+export function emptyImagePlaceholder(node: { elementStyle?: string | null } | null | undefined, label?: string | null): string | null {
     if (!hasElementStyleMarker(node)) return null;
     return label ? emptyImageLabelSrc(label) : EMPTY_IMAGE_SRC;
 }
+
+/**
+ * The `src` a node's Image renders for a given source: its placeholder while the source is empty,
+ * `null` once it has one (the source itself renders) or when the node is unmarked.
+ */
+export function emptyImageSrc(node: { elementStyle?: string | null } | null | undefined, src: unknown, label?: string | null): string | null {
+    if (src != null && src !== '') return null;
+    return emptyImagePlaceholder(node, label);
+}

package/src/design-core/flavor-spec.generated.ts

@@ -1419,7 +1419,7 @@ export const SPEC_ELEMENT_STYLES = [
       "fontSize": "var(--iox-size-lead)",
       "fontWeight": "var(--iox-weight-body)",
       "lineHeight": "var(--iox-leading-body)",
-      "color": "var(--iox-text)"
+      "color": "inherit"
     }
   },
   {
@@ -1434,7 +1434,7 @@ export const SPEC_ELEMENT_STYLES = [
       "fontSize": "var(--iox-size-body)",
       "fontWeight": "var(--iox-weight-body)",
       "lineHeight": "var(--iox-leading-body)",
-      "color": "var(--iox-text)"
+      "color": "inherit"
     }
   },
   {