@reforma/components 0.1.5 → 0.2.0

package/dist/openui/functions/data.js

@@ -0,0 +1,308 @@
+import { defineFunction as w } from "@openuidev/react-lang";
+import { parseDate as _, isoDay as S } from "./dates.js";
+import { groups as k, aggregate as b, agg as x, toNum as v, read as M, list as g, MAX_ITEMS as F, finite as q, numbers as A } from "./shared.js";
+import { object as d, string as f, array as C, record as z, union as P, enum as E, any as U, number as c } from "../../node_modules/zod/v4/classic/schemas.js";
+const K = () => C(d({
+  key: P([f(), c()]),
+  value: c()
+})), N = (t) => t.filter((e) => typeof e == "number" && Number.isFinite(e)), Y = (t, e) => e ?? (t ? "sum" : "count");
+function O(t, e, n) {
+  return t.map((o, a) => e ? {
+    ...o,
+    [e]: n[a]
+  } : n[a]);
+}
+const G = w({
+  name: "GroupBy",
+  description: 'One row per distinct key, in first-seen order; value is agg of field (default "sum"), or the row count without a field',
+  params: d({
+    rows: g(),
+    key: f(),
+    field: f().optional(),
+    agg: x().optional()
+  }),
+  returns: K(),
+  fn: ({
+    rows: t,
+    key: e,
+    field: n,
+    agg: o
+  }) => [...k(t, e)].map(([a, r]) => ({
+    key: a,
+    value: b(r, n, Y(n, o))
+  }))
+}), H = w({
+  name: "Pivot",
+  description: "One row per rowKey value with a column per colKey value holding agg of field, for stacked or grouped charts",
+  params: d({
+    rows: g(),
+    rowKey: f(),
+    colKey: f(),
+    field: f().optional(),
+    agg: x().optional()
+  }),
+  returns: C(z(f(), P([f(), c()]))),
+  fn: ({
+    rows: t,
+    rowKey: e,
+    colKey: n,
+    field: o,
+    agg: a
+  }) => {
+    const r = [...k(t, n).keys()].map(String);
+    return [...k(t, e)].map(([s, i]) => {
+      const l = {
+        key: s
+      };
+      for (const m of r) l[m] = 0;
+      for (const [m, p] of k(i, n)) l[String(m)] = b(p, o, Y(o, a));
+      return l;
+    });
+  }
+}), R = w({
+  name: "Top",
+  description: 'The n rows with the largest field ("asc": the smallest)',
+  params: d({
+    rows: g(),
+    field: f(),
+    n: c(),
+    direction: E(["desc", "asc"]).optional()
+  }),
+  returns: g(),
+  fn: ({
+    rows: t,
+    field: e,
+    n,
+    direction: o = "desc"
+  }) => {
+    const a = o === "asc" ? 1 : -1;
+    return t.map((s, i) => ({
+      row: s,
+      i,
+      v: v(M(s, e))
+    })).sort((s, i) => s.v === null || i.v === null ? s.v === i.v ? s.i - i.i : s.v === null ? 1 : -1 : (s.v - i.v) * a || s.i - i.i).slice(0, Math.max(0, Math.trunc(n))).map((s) => s.row);
+  }
+});
+function B(t, e) {
+  const n = v(t), o = v(e);
+  if (n !== null && o !== null) return n - o;
+  const a = String(t), r = String(e);
+  return a < r ? -1 : a > r ? 1 : 0;
+}
+const j = w({
+  name: "Between",
+  description: 'Rows whose field is from min to max, both included; compares numbers, or text such as "YYYY-MM-DD" dates. Leave min or max null for an open end',
+  params: d({
+    rows: g(),
+    field: f(),
+    min: U().optional(),
+    max: U().optional()
+  }),
+  returns: g(),
+  fn: ({
+    rows: t,
+    field: e,
+    min: n,
+    max: o
+  }) => t.filter((a) => {
+    const r = M(a, e);
+    return r == null ? !1 : (n == null || B(r, n) >= 0) && (o == null || B(r, o) <= 0);
+  })
+});
+function I(t, e) {
+  if (e === "day") return t;
+  if (e === "week") return t - (new Date(t * 864e5).getUTCDay() + 6) % 7;
+  const n = new Date(t * 864e5);
+  return Date.UTC(n.getUTCFullYear(), n.getUTCMonth(), 1) / 864e5;
+}
+function L(t, e) {
+  if (e === "day") return t + 1;
+  if (e === "week") return t + 7;
+  const n = new Date(t * 864e5);
+  return Date.UTC(n.getUTCFullYear(), n.getUTCMonth() + 1, 1) / 864e5;
+}
+const V = w({
+  name: "Bucket",
+  description: 'Rows per day, week (from Monday) or month of dateField, in date order, empty periods 0 for sum and count; key is "YYYY-MM-DD", or "YYYY-MM" for months',
+  params: d({
+    rows: g(),
+    dateField: f(),
+    unit: E(["day", "week", "month"]),
+    field: f().optional(),
+    agg: x().optional()
+  }),
+  returns: K(),
+  fn: ({
+    rows: t,
+    dateField: e,
+    unit: n,
+    field: o,
+    agg: a
+  }) => {
+    const r = /* @__PURE__ */ new Map();
+    for (const u of t) {
+      const h = M(u, e);
+      if (typeof h != "string" && typeof h != "number") continue;
+      let y;
+      try {
+        y = _(h).day;
+      } catch {
+        continue;
+      }
+      const D = I(y, n), T = r.get(D);
+      T ? T.push(u) : r.set(D, [u]);
+    }
+    if (!r.size) return [];
+    const s = Y(o, a), i = s === "sum" || s === "count", l = (u) => n === "month" ? S(u).slice(0, 7) : S(u), m = [...r.keys()].sort((u, h) => u - h), p = [];
+    for (let u = m[0]; u <= m[m.length - 1]; u = L(u, n)) {
+      const h = r.get(u);
+      if (h ? p.push({
+        key: l(u),
+        value: b(h, o, s)
+      }) : i && p.push({
+        key: l(u),
+        value: 0
+      }), p.length > F) throw new Error(`more than ${F} periods`);
+    }
+    return p;
+  }
+}), X = w({
+  name: "Cumulative",
+  description: 'Copy of the rows with field replaced by its running total (field "" for a list of numbers)',
+  params: d({
+    rows: g(),
+    field: f()
+  }),
+  returns: g(),
+  fn: ({
+    rows: t,
+    field: e
+  }) => {
+    let n = 0;
+    return O(t, e, t.map((o) => n += v(M(o, e)) ?? 0));
+  }
+}), $ = w({
+  name: "MovingAvg",
+  description: 'Copy of the rows with field replaced by the average of its last window values (field "" for a list of numbers)',
+  params: d({
+    rows: g(),
+    field: f(),
+    window: c()
+  }),
+  returns: g(),
+  fn: ({
+    rows: t,
+    field: e,
+    window: n
+  }) => {
+    const o = Math.trunc(n);
+    if (o < 1) throw new Error("window must be at least 1");
+    const a = t.map((s) => v(M(s, e)) ?? 0), r = a.map((s, i) => {
+      const l = a.slice(Math.max(0, i - o + 1), i + 1);
+      return l.reduce((m, p) => m + p, 0) / l.length;
+    });
+    return O(t, e, r);
+  }
+}), J = w({
+  name: "Change",
+  description: "Percent change from previous to current, e.g. @Change(120, 100) is 20; null when previous is 0",
+  params: d({
+    current: c(),
+    previous: c()
+  }),
+  returns: c().nullable(),
+  // No previous value is normal while data loads, so it is null without an error
+  fn: ({
+    current: t,
+    previous: e
+  }) => e === 0 ? null : q((t - e) / Math.abs(e) * 100)
+}), Q = w({
+  name: "Histogram",
+  description: "Counts numbers into equal-width bins (value is the count); min and max fix the range, default the data's",
+  params: d({
+    values: A(),
+    bins: c(),
+    min: c().optional(),
+    max: c().optional()
+  }),
+  returns: C(d({
+    key: f(),
+    value: c(),
+    start: c(),
+    end: c()
+  })),
+  fn: ({
+    values: t,
+    bins: e,
+    min: n,
+    max: o
+  }) => {
+    const a = N(t), r = Math.trunc(e);
+    if (r < 1 || r > 500) throw new Error("bins must be from 1 to 500");
+    const s = n ?? (a.length ? Math.min(...a) : 0);
+    let i = o ?? (a.length ? Math.max(...a) : 1);
+    i <= s && (i = s + 1);
+    const l = (i - s) / r, m = Math.max(0, 1 - Math.floor(Math.log10(l))), p = new Array(r).fill(0);
+    for (const u of a)
+      u < s || u > i || p[Math.min(r - 1, Math.floor((u - s) / l))]++;
+    return p.map((u, h) => {
+      const y = s + h * l;
+      return {
+        key: String(Number(y.toFixed(m))),
+        value: u,
+        start: y,
+        end: y + l
+      };
+    });
+  }
+}), W = w({
+  name: "Stats",
+  description: "Summary of numbers, all zeros for an empty list",
+  params: d({
+    values: A()
+  }),
+  returns: d({
+    count: c(),
+    min: c(),
+    max: c(),
+    mean: c(),
+    median: c(),
+    stdev: c()
+  }),
+  fn: ({
+    values: t
+  }) => {
+    const e = N(t), n = e.length;
+    if (!n) return {
+      count: 0,
+      min: 0,
+      max: 0,
+      mean: 0,
+      median: 0,
+      stdev: 0
+    };
+    const o = [...e].sort((l, m) => l - m), a = e.reduce((l, m) => l + m, 0) / n, r = Math.floor(n / 2), s = n % 2 ? o[r] : (o[r - 1] + o[r]) / 2, i = Math.sqrt(e.reduce((l, m) => l + (m - a) ** 2, 0) / n);
+    return {
+      count: n,
+      min: o[0],
+      max: o[n - 1],
+      mean: a,
+      median: s,
+      stdev: i
+    };
+  }
+}), oe = [G, H, R, j, V, X, $, J, Q, W];
+export {
+  j as Between,
+  V as Bucket,
+  J as Change,
+  X as Cumulative,
+  G as GroupBy,
+  Q as Histogram,
+  $ as MovingAvg,
+  H as Pivot,
+  W as Stats,
+  R as Top,
+  oe as dataFunctions
+};
+//# sourceMappingURL=data.js.map

