@wix/himalaya-cli 0.1473.0 → 0.1474.0

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/dev-server/src/builder.d.ts

@@ -368,6 +368,42 @@ export declare function donutChart(props: {
 }, opts?: {
     id?: string;
 }): Component;
+/** RFC 0065 §5 — the kinds a {@link shape} draws and `modifiers.clipShape` clips to. */
+export type ShapeKind = "rectangle" | "roundedRectangle" | "capsule" | "circle" | "ellipse";
+/** RFC 0065 §5 — per-corner radii in layout direction (mirror in RTL). */
+export interface CornerRadiiSpec {
+    topLeading?: number;
+    topTrailing?: number;
+    bottomLeading?: number;
+    bottomTrailing?: number;
+}
+/** RFC 0065 §5 — a basic shape: fill (token or inline gradient) and an optionally dashed
+ *  stroke drawn INSIDE its bounds. Size it with `modifiers.width/height`; with no frame it
+ *  fills its proposal. Decorative — name a meaningful one with `accessibilityLabel`. */
+export declare function shape(props: {
+    kind?: ShapeKind;
+    cornerRadius?: number;
+    cornerRadii?: CornerRadiiSpec;
+    /** colour token */
+    fill?: string;
+    fillGradient?: {
+        kind?: "linear" | "radial";
+        stops: Array<{
+            token: string;
+            at?: number;
+        }>;
+        start?: string;
+        end?: string;
+    };
+    stroke?: {
+        color?: string;
+        width?: number;
+        dash?: number[];
+    };
+}, opts?: {
+    id?: string;
+    modifiers?: NonNullable<Component["modifiers"]>;
+}): Component;
 /** RFC 0057 — labels for a chart or a table. `marker: "dashed"` labels a
  *  {@link chart} series drawn with the dashed stroke, which is what makes
  *  colour-free series identity readable. `value` is already formatted. */

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/ts/src/schema.d.ts

@@ -387,6 +387,13 @@ export interface Modifiers {
      *  The generalization of `FragmentSlotCase.accessibilityAnnouncement`, which only ever
      *  fired on a fragment-slot case swap. */
     announce?: LiveRegion;
+    /** RFC 0065 §5 — clip ANY node (content + surface) to a shape:
+     *  "rectangle" | "roundedRectangle" | "capsule" | "circle" | "ellipse". Unknown/empty =
+     *  no shape clip (`cornerRadius` keeps its meaning). When set it replaces the
+     *  corner-radius-only clip; a "roundedRectangle" uses `clipCornerRadii`, else `cornerRadius`. */
+    clipShape?: string;
+    /** RFC 0065 §5 — uneven corner radii for `clipShape: "roundedRectangle"`. */
+    clipCornerRadii?: CornerRadii;
     /** RFC 0069 — a recurring, finite, transform-only motion on a decorative node: a
      *  living character's idle `hop`, a `blink`, a working `breathe`. Never changes the
      *  node's layout footprint. Stopped by reduced motion unless `respectReducedMotion`
@@ -1591,6 +1598,37 @@ export interface DonutChartProps {
     /** base token for the derived opacity ramp (default "accentPrimary") */
     color?: TokenName;
 }
+/** RFC 0065 §5 — per-corner radii in LAYOUT direction (leading/trailing mirror in RTL). */
+export interface CornerRadii {
+    topLeading?: number;
+    topTrailing?: number;
+    bottomLeading?: number;
+    bottomTrailing?: number;
+}
+/** RFC 0065 §5 — a stroke along a {@link ShapeProps} outline. Drawn INSIDE the shape's
+ *  bounds (SwiftUI `strokeBorder` semantics) so a stroke never overhangs its frame. */
+export interface ShapeStroke {
+    color?: TokenRef;
+    /** pt/dp; absent/0 ⇒ 1 */
+    width?: number;
+    /** on/off dash lengths in pt/dp; empty ⇒ solid. RN draws any dash as its fixed `dashed` style. */
+    dash?: number[];
+}
+/**
+ * RFC 0065 §5 — a basic shape. Size comes from `modifiers.width/height` like any node;
+ * with no frame it fills its proposal. `kind` is a string discriminator: unknown ⇒
+ * "rectangle". `fillGradient` wins over `fill`; `cornerRadii` wins over `cornerRadius`
+ * when any corner is set. Decorative: it has no accessible name of its own.
+ */
+export interface ShapeProps {
+    /** "rectangle" (default) | "roundedRectangle" | "capsule" | "circle" | "ellipse" */
+    kind?: string;
+    cornerRadius?: number;
+    cornerRadii?: CornerRadii;
+    fill?: TokenRef;
+    fillGradient?: Gradient;
+    stroke?: ShapeStroke;
+}
 /** One row of a {@link LegendProps}. */
 export interface LegendItem {
     label?: string;
@@ -2560,6 +2598,10 @@ export type CoreComponentBody = {
     package: "himalaya";
     type: "DataTable";
     props: DataTableProps;
+} | {
+    package: "himalaya";
+    type: "Shape";
+    props: ShapeProps;
 } | {
     package: "himalaya";
     type: "RichContent";

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/core/ts/src/validator.d.ts

@@ -938,6 +938,31 @@ export declare const screenDescriptorSchema: {
                         };
                     };
                 };
