@spaethtech/svelte-ui 0.7.1-dev.35.6496cbd → 0.7.1-dev.38.b73de30

package/dist/components/Query.svelte

@@ -265,16 +265,45 @@
         </tbody>
       </table>
     </div>
+    <div>
+      <h4 class="mb-1 font-semibold">Dynamic dates</h4>
+      <p class="mb-1 text-xs [color:color-mix(in_srgb,var(--ui-color-text)_70%,transparent)]">
+        <code class="font-mono">now()</code> is the current time, resolved when the query runs. Add a
+        signed offset <code class="font-mono">now()±&lt;n&gt;&lt;unit&gt;</code> — units
+        <code>s</code> <code>m</code> <code>h</code> <code>d</code> <code>w</code>. Great with a date
+        column and <code>&gt;=</code>/<code>&lt;</code> or a range.
+      </p>
+      <table class="w-full text-left">
+        <tbody
+          class="[&_td]:py-0.5 [&_td:first-child]:whitespace-nowrap [&_td:first-child]:pr-4 [&_td:first-child]:font-mono [&_td:last-child]:text-xs [&_td:last-child]:[color:color-mix(in_srgb,var(--ui-color-text)_65%,transparent)]"
+        >
+          <tr><td>$created &gt;= now()-7d</td><td>in the last 7 days</td></tr>
+          <tr><td>$expires &lt; now()</td><td>already expired</td></tr>
+          <tr><td>$due |= [now()..now()+30d]</td><td>due within 30 days</td></tr>
+        </tbody>
+      </table>
+    </div>
     <div>
       <h4 class="mb-1 font-semibold">Examples</h4>
-      <pre
-        class="overflow-x-auto rounded p-2 font-mono text-xs [background-color:color-mix(in_srgb,var(--ui-color-text)_6%,transparent)]"><code
-          >$status == active
-$email ~= /@gmail\.com$/i
-$price |= [20..50) && $role |= [admin, ops]
-$ip|inet |= [10.0.0.0|inet..10.255.255.255|inet]
-"lemon balm" || $featured == true</code
-        ></pre>
+      <table class="w-full text-left">
+        <tbody
+          class="[&_td]:py-0.5 [&_td:first-child]:whitespace-nowrap [&_td:first-child]:pr-4 [&_td:first-child]:font-mono [&_td:last-child]:text-xs [&_td:last-child]:[color:color-mix(in_srgb,var(--ui-color-text)_65%,transparent)]"
+        >
+          <tr><td>$status == active</td><td>exact match</td></tr>
+          <tr><td>$name ^= Ada</td><td>starts with “Ada”</td></tr>
+          <tr><td>$email ~= @gmail.com</td><td>contains substring</td></tr>
+          <tr><td>$email ~= /@gmail\.com$/i</td><td>regex, case-insensitive</td></tr>
+          <tr><td>$age &gt;= 30</td><td>numeric compare</td></tr>
+          <tr><td>$age |= [21..40)</td><td>range — 21 ≤ age &lt; 40</td></tr>
+          <tr><td>$role |= [admin, ops]</td><td>any of a set</td></tr>
+          <tr><td>$tags &amp;= [urgent, vip]</td><td>all of (multi-value column)</td></tr>
+          <tr><td>$created &gt;= now()-7d</td><td>dynamic date (last 7 days)</td></tr>
+          <tr><td>$ip|inet &gt;= 10.0.0.0|inet</td><td>typed IP compare</td></tr>
+          <tr><td>!($role == admin)</td><td>negate a group</td></tr>
+          <tr><td>$status == open &amp;&amp; $priority &gt;= 3</td><td>combine with &amp;&amp; / ||</td></tr>
+          <tr><td>"lemon balm"</td><td>free-text search (no $)</td></tr>
+        </tbody>
+      </table>
     </div>
     <p class="text-xs [color:color-mix(in_srgb,var(--ui-color-text)_60%,transparent)]">
       Tip: type <kbd class="rounded border px-1 {bc}">$</kbd> for columns; enum columns suggest

package/dist/data/query/ast.d.ts

@@ -1,5 +1,26 @@
 export type CompareOp = "eq" | "ne" | "gt" | "gte" | "lt" | "lte" | "contains" | "ncontains" | "starts" | "ends";
 export type Scalar = string | number | boolean;