package/dist/openui/functions/data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.js","sources":["../../../src/openui/functions/data.ts"],"sourcesContent":["import { defineFunction } from \"@openuidev/react-lang\";\nimport { z } from \"zod/v4\";\nimport { isoDay, parseDate } from \"./dates\";\nimport { agg, aggregate, finite, groups, list, MAX_ITEMS, numbers, read, toNum, type Agg } from \"./shared\";\n\nconst keyValue = () => z.array(z.object({ key: z.union([z.string(), z.number()]), value: z.number() }));\n// Untyped arrays (a pluck over rows that lack the field) can still hold nulls\nconst finiteOnly = (values: unknown[]) => values.filter((v): v is number => typeof v === \"number\" && Number.isFinite(v));\nconst defaultAgg = (field: string | undefined, how: Agg | undefined): Agg => how ?? (field ? \"sum\" : \"count\");\n\n/** Copy of each row with `field` replaced; field \"\" maps a list of numbers. */\nfunction mapField(rows: unknown[], field: string, values: number[]): unknown[] {\n  return rows.map((row, i) => (field ? { ...(row as object), [field]: values[i] } : values[i]));\n}\n\nexport const GroupBy = defineFunction({\n  name: \"GroupBy\",\n  description:\n    'One row per distinct key, in first-seen order; value is agg of field (default \"sum\"), or the row count without a field',\n  params: z.object({ rows: list(), key: z.string(), field: z.string().optional(), agg: agg().optional() }),\n  returns: keyValue(),\n  fn: ({ rows, key, field, agg: how }) =>\n    [...groups(rows, key)].map(([k, members]) => ({ key: k, value: aggregate(members, field, defaultAgg(field, how)) })),\n});\n\nexport const Pivot = defineFunction({\n  name: \"Pivot\",\n  description: \"One row per rowKey value with a column per colKey value holding agg of field, for stacked or grouped charts\",\n  params: z.object({\n    rows: list(),\n    rowKey: z.string(),\n    colKey: z.string(),\n    field: z.string().optional(),\n    agg: agg().optional(),\n  }),\n  returns: z.array(z.record(z.string(), z.union([z.string(), z.number()]))),\n  fn: ({ rows, rowKey, colKey, field, agg: how }) => {\n    const cols = [...groups(rows, colKey).keys()].map(String);\n    return [...groups(rows, rowKey)].map(([k, members]) => {\n      const out: Record<string, string | number> = { key: k };\n      for (const col of cols) out[col] = 0;\n      for (const [c, cell] of groups(members, colKey)) out[String(c)] = aggregate(cell, field, defaultAgg(field, how));\n      return out;\n    });\n  },\n});\n\nexport const Top = defineFunction({\n  name: \"Top\",\n  description: 'The n rows with the largest field (\"asc\": the smallest)',\n  params: z.object({ rows: list(), field: z.string(), n: z.number(), direction: z.enum([\"desc\", \"asc\"]).optional() }),\n  returns: list(),\n  fn: ({ rows, field, n, direction = \"desc\" }) => {\n    const sign = direction === \"asc\" ? 1 : -1;\n    const ranked = rows\n      .map((row, i) => ({ row, i, v: toNum(read(row, field)) }))\n      .sort((a, b) => {\n        if (a.v === null || b.v === null) return a.v === b.v ? a.i - b.i : a.v === null ? 1 : -1;\n        return (a.v - b.v) * sign || a.i - b.i;\n      });\n    return ranked.slice(0, Math.max(0, Math.trunc(n))).map((r) => r.row);\n  },\n});\n\n/** Orders two field values: numbers by value, anything else (such as \"YYYY-MM-DD\") as text. */\nfunction compare(a: unknown, b: unknown): number {\n  const x = toNum(a);\n  const y = toNum(b);\n  if (x !== null && y !== null) return x - y;\n  const s = String(a);\n  const t = String(b);\n  return s < t ? -1 : s > t ? 1 : 0;\n}\n\nexport const Between = defineFunction({\n  name: \"Between\",\n  description:\n    'Rows whose field is from min to max, both included; compares numbers, or text such as \"YYYY-MM-DD\" dates. Leave min or max null for an open end',\n  params: z.object({ rows: list(), field: z.string(), min: z.any().optional(), max: z.any().optional() }),\n  returns: list(),\n  fn: ({ rows, field, min, max }) =>\n    rows.filter((row) => {\n      const v = read(row, field);\n      if (v == null) return false;\n      return (min == null || compare(v, min) >= 0) && (max == null || compare(v, max) <= 0);\n    }),\n});\n\nfunction periodStart(day: number, unit: \"day\" | \"week\" | \"month\"): number {\n  if (unit === \"day\") return day;\n  if (unit === \"week\") return day - ((new Date(day * 86_400_000).getUTCDay() + 6) % 7); // Monday\n  const d = new Date(day * 86_400_000);\n  return Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), 1) / 86_400_000;\n}\n\nfunction nextPeriod(start: number, unit: \"day\" | \"week\" | \"month\"): number {\n  if (unit === \"day\") return start + 1;\n  if (unit === \"week\") return start + 7;\n  const d = new Date(start * 86_400_000);\n  return Date.UTC(d.getUTCFullYear(), d.getUTCMonth() + 1, 1) / 86_400_000;\n}\n\nexport const Bucket = defineFunction({\n  name: \"Bucket\",\n  description:\n    'Rows per day, week (from Monday) or month of dateField, in date order, empty periods 0 for sum and count; key is \"YYYY-MM-DD\", or \"YYYY-MM\" for months',\n  params: z.object({\n    rows: list(),\n    dateField: z.string(),\n    unit: z.enum([\"day\", \"week\", \"month\"]),\n    field: z.string().optional(),\n    agg: agg().optional(),\n  }),\n  returns: keyValue(),\n  fn: ({ rows, dateField, unit, field, agg: how }) => {\n    const byPeriod = new Map<number, unknown[]>();\n    for (const row of rows) {\n      const raw = read(row, dateField);\n      if (typeof raw !== \"string\" && typeof raw !== \"number\") continue;\n      let day: number;\n      try {\n        day = parseDate(raw).day;\n      } catch {\n        continue;\n      }\n      const start = periodStart(day, unit);\n      const bucket = byPeriod.get(start);\n      if (bucket) bucket.push(row);\n      else byPeriod.set(start, [row]);\n    }\n    if (!byPeriod.size) return [];\n    const mode = defaultAgg(field, how);\n    const fill = mode === \"sum\" || mode === \"count\";\n    const label = (start: number) => (unit === \"month\" ? isoDay(start).slice(0, 7) : isoDay(start));\n    const starts = [...byPeriod.keys()].sort((a, b) => a - b);\n    const out: { key: string; value: number }[] = [];\n    for (let s = starts[0]!; s <= starts[starts.length - 1]!; s = nextPeriod(s, unit)) {\n      const members = byPeriod.get(s);\n      if (members) out.push({ key: label(s), value: aggregate(members, field, mode) });\n      else if (fill) out.push({ key: label(s), value: 0 });\n      if (out.length > MAX_ITEMS) throw new Error(`more than ${MAX_ITEMS} periods`);\n    }\n    return out;\n  },\n});\n\nexport const Cumulative = defineFunction({\n  name: \"Cumulative\",\n  description: 'Copy of the rows with field replaced by its running total (field \"\" for a list of numbers)',\n  params: z.object({ rows: list(), field: z.string() }),\n  returns: list(),\n  fn: ({ rows, field }) => {\n    let total = 0;\n    return mapField(rows, field, rows.map((row) => (total += toNum(read(row, field)) ?? 0)));\n  },\n});\n\nexport const MovingAvg = defineFunction({\n  name: \"MovingAvg\",\n  description: 'Copy of the rows with field replaced by the average of its last window values (field \"\" for a list of numbers)',\n  params: z.object({ rows: list(), field: z.string(), window: z.number() }),\n  returns: list(),\n  fn: ({ rows, field, window }) => {\n    const w = Math.trunc(window);\n    if (w < 1) throw new Error(\"window must be at least 1\");\n    const values = rows.map((row) => toNum(read(row, field)) ?? 0);\n    const averages = values.map((_, i) => {\n      const span = values.slice(Math.max(0, i - w + 1), i + 1);\n      return span.reduce((a, b) => a + b, 0) / span.length;\n    });\n    return mapField(rows, field, averages);\n  },\n});\n\nexport const Change = defineFunction({\n  name: \"Change\",\n  description: \"Percent change from previous to current, e.g. @Change(120, 100) is 20; null when previous is 0\",\n  params: z.object({ current: z.number(), previous: z.number() }),\n  returns: z.number().nullable(),\n  // No previous value is normal while data loads, so it is null without an error\n  fn: ({ current, previous }) => (previous === 0 ? null : finite(((current - previous) / Math.abs(previous)) * 100)),\n});\n\nexport const Histogram = defineFunction({\n  name: \"Histogram\",\n  description:\n    \"Counts numbers into equal-width bins (value is the count); min and max fix the range, default the data's\",\n  params: z.object({ values: numbers(), bins: z.number(), min: z.number().optional(), max: z.number().optional() }),\n  returns: z.array(z.object({ key: z.string(), value: z.number(), start: z.number(), end: z.number() })),\n  fn: ({ values: raw, bins, min, max }) => {\n    const values = finiteOnly(raw);\n    const n = Math.trunc(bins);\n    if (n < 1 || n > 500) throw new Error(\"bins must be from 1 to 500\");\n    const lo = min ?? (values.length ? Math.min(...values) : 0);\n    let hi = max ?? (values.length ? Math.max(...values) : 1);\n    if (hi <= lo) hi = lo + 1;\n    const width = (hi - lo) / n;\n    const decimals = Math.max(0, 1 - Math.floor(Math.log10(width)));\n    const counts = new Array<number>(n).fill(0);\n    for (const v of values) {\n      if (v < lo || v > hi) continue;\n      counts[Math.min(n - 1, Math.floor((v - lo) / width))]!++;\n    }\n    return counts.map((value, i) => {\n      const start = lo + i * width;\n      return { key: String(Number(start.toFixed(decimals))), value, start, end: start + width };\n    });\n  },\n});\n\nexport const Stats = defineFunction({\n  name: \"Stats\",\n  description: \"Summary of numbers, all zeros for an empty list\",\n  params: z.object({ values: numbers() }),\n  returns: z.object({\n    count: z.number(),\n    min: z.number(),\n    max: z.number(),\n    mean: z.number(),\n    median: z.number(),\n    stdev: z.number(),\n  }),\n  fn: ({ values: raw }) => {\n    const values = finiteOnly(raw);\n    const count = values.length;\n    if (!count) return { count: 0, min: 0, max: 0, mean: 0, median: 0, stdev: 0 };\n    const sorted = [...values].sort((a, b) => a - b);\n    const mean = values.reduce((a, b) => a + b, 0) / count;\n    const mid = Math.floor(count / 2);\n    const median = count % 2 ? sorted[mid]! : (sorted[mid - 1]! + sorted[mid]!) / 2;\n    const stdev = Math.sqrt(values.reduce((a, v) => a + (v - mean) ** 2, 0) / count);\n    return { count, min: sorted[0]!, max: sorted[count - 1]!, mean, median, stdev };\n  },\n});\n\nexport const dataFunctions = [GroupBy, Pivot, Top, Between, Bucket, Cumulative, MovingAvg, Change, Histogram, Stats];\n"],"names":["keyValue","z.array","z.object","z.union","z.string","z.number","finiteOnly","values","v","defaultAgg","field","how","mapField","rows","row","i","GroupBy","defineFunction","list","agg","key","groups","k","members","aggregate","Pivot","z.record","rowKey","colKey","cols","out","col","c","cell","Top","z.enum","direction","sign","toNum","read","a","b","r","compare","x","y","s","t","Between","z.any","min","max","periodStart","day","unit","d","nextPeriod","start","Bucket","dateField","byPeriod","raw","parseDate","bucket","mode","fill","label","isoDay","starts","MAX_ITEMS","Cumulative","total","MovingAvg","window","w","averages","_","span","Change","current","previous","finite","Histogram","numbers","bins","n","lo","hi","width","decimals","counts","value","Stats","count","sorted","mean","mid","median","stdev","dataFunctions"],"mappings":"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"}

