@wix/himalaya-cli 0.826.0 → 0.827.0

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

@@ -212,16 +212,100 @@ export declare function icon(name: string, opts?: {
     size?: number;
     tint?: string;
 }): Component;
+/** One named series of a multi-series {@link chart}. */
+export interface ChartSeriesShape {
+    label?: string;
+    values?: number[];
+    /** `$service:` ONLY — a `$item.` placeholder is stringified to "" by both
+     *  native per-row substituters, so it renders EMPTY on iOS and Android while
+     *  resolving on web. Enforced by the descriptor validator. */
+    valuesPath?: string;
+    color?: string;
+    kind?: "line" | "area" | "bar";
+    /** Omit for the auto solid → dashed → dotted cycle by series index. */
+    stroke?: "solid" | "dashed" | "dotted";
+}
 /** Compact trend chart (sparkline) — line / area / bar. Tier-5: pass
  *  `valuesPath` (a `$service:` path to a worker-state number[]) for live data;
  *  `values` is a static fallback. Resolves to a native Canvas/Path on both
- *  platforms — no charting dependency. */
+ *  platforms — no charting dependency.
+ *
+ *  RFC 0057: pass `series` for a multi-series chart. Every series then shares ONE
+ *  Y scale, which is the only way to draw a comparison overlay honestly — two
+ *  stacked single-series charts normalise over their own ranges independently.
+ *  `series` empty/absent ⇒ exactly the single-series behaviour above. */
 export declare function chart(props: {
     valuesPath?: string;
     values?: number[];
     kind?: "line" | "area" | "bar";
     color?: string;
     height?: number;
+    series?: ChartSeriesShape[];
+}, opts?: {
+    id?: string;
+}): Component;
+/** RFC 0057 — a proportional breakdown (ring, or a solid pie at `thickness: 0`).
+ *  Slice `value`s are RAW magnitudes; the renderer computes each share, because a
+ *  renderer handed percentages that do not sum to 100 cannot draw them honestly. */
+export declare function donutChart(props: {
+    slices?: Array<{
+        label?: string;
+        value?: number;
+        color?: string;
+    }>;
+    /** `$service:` ONLY (array-valued — see {@link ChartSeriesShape.valuesPath}). */
+    slicesPath?: string;
+    size?: number;
+    thickness?: number;
+    centerTitle?: string;
+    centerSubtitle?: string;
+    color?: string;
+}, opts?: {
+    id?: string;
+}): 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. */
+export declare function legend(props: {
+    items?: Array<{
+        label?: string;
+        color?: string;
+        value?: string;
+        marker?: "dot" | "line" | "dashed" | "square";
+    }>;
+    /** `$service:` ONLY. */
+    itemsPath?: string;
+    orientation?: "horizontal" | "vertical";
+}, opts?: {
+    id?: string;
+}): Component;
+/** RFC 0057 — dimension-by-measure rows. Presentational: no row-tap action.
+ *  Literal `rows` are POSITIONAL (declared column order); a bound `rowsPath`
+ *  resolves to objects keyed by `column.key` (arrays are tolerated too). */
+export declare function dataTable(props: {
+    columns?: Array<{
+        key?: string;
+        title?: string;
+        align?: "leading" | "center" | "trailing";
+        weight?: number;
+    }>;
+    rows?: Array<{
+        id?: string;
+        cells?: string[];
+    }>;
+    /** `$service:` ONLY. */
+    rowsPath?: string;
+    /** Not `showHeader` — the proto bool defaults to false, so the affirmative
+     *  spelling would default a table to headerless. */
+    hideHeader?: boolean;
+    totals?: {
+        id?: string;
+        cells?: string[];
+    };
+    /** `$service:` ONLY. */
+    totalsPath?: string;
+    maxRows?: number;
+    zebra?: boolean;
 }, opts?: {
     id?: string;
 }): Component;

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