+/** Relative-time unit for a `now()` offset: seconds/minutes/hours/days/weeks. */
+export type TimeUnit = "s" | "m" | "h" | "d" | "w";
+/** A dynamic `now()` value — the current instant, optionally shifted by a signed offset
+ *  (`now()-7d`, `now()+1h`). Resolved at EVALUATION time, not parse time (so it's always "now" when
+ *  the query runs, and the server can push it down to the DB's own `now()`). Carried in the AST as a
+ *  marker; `resolveNow` turns it into a `Date`, or the consumer's `toConditions` emits DB SQL. */
+export interface NowValue {
+    now: true;
+    /** Signed amount + unit, e.g. `{ n: -7, unit: "d" }` for `now()-7d`. Absent = the current instant. */
+    offset?: {
+        n: number;
+        unit: TimeUnit;
+    };
+}
+/** A comparison operand: a literal scalar or a dynamic value (`now()`). */
+export type Value = Scalar | NowValue;
+/** Narrow a `Value` to the dynamic `now()` marker. */
+export declare function isNow(v: Value): v is NowValue;
+/** Resolve a `NowValue` to a concrete `Date` (defaults to the real current instant). For client-side
+ *  evaluation; server code typically maps the marker to the DB's `now()` in `toConditions` instead. */
+export declare function resolveNow(v: NowValue, at?: Date): Date;
 /** Explicit value/column cast on a comparison, e.g. `$ip |inet >= 10.0.0.0 |inet`. Storage-agnostic:
  *  the query layer only carries the marker; the consumer (`toConditions`) decides the SQL (e.g.
  *  Postgres `::inet`). `number`/`string`/`bool` also retype the literal at parse time. */
@@ -8,7 +29,7 @@ export type Cast = "number" | "string" | "bool" | "date" | "inet";
 export type MemberMode = "any" | "all";
 /** One end of an interval. `inclusive` reflects the bracket: `[`/`]` inclusive, `(`/`)` exclusive. */
 export type Bound = {
-    value: Scalar;
+    value: Value;
     inclusive: boolean;
 };
 /** `null` bound = open/unbounded on that side (e.g. `[20..)` -> upper is null). */
@@ -29,7 +50,7 @@ export type QueryNode = {
     kind: "cmp";
     col: string;
     op: CompareOp;
-    value: Scalar;
+    value: Value;
     cast?: Cast;
 } | {
     kind: "match";
@@ -41,7 +62,7 @@ export type QueryNode = {
     kind: "in";
     col: string;
     mode: MemberMode;
-    values: Scalar[];
+    values: Value[];
     cast?: Cast;
 } | {
     kind: "range";

package/dist/data/query/ast.js

@@ -1,5 +1,22 @@
 // AST for the data-table query language. Framework-agnostic — no Svelte/Drizzle/SvelteKit deps,
 // so it runs in the browser (Query input), on the server (toConditions), and in unit tests.
+/** Narrow a `Value` to the dynamic `now()` marker. */
+export function isNow(v) {
+    return typeof v === "object" && v !== null && v.now === true;
+}
+const UNIT_MS = {
+    s: 1_000,
+    m: 60_000,
+    h: 3_600_000,
+    d: 86_400_000,
+    w: 604_800_000,
+};
+/** Resolve a `NowValue` to a concrete `Date` (defaults to the real current instant). For client-side
+ *  evaluation; server code typically maps the marker to the DB's `now()` in `toConditions` instead. */
+export function resolveNow(v, at = new Date()) {
+    const base = at.getTime();
+    return new Date(v.offset ? base + v.offset.n * UNIT_MS[v.offset.unit] : base);
+}
 export class QueryError extends Error {
     position;
     constructor(message, 

package/dist/data/query/parser.js

@@ -159,7 +159,35 @@ class Parser {
         }
         throw new QueryError("Expected an operator after the column", opTok.start);
     }
+    /** `now()` (+ optional signed offset like `-7d`, `+1h`) → a dynamic value. `now` alone (no parens)
+     *  is an ordinary literal. Returns undefined if the cursor isn't on a `now()`. */
+    tryNow() {
+        const t = this.peek();
+        if (t.type !== "word" ||
+            t.value !== "now" ||
+            this.tokens[this.pos + 1]?.type !== "lparen" ||
+            this.tokens[this.pos + 2]?.type !== "rparen")
+            return undefined;
+        this.next(); // now
+        this.next(); // (
+        this.next(); // )
+        let offset;
+        const nx = this.peek();
+        if (nx.type === "word") {
+            const m = /^([+-])(\d+)([smhdw])$/.exec(nx.value);
+            if (m) {
+                this.next();
+                offset = { n: (m[1] === "-" ? -1 : 1) * parseInt(m[2], 10), unit: m[3] };
+            }
+            // a following word that ISN'T an offset is left for the outer parser (adjacent-terms error).
+        }
+        this.castAfter(); // a redundant `|date` is allowed and recorded, but not required
+        return { now: true, offset };
+    }
     parseScalar() {
+        const now = this.tryNow();
+        if (now)
+            return now;
         const t = this.next();
         let raw;
         let value;

package/docs/components.md

@@ -232,7 +232,8 @@ Config-driven, responsive 12-column data table over a `DataGrid`.
 ### Query
 
 Filter bar over a `DataSet` — monospace input with `$column` + enum-value autocomplete and a help
-dialog.
+dialog (operators, casts, dynamic `now()` dates, and a worked examples table). The DSL supports
+`now()` / `now()±<n><unit>` dynamic dates — see the help dialog + the data spec.
 
 - **Location**: `src/lib/components/Query.svelte`
 - **Props**: `dataset` (`DataSet`), `placeholder`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spaethtech/svelte-ui",
-  "version": "0.7.1-dev.35.6496cbd",
+  "version": "0.7.1-dev.38.b73de30",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/spaethtech/svelte-ui.git"