package/dist/openui/functions/dates.d.ts

@@ -0,0 +1,57 @@
+import { z } from "zod/v4";
+/**
+ * A date as a calendar day (days since 1970-01-01) plus, for a timestamp, the
+ * instant. "YYYY-MM-DD" is a calendar date with no time zone; a timestamp or an
+ * ISO date-time is read in the viewer's time zone.
+ */
+type Parsed = {
+    day: number;
+    instant: Date | null;
+};
+export declare function parseDate(value: string | number): Parsed;
+export declare function isoDay(day: number): string;
+export declare const Now: import("@openuidev/lang-core").DefinedFunction<z.ZodObject<{}, z.core.$strip>, z.ZodString>;
+export declare const FormatDate: import("@openuidev/lang-core").DefinedFunction<z.ZodObject<{
+    date: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    style: z.ZodOptional<z.ZodEnum<{
+        date: "date";
+        datetime: "datetime";
+        iso: "iso";
+        long: "long";
+        month: "month";
+        short: "short";
+        time: "time";
+        weekday: "weekday";
+    }>>;
+}, z.core.$strip>, z.ZodString>;
+export declare const AddDays: import("@openuidev/lang-core").DefinedFunction<z.ZodObject<{
+    date: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    days: z.ZodNumber;
+}, z.core.$strip>, z.ZodString>;
+export declare const DaysBetween: import("@openuidev/lang-core").DefinedFunction<z.ZodObject<{
+    from: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    to: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+}, z.core.$strip>, z.ZodNumber>;
+export declare const Today: import("@openuidev/lang-core").DefinedFunction<z.ZodObject<{}, z.core.$strip>, z.ZodString>;
+export declare const AddMonths: import("@openuidev/lang-core").DefinedFunction<z.ZodObject<{
+    date: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    months: z.ZodNumber;
+}, z.core.$strip>, z.ZodString>;
+export declare const MonthsBetween: import("@openuidev/lang-core").DefinedFunction<z.ZodObject<{
+    from: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    to: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+}, z.core.$strip>, z.ZodNumber>;
+export declare const StartOf: import("@openuidev/lang-core").DefinedFunction<z.ZodObject<{
+    date: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    unit: z.ZodEnum<{
+        month: "month";
+        week: "week";
+        year: "year";
+    }>;
+}, z.core.$strip>, z.ZodString>;
+export declare const dateFunctions: (import("@openuidev/lang-core").DefinedFunction<z.ZodObject<{}, z.core.$strip>, z.ZodString> | import("@openuidev/lang-core").DefinedFunction<z.ZodObject<{
+    from: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    to: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+}, z.core.$strip>, z.ZodNumber>)[];
+export {};
+//# sourceMappingURL=dates.d.ts.map

