@monospaced/set-core 0.12.0 → 0.14.0

package/dist/components/image/image.d.ts

@@ -1,5 +1,6 @@
 import { type SetNode } from "../../helpers/node";
 import type { SetComponentSpec } from "../../spec";
+export declare const SET_IMAGE_TAG_NAME = "set-image";
 export type SetImageAspectRatio = "1:1" | "4:5" | "3:2" | "16:9" | "21:9";
 export type SetImageFit = "intrinsic" | "fluid" | "cover";
 export type SetImageGravity = "N" | "NE" | "E" | "SE" | "S" | "SW" | "W" | "NW" | "C";
@@ -23,6 +24,14 @@ export interface SetImageSource {
      * Same format as the HTML `source[srcset]` attribute.
      */
     srcSet: string;
+    /**
+     * Intro overlay for this source in an `animated` sequence.
+     */
+    leadSrc?: string;
+    /**
+     * Reduced-motion still for this source, used when `animated`.
+     */
+    still?: string;
     /**
      * MIME type for the `srcSet` resources.
      */
@@ -35,6 +44,8 @@ export interface SetImageSource {
 export interface SetImageProps {
     /** Show the light or dark variant to match the surrounding scheme. @default false */
     adaptive?: boolean;
+    /** Render an animated image with a reduced-motion still. @default false */
+    animated?: boolean;
     /** Alternative text. Empty string is valid and used by default. @default "" */
     alt?: string;
     /** Aspect ratio applied to the wrapper. */
@@ -49,6 +60,8 @@ export interface SetImageProps {
     id?: string;
     /** Emit `loading="lazy"` on the image. @default false */
     lazy?: boolean;
+    /** Intro overlay that plays once, then reveals `src`, when `animated`. */
+    leadSrc?: string;
     /** Emit `fetchpriority="high"` and suppress `loading="lazy"`. @default false */
     priority?: boolean;
     /** Focal gravity for the cover crop. @default "C" */
@@ -61,6 +74,8 @@ export interface SetImageProps {
     sources?: SetImageSource[];
     /** Candidate sources for the fallback `<img>` (HTML `img[srcset]` format). */
     srcSet?: string;
+    /** Reduced-motion still, used when `animated`. */
+    still?: string;
     /** Image source URL. */
     src: string;
     /** Width in pixels. */
@@ -72,14 +87,29 @@ export interface SetImageProps {
  * @param props - Image component props.
  * @returns IR node for image/picture markup.
  */
-export declare function buildSetImage({ adaptive, alt, aspectRatio, fit, gravity, height, id, lazy, priority, radius, shadow, sizes, sources, src, srcSet, width, }: SetImageProps): SetNode;
+export declare function buildSetImage({ adaptive, animated, alt, aspectRatio, fit, gravity, height, id, lazy, leadSrc, priority, radius, shadow, sizes, sources, src, srcSet, still, width, }: SetImageProps): SetNode;
 /**
  * SSR renderer for the Set image component.
  *
+ * Emits meaningful light-DOM HTML inside a `set-image` host. The output is
+ * fully functional without JS — scheme selection, the reduced-motion still,
+ * and the sequenced hand-off are CSS-driven; `defineSetImage` only enhances
+ * sequenced images.
+ *
  * @param props - Image component props.
  * @returns HTML string for image/picture markup.
  */
 export declare function renderSetImage(props: SetImageProps): string;
+/**
+ * Defines the `set-image` custom element runtime.
+ *
+ * Safe to call multiple times, and entirely optional — SSR output works without
+ * it. Upgrading only enhances *sequenced* (`leadSrc`) images: it anchors each
+ * lead overlay's hide to when that overlay's frames have loaded, rather than a
+ * fixed delay from render (which can clip the hand-off on slow connections).
+ * Non-sequenced images upgrade to an inert host.
+ */
+export declare function defineSetImage(): void;
 /** Declarative image contract mirror for tooling, docs, and adapters. */
 export declare const SET_IMAGE_SPEC: SetComponentSpec;
 //# sourceMappingURL=image.d.ts.map

package/dist/components/image/image.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../../src/components/image/image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAEpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAC1E,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC;AAC1D,MAAM,MAAM,eAAe,GACvB,GAAG,GACH,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,GAAG,CAAC;AACR,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,CAAC;AAC9C,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,qFAAqF;IACrF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+EAA+E;IAC/E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,wCAAwC;IACxC,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,yDAAyD;IACzD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gFAAgF;IAChF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qDAAqD;IACrD,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,wDAAwD;IACxD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,GAAQ,EACR,WAAW,EACX,GAAiB,EACjB,OAAa,EACb,MAAM,EACN,EAAE,EACF,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,MAAM,EACN,KAAK,EACL,OAAO,EACP,GAAG,EACH,MAAM,EACN,KAAK,GACN,EAAE,aAAa,GAAG,OAAO,CAsIzB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAE3D;AAED,yEAAyE;AACzE,eAAO,MAAM,cAAc,EAAE,gBA0M5B,CAAC"}
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../../src/components/image/image.ts"],"names":[],"mappings":"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"}