+                readonly clipShape: {
+                    readonly type: "string";
+                };
+                readonly clipCornerRadii: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly properties: {
+                        readonly topLeading: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                        readonly topTrailing: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                        readonly bottomLeading: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                        readonly bottomTrailing: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                    };
+                };
                 readonly ambientMotion: {
                     readonly type: "object";
                     readonly additionalProperties: false;
@@ -2209,6 +2234,31 @@ export declare const widgetSnapshotSchema: {
                         };
                     };
                 };
+                readonly clipShape: {
+                    readonly type: "string";
+                };
+                readonly clipCornerRadii: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly properties: {
+                        readonly topLeading: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                        readonly topTrailing: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                        readonly bottomLeading: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                        readonly bottomTrailing: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                    };
+                };
                 readonly ambientMotion: {
                     readonly type: "object";
                     readonly additionalProperties: false;

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/core.mjs

@@ -8870,6 +8870,20 @@ var screenDescriptorSchema = {
             trigger: { type: "string", enum: ["on_change", "on_appear", "both", "none"] }
           }
         },
+        // RFC 0065 §5 — shape clipping (core.proto Modifiers 76–77). A STRING, not an enum:
+        // RFC 0065 constraint 1 — an unknown kind coalesces to "no shape clip" on every arm,
+        // so a newer kind must not fail validation on an older toolchain.
+        clipShape: { type: "string" },
+        clipCornerRadii: {
+          type: "object",
+          additionalProperties: false,
+          properties: {
+            topLeading: { type: "integer", minimum: 0 },
+            topTrailing: { type: "integer", minimum: 0 },
+            bottomLeading: { type: "integer", minimum: 0 },
+            bottomTrailing: { type: "integer", minimum: 0 }
+          }
+        },
         // RFC 0069 — recurring, finite, transform-only motion on a decorative node. `kind`
         // is an open string: an unknown kind renders no motion, so an older validator must
         // not reject a newer one.
@@ -9228,6 +9242,8 @@ var CORE_COMPONENTS = /* @__PURE__ */ new Set([
   "himalaya.DonutChart",
   "himalaya.Legend",
   "himalaya.DataTable",
+  // Shape — RFC 0065 §5
+  "himalaya.Shape",
   // Rich content — RFC 0063
   "himalaya.RichContent",
   // Rich content editor — RFC 0063 §6

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/sdui.mjs

@@ -7548,6 +7548,20 @@ var screenDescriptorSchema = {
             trigger: { type: "string", enum: ["on_change", "on_appear", "both", "none"] }
           }
         },
+        // RFC 0065 §5 — shape clipping (core.proto Modifiers 76–77). A STRING, not an enum:
+        // RFC 0065 constraint 1 — an unknown kind coalesces to "no shape clip" on every arm,
+        // so a newer kind must not fail validation on an older toolchain.
+        clipShape: { type: "string" },
+        clipCornerRadii: {
+          type: "object",
+          additionalProperties: false,
+          properties: {
+            topLeading: { type: "integer", minimum: 0 },
+            topTrailing: { type: "integer", minimum: 0 },
+            bottomLeading: { type: "integer", minimum: 0 },
+            bottomTrailing: { type: "integer", minimum: 0 }
+          }
+        },
         // RFC 0069 — recurring, finite, transform-only motion on a decorative node. `kind`
         // is an open string: an unknown kind renders no motion, so an older validator must
         // not reject a newer one.
@@ -8780,6 +8794,17 @@ function chart(props, opts) {
 function donutChart(props, opts) {
   return { id: opts?.id ?? auto("donut_chart"), body: { package: "himalaya", type: "DonutChart", props } };
 }
+function shape(props, opts) {
+  const { fill, stroke, ...rest } = props;
+  const wire = { ...rest };
+  if (fill != null) wire.fill = { token: fill };
+  if (stroke != null) {
+    const { color, ...s } = stroke;
+    wire.stroke = color != null ? { ...s, color: { token: color } } : s;
+  }
+  const node = { id: opts?.id ?? auto("shape"), body: { package: "himalaya", type: "Shape", props: wire } };
+  return opts?.modifiers ? withModifiers(node, opts.modifiers) : node;
+}
 function legend(props, opts) {
   return { id: opts?.id ?? auto("legend"), body: { package: "himalaya", type: "Legend", props } };
 }
@@ -9396,6 +9421,7 @@ export {
   section,
   segmentedControl,
   selectionControl,
+  shape,
   skRect,
   skeleton,
   slider,