package/dist/openui/functions/dates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.d.ts","sourceRoot":"","sources":["../../../src/openui/functions/dates.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAM3B;;;;GAIG;AACH,KAAK,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,IAAI,GAAG,IAAI,CAAA;CAAE,CAAC;AAEpD,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAcxD;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1C;AAYD,eAAO,MAAM,GAAG,6FAMd,CAAC;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;;+BAgBrB,CAAC;AAEH,eAAO,MAAM,OAAO;;;+BAMlB,CAAC;AAEH,eAAO,MAAM,WAAW;;;+BAMtB,CAAC;AAEH,eAAO,MAAM,KAAK,6FAMhB,CAAC;AAQH,eAAO,MAAM,SAAS;;;+BAWpB,CAAC;AAEH,eAAO,MAAM,aAAa;;;+BAaxB,CAAC;AAEH,eAAO,MAAM,OAAO;;;;;;;+BAWlB,CAAC;AAEH,eAAO,MAAM,aAAa;;;kCAAoF,CAAC"}

package/dist/openui/functions/dates.js

@@ -0,0 +1,184 @@
+import { defineFunction as d } from "@openuidev/react-lang";
+import { date as s } from "./shared.js";
+import { string as u, object as m, enum as p, number as w } from "../../node_modules/zod/v4/classic/schemas.js";
+const i = 864e5, Y = /^(\d{4})-(\d{2})-(\d{2})$/;
+function o(e) {
+  if (typeof e == "string") {
+    const n = Y.exec(e.trim());
+    if (n) {
+      const [a, r, c] = [Number(n[1]), Number(n[2]), Number(n[3])], h = Date.UTC(a, r - 1, c), D = new Date(h);
+      if (D.getUTCMonth() !== r - 1 || D.getUTCDate() !== c) throw new Error(`invalid date "${e}"`);
+      return {
+        day: h / i,
+        instant: null
+      };
+    }
+  }
+  const t = new Date(e);
+  if (Number.isNaN(t.getTime())) throw new Error(`invalid date "${e}"`);
+  return {
+    day: Date.UTC(t.getFullYear(), t.getMonth(), t.getDate()) / i,
+    instant: t
+  };
+}
+function y(e) {
+  return new Date(e * i).toISOString().slice(0, 10);
+}
+const l = {
+  date: {
+    month: "short",
+    day: "numeric",
+    year: "numeric"
+  },
+  short: {
+    month: "short",
+    day: "numeric"
+  },
+  long: {
+    weekday: "long",
+    month: "long",
+    day: "numeric",
+    year: "numeric"
+  },
+  weekday: {
+    weekday: "short"
+  },
+  month: {
+    month: "short",
+    year: "numeric"
+  },
+  time: {
+    hour: "numeric",
+    minute: "2-digit"
+  },
+  datetime: {
+    month: "short",
+    day: "numeric",
+    hour: "numeric",
+    minute: "2-digit"
+  }
+}, M = d({
+  name: "Now",
+  description: "The current date and time as an ISO string",
+  params: m({}),
+  returns: u(),
+  fn: () => (/* @__PURE__ */ new Date()).toISOString()
+}), T = d({
+  name: "FormatDate",
+  description: 'A date as text: "date" Oct 9, 2026 (default), "short" Oct 9, "long" Friday, October 9, 2026, "weekday" Fri, "month" Oct 2026, "time" 9:30 PM, "datetime", "iso" 2026-10-09. Dates are "YYYY-MM-DD", ISO or a timestamp',
+  params: m({
+    date: s(),
+    style: p(["date", "short", "long", "weekday", "month", "time", "datetime", "iso"]).optional()
+  }),
+  returns: u(),
+  fn: ({
+    date: e,
+    style: t = "date"
+  }) => {
+    const {
+      day: n,
+      instant: a
+    } = o(e);
+    return t === "iso" ? y(n) : (a ?? new Date(n * i)).toLocaleString("en-US", {
+      ...l[t],
+      ...a ? {} : {
+        timeZone: "UTC"
+      }
+    });
+  }
+}), C = d({
+  name: "AddDays",
+  description: 'The date days later (negative: earlier), as "YYYY-MM-DD"',
+  params: m({
+    date: s(),
+    days: w()
+  }),
+  returns: u(),
+  fn: ({
+    date: e,
+    days: t
+  }) => y(o(e).day + Math.trunc(t))
+}), U = d({
+  name: "DaysBetween",
+  description: "Calendar days from one date to another (negative if to is earlier)",
+  params: m({
+    from: s(),
+    to: s()
+  }),
+  returns: w(),
+  fn: ({
+    from: e,
+    to: t
+  }) => o(t).day - o(e).day
+}), S = d({
+  name: "Today",
+  description: `Today's date in the viewer's time zone, as "YYYY-MM-DD"`,
+  params: m({}),
+  returns: u(),
+  fn: () => y(o(Date.now()).day)
+});
+function g(e) {
+  const t = new Date(e * i);
+  return [t.getUTCFullYear(), t.getUTCMonth(), t.getUTCDate()];
+}
+const F = d({
+  name: "AddMonths",
+  description: 'The date months later (negative: earlier), kept within the month (Jan 31 + 1 is Feb 28), as "YYYY-MM-DD"; 12 months is a year',
+  params: m({
+    date: s(),
+    months: w()
+  }),
+  returns: u(),
+  fn: ({
+    date: e,
+    months: t
+  }) => {
+    const [n, a, r] = g(o(e).day), c = a + Math.trunc(t), h = new Date(Date.UTC(n, c + 1, 0)).getUTCDate();
+    return y(Date.UTC(n, c, Math.min(r, h)) / i);
+  }
+}), O = d({
+  name: "MonthsBetween",
+  description: "Whole months from one date to another (negative if to is earlier); @Floor(@MonthsBetween(birthday, @Today()) / 12) is an age",
+  params: m({
+    from: s(),
+    to: s()
+  }),
+  returns: w(),
+  fn: ({
+    from: e,
+    to: t
+  }) => {
+    const [n, a, r] = g(o(e).day), [c, h, D] = g(o(t).day);
+    let f = (c - n) * 12 + (h - a);
+    return f > 0 && D < r && (f -= 1), f < 0 && D > r && (f += 1), f;
+  }
+}), k = d({
+  name: "StartOf",
+  description: `First day of the date's "week" (Monday), "month" or "year", as "YYYY-MM-DD"`,
+  params: m({
+    date: s(),
+    unit: p(["week", "month", "year"])
+  }),
+  returns: u(),
+  fn: ({
+    date: e,
+    unit: t
+  }) => {
+    const n = o(e).day, [a, r] = g(n);
+    return y(t === "week" ? n - (new Date(n * i).getUTCDay() + 6) % 7 : Date.UTC(a, t === "month" ? r : 0, 1) / i);
+  }
+}), B = [M, S, T, C, F, U, O, k];
+export {
+  C as AddDays,
+  F as AddMonths,
+  U as DaysBetween,
+  T as FormatDate,
+  O as MonthsBetween,
+  M as Now,
+  k as StartOf,
+  S as Today,
+  B as dateFunctions,
+  y as isoDay,
+  o as parseDate
+};
+//# sourceMappingURL=dates.js.map