@@ -1243,6 +1243,128 @@ export interface ChartProps {
     color?: TokenName;
     /** chart height in pt/dp (default 120) */
     height?: number;
+    /**
+     * RFC 0057 — multi-series. EMPTY (or absent) ⇒ this component behaves exactly
+     * as it did before the field existed. NON-EMPTY ⇒ `values`/`valuesPath` above
+     * are ignored and the series list is the data. All series share ONE Y scale,
+     * which is the whole point: two stacked single-series Charts normalize over
+     * their own ranges independently and draw a comparison that inverts whenever
+     * the smaller series has the larger internal range.
+     */
+    series?: ChartSeries[];
+}
+/** One named series inside a multi-series {@link ChartProps}. */
+export interface ChartSeries {
+    /** legend / accessibility label */
+    label?: string;
+    values?: number[];
+    /**
+     * `$service:` binding → number[] (overrides `values`).
+     *
+     * `$service:` only — a `$item.` placeholder is stringified to "" by both native
+     * per-row substituters, so it would render the chart EMPTY on iOS and Android
+     * while resolving on web. Enforced, not merely documented: see
+     * SERVICE_ONLY_BINDING_PROPS.
+     */
+    valuesPath?: string;
+    /** color token; absent ⇒ ChartProps.color */
+    color?: TokenName;
+    /** "line" | "area" | "bar"; absent ⇒ ChartProps.kind */
+    kind?: string;
+    /**
+     * "solid" | "dashed" | "dotted". Absent ⇒ AUTO: that cycle indexed by the
+     * series' position, so a two-series chart is solid-against-dashed with no
+     * author effort. Identity is carried by STROKE rather than color by default
+     * because color-only differentiation fails for color-blind viewers and in
+     * monochrome captures — and because the token registry ships no categorical
+     * series ramp to cycle (an undefined color token renders fully transparent
+     * on iOS).
+     */
+    stroke?: string;
+}
+/** One wedge of a {@link DonutChartProps}. */
+export interface DonutSlice {
+    label?: string;
+    /** RAW magnitude, never a pre-computed percentage — the renderer computes the share. */
+    value?: number;
+    /** color token; absent ⇒ derived from DonutChartProps.color at descending opacity */
+    color?: TokenName;
+}
+/**
+ * RFC 0057 — a proportional breakdown: a ring, or a solid pie at `thickness: 0`.
+ */
+export interface DonutChartProps {
+    slices?: DonutSlice[];
+    /** `$service:` ONLY → [{label, value, color}] (array-valued; see ChartSeries.valuesPath). */
+    slicesPath?: string;
+    /** diameter in pt/dp (default 160) */
+    size?: number;
+    /** ring thickness in pt/dp (default 28); 0 ⇒ a solid pie */
+    thickness?: number;
+    centerTitle?: string;
+    centerSubtitle?: string;
+    /** base token for the derived opacity ramp (default "accentPrimary") */
+    color?: TokenName;
+}
+/** One row of a {@link LegendProps}. */
+export interface LegendItem {
+    label?: string;
+    color?: TokenName;
+    /** optional trailing value, e.g. "42%" — a FORMATTED string, not a number */
+    value?: string;
+    /**
+     * "dot" (default) | "line" | "dashed" | "square". "line"/"dashed" exist so a
+     * legend can label a multi-series Chart's stroke patterns.
+     */
+    marker?: string;
+}
+/** RFC 0057 — labels for a chart or a table. */
+export interface LegendProps {
+    items?: LegendItem[];
+    /** `$service:` ONLY → [{label, color, value, marker}]. */
+    itemsPath?: string;
+    /** "horizontal" (default, wraps) | "vertical" */
+    orientation?: string;
+}
+/** One declared column of a {@link DataTableProps}. */
+export interface DataTableColumn {
+    /** field name read from a BOUND row object */
+    key?: string;
+    title?: string;
+    /** "leading" (default) | "center" | "trailing" */
+    align?: string;
+    /** flex weight (default 1) */
+    weight?: number;
+}
+/** One row of a {@link DataTableProps}. */
+export interface DataTableRow {
+    /** stable row id (invariant 27) */
+    id?: string;
+    /** POSITIONAL, in declared column order. Strings, already formatted. */
+    cells?: string[];
+}
+/**
+ * RFC 0057 — dimension-by-measure rows. Presentational: no row-tap action.
+ */
+export interface DataTableProps {
+    columns?: DataTableColumn[];
+    rows?: DataTableRow[];
+    /**
+     * `$service:` ONLY → an array of OBJECTS keyed by `column.key`. An array of
+     * arrays (positional, like the literal `rows`) is also accepted.
+     */
+    rowsPath?: string;
+    /**
+     * `hideHeader`, not `showHeader`: the proto field is a bool that defaults to
+     * false, so the affirmative spelling would default a table to headerless.
+     */
+    hideHeader?: boolean;
+    totals?: DataTableRow;
+    /** `$service:` ONLY → one row object. */
+    totalsPath?: string;
+    /** 0 / absent ⇒ unbounded */
+    maxRows?: number;
+    zebra?: boolean;
 }
 /**
  * A recorded-audio message bubble — waveform, play/pause, scrubber, duration and
@@ -2037,6 +2159,18 @@ export type CoreComponentBody = {
     package: "himalaya";
     type: "Chart";
     props: ChartProps;
+} | {
+    package: "himalaya";
+    type: "DonutChart";
+    props: DonutChartProps;
+} | {
+    package: "himalaya";
+    type: "Legend";
+    props: LegendProps;
+} | {
+    package: "himalaya";
+    type: "DataTable";
+    props: DataTableProps;
 } | {
     package: "himalaya";
     type: "VoiceNote";

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

@@ -8523,6 +8523,10 @@ var CORE_COMPONENTS = /* @__PURE__ */ new Set([
   "himalaya.Gauge",
   "himalaya.Rating",
   "himalaya.Chart",
+  // Analytics data-viz — RFC 0057
+  "himalaya.DonutChart",
+  "himalaya.Legend",
+  "himalaya.DataTable",
   // Recorded-audio bubble — messenger design G4
   "himalaya.VoiceNote",
   "himalaya.Marquee",

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

@@ -8017,6 +8017,15 @@ function icon(name, opts) {
 function chart(props, opts) {
   return { id: opts?.id ?? auto("chart"), body: { package: "himalaya", type: "Chart", props } };
 }
+function donutChart(props, opts) {
+  return { id: opts?.id ?? auto("donut_chart"), body: { package: "himalaya", type: "DonutChart", props } };
+}
+function legend(props, opts) {
+  return { id: opts?.id ?? auto("legend"), body: { package: "himalaya", type: "Legend", props } };
+}
+function dataTable(props, opts) {
+  return { id: opts?.id ?? auto("data_table"), body: { package: "himalaya", type: "DataTable", props } };
+}
 function spacer(opts) {
   const props = {};
   if (opts?.value !== void 0) props.value = opts.value;
@@ -8489,11 +8498,13 @@ export {
   chipsInput,
   collapsingHeader,
   colorPicker,
+  dataTable,
   datePicker,
   dateStrip,
   deriveAppMeta,
   disclosureGroup,
   divider,
+  donutChart,
   emptyBlock,
   emptyState,
   fab,
@@ -8511,6 +8522,7 @@ export {
   label,
   labeledContent,
   lazyList,
+  legend,
   listItem,
   lottie,
   map,