package/dist/openui/functions/dates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.js","sources":["../../../src/openui/functions/dates.ts"],"sourcesContent":["import { defineFunction } from \"@openuidev/react-lang\";\nimport { z } from \"zod/v4\";\nimport { date } from \"./shared\";\n\nconst DAY = 86_400_000;\nconst DATE_ONLY = /^(\\d{4})-(\\d{2})-(\\d{2})$/;\n\n/**\n * A date as a calendar day (days since 1970-01-01) plus, for a timestamp, the\n * instant. \"YYYY-MM-DD\" is a calendar date with no time zone; a timestamp or an\n * ISO date-time is read in the viewer's time zone.\n */\ntype Parsed = { day: number; instant: Date | null };\n\nexport function parseDate(value: string | number): Parsed {\n  if (typeof value === \"string\") {\n    const m = DATE_ONLY.exec(value.trim());\n    if (m) {\n      const [y, mo, d] = [Number(m[1]), Number(m[2]), Number(m[3])];\n      const utc = Date.UTC(y, mo - 1, d);\n      const check = new Date(utc);\n      if (check.getUTCMonth() !== mo - 1 || check.getUTCDate() !== d) throw new Error(`invalid date \"${value}\"`);\n      return { day: utc / DAY, instant: null };\n    }\n  }\n  const instant = new Date(value);\n  if (Number.isNaN(instant.getTime())) throw new Error(`invalid date \"${value}\"`);\n  return { day: Date.UTC(instant.getFullYear(), instant.getMonth(), instant.getDate()) / DAY, instant };\n}\n\nexport function isoDay(day: number): string {\n  return new Date(day * DAY).toISOString().slice(0, 10);\n}\n\nconst STYLES: Record<string, Intl.DateTimeFormatOptions> = {\n  date: { month: \"short\", day: \"numeric\", year: \"numeric\" },\n  short: { month: \"short\", day: \"numeric\" },\n  long: { weekday: \"long\", month: \"long\", day: \"numeric\", year: \"numeric\" },\n  weekday: { weekday: \"short\" },\n  month: { month: \"short\", year: \"numeric\" },\n  time: { hour: \"numeric\", minute: \"2-digit\" },\n  datetime: { month: \"short\", day: \"numeric\", hour: \"numeric\", minute: \"2-digit\" },\n};\n\nexport const Now = defineFunction({\n  name: \"Now\",\n  description: \"The current date and time as an ISO string\",\n  params: z.object({}),\n  returns: z.string(),\n  fn: () => new Date().toISOString(),\n});\n\nexport const FormatDate = defineFunction({\n  name: \"FormatDate\",\n  description:\n    'A date as text: \"date\" Oct 9, 2026 (default), \"short\" Oct 9, \"long\" Friday, October 9, 2026, \"weekday\" Fri, \"month\" Oct 2026, \"time\" 9:30 PM, \"datetime\", \"iso\" 2026-10-09. Dates are \"YYYY-MM-DD\", ISO or a timestamp',\n  params: z.object({\n    date: date(),\n    style: z.enum([\"date\", \"short\", \"long\", \"weekday\", \"month\", \"time\", \"datetime\", \"iso\"]).optional(),\n  }),\n  returns: z.string(),\n  fn: ({ date, style = \"date\" }) => {\n    const { day, instant } = parseDate(date);\n    if (style === \"iso\") return isoDay(day);\n    // A calendar date formats in UTC so its day never shifts with the viewer's zone\n    const at = instant ?? new Date(day * DAY);\n    return at.toLocaleString(\"en-US\", { ...STYLES[style], ...(instant ? {} : { timeZone: \"UTC\" }) });\n  },\n});\n\nexport const AddDays = defineFunction({\n  name: \"AddDays\",\n  description: 'The date days later (negative: earlier), as \"YYYY-MM-DD\"',\n  params: z.object({ date: date(), days: z.number() }),\n  returns: z.string(),\n  fn: ({ date, days }) => isoDay(parseDate(date).day + Math.trunc(days)),\n});\n\nexport const DaysBetween = defineFunction({\n  name: \"DaysBetween\",\n  description: \"Calendar days from one date to another (negative if to is earlier)\",\n  params: z.object({ from: date(), to: date() }),\n  returns: z.number(),\n  fn: ({ from, to }) => parseDate(to).day - parseDate(from).day,\n});\n\nexport const Today = defineFunction({\n  name: \"Today\",\n  description: 'Today\\'s date in the viewer\\'s time zone, as \"YYYY-MM-DD\"',\n  params: z.object({}),\n  returns: z.string(),\n  fn: () => isoDay(parseDate(Date.now()).day),\n});\n\n/** Year, month (0-11) and day of a calendar day. */\nfunction ymd(day: number): [number, number, number] {\n  const d = new Date(day * DAY);\n  return [d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()];\n}\n\nexport const AddMonths = defineFunction({\n  name: \"AddMonths\",\n  description: 'The date months later (negative: earlier), kept within the month (Jan 31 + 1 is Feb 28), as \"YYYY-MM-DD\"; 12 months is a year',\n  params: z.object({ date: date(), months: z.number() }),\n  returns: z.string(),\n  fn: ({ date, months }) => {\n    const [y, m, d] = ymd(parseDate(date).day);\n    const target = m + Math.trunc(months);\n    const last = new Date(Date.UTC(y, target + 1, 0)).getUTCDate();\n    return isoDay(Date.UTC(y, target, Math.min(d, last)) / DAY);\n  },\n});\n\nexport const MonthsBetween = defineFunction({\n  name: \"MonthsBetween\",\n  description: \"Whole months from one date to another (negative if to is earlier); @Floor(@MonthsBetween(birthday, @Today()) / 12) is an age\",\n  params: z.object({ from: date(), to: date() }),\n  returns: z.number(),\n  fn: ({ from, to }) => {\n    const [y1, m1, d1] = ymd(parseDate(from).day);\n    const [y2, m2, d2] = ymd(parseDate(to).day);\n    let months = (y2 - y1) * 12 + (m2 - m1);\n    if (months > 0 && d2 < d1) months -= 1;\n    if (months < 0 && d2 > d1) months += 1;\n    return months;\n  },\n});\n\nexport const StartOf = defineFunction({\n  name: \"StartOf\",\n  description: 'First day of the date\\'s \"week\" (Monday), \"month\" or \"year\", as \"YYYY-MM-DD\"',\n  params: z.object({ date: date(), unit: z.enum([\"week\", \"month\", \"year\"]) }),\n  returns: z.string(),\n  fn: ({ date, unit }) => {\n    const day = parseDate(date).day;\n    const [y, m] = ymd(day);\n    if (unit === \"week\") return isoDay(day - ((new Date(day * DAY).getUTCDay() + 6) % 7));\n    return isoDay(Date.UTC(y, unit === \"month\" ? m : 0, 1) / DAY);\n  },\n});\n\nexport const dateFunctions = [Now, Today, FormatDate, AddDays, AddMonths, DaysBetween, MonthsBetween, StartOf];\n"],"names":["DAY","DATE_ONLY","parseDate","value","m","y","mo","d","utc","check","instant","isoDay","day","STYLES","Now","defineFunction","z.object","z.string","FormatDate","date","z.enum","style","AddDays","z.number","days","DaysBetween","from","to","Today","ymd","AddMonths","months","target","last","MonthsBetween","y1","m1","d1","y2","m2","d2","StartOf","unit","dateFunctions"],"mappings":"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"}