@panoboard/core 1.1.5

package/dist/filters/daterange.js

@@ -0,0 +1,119 @@
+// Copyright 2026 Mataki Labs LLC
+//
+// Licensed under the Business Source License 1.1 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://github.com/panoboard/panoboard/blob/main/LICENSE
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import { TZDate } from "@date-fns/tz";
+import { startOfDay, endOfDay, subDays, startOfWeek, endOfWeek, startOfMonth, endOfMonth, startOfQuarter, endOfQuarter, startOfYear, endOfYear, subWeeks, subMonths, subQuarters, subYears, differenceInMilliseconds, } from "date-fns";
+export function resolveDateRange(preset, timezone = "UTC", referenceDate) {
+    // Use TZDate for timezone-aware "now"
+    const now = referenceDate
+        ? new TZDate(referenceDate, timezone)
+        : new TZDate(new Date(), timezone);
+    let start;
+    let end;
+    // Check for custom range first: "2025-01-01,2025-03-31"
+    if (preset.includes(",")) {
+        const [startStr, endStr] = preset.split(",");
+        start = startOfDay(new TZDate(new Date(startStr), timezone));
+        end = endOfDay(new TZDate(new Date(endStr), timezone));
+    }
+    else {
+        // Resolve preset
+        const today = startOfDay(now);
+        const todayEnd = endOfDay(now);
+        switch (preset) {
+            case "today":
+                start = today;
+                end = todayEnd;
+                break;
+            case "yesterday":
+                start = startOfDay(subDays(now, 1));
+                end = endOfDay(subDays(now, 1));
+                break;
+            case "last_7d":
+                start = startOfDay(subDays(now, 7));
+                end = todayEnd;
+                break;
+            case "last_14d":
+                start = startOfDay(subDays(now, 14));
+                end = todayEnd;
+                break;
+            case "last_30d":
+                start = startOfDay(subDays(now, 30));
+                end = todayEnd;
+                break;
+            case "last_60d":
+                start = startOfDay(subDays(now, 60));
+                end = todayEnd;
+                break;
+            case "last_90d":
+                start = startOfDay(subDays(now, 90));
+                end = todayEnd;
+                break;
+            case "last_180d":
+                start = startOfDay(subDays(now, 180));
+                end = todayEnd;
+                break;
+            case "last_365d":
+                start = startOfDay(subDays(now, 365));
+                end = todayEnd;
+                break;
+            case "this_week":
+                start = startOfWeek(now, { weekStartsOn: 1 });
+                end = todayEnd;
+                break;
+            case "this_month":
+                start = startOfMonth(now);
+                end = todayEnd;
+                break;
+            case "this_quarter":
+                start = startOfQuarter(now);
+                end = todayEnd;
+                break;
+            case "this_year":
+                start = startOfYear(now);
+                end = todayEnd;
+                break;
+            case "last_week":
+                start = startOfWeek(subWeeks(now, 1), { weekStartsOn: 1 });
+                end = endOfWeek(subWeeks(now, 1), { weekStartsOn: 1 });
+                break;
+            case "last_month":
+                start = startOfMonth(subMonths(now, 1));
+                end = endOfMonth(subMonths(now, 1));
+                break;
+            case "last_quarter":
+                start = startOfQuarter(subQuarters(now, 1));
+                end = endOfQuarter(subQuarters(now, 1));
+                break;
+            case "last_year":
+                start = startOfYear(subYears(now, 1));
+                end = endOfYear(subYears(now, 1));
+                break;
+            default:
+                throw new Error(`Unknown date range preset: ${preset}`);
+        }
+    }
+    // Calculate prior period (same duration, immediately before)
+    const durationMs = differenceInMilliseconds(end, start);
+    const priorEnd = new Date(start.getTime() - 1); // 1ms before start
+    const priorStart = new Date(priorEnd.getTime() - durationMs);
+    // Convert TZDate → plain Date for standard ISO output with 'Z' suffix
+    const toUTC = (d) => new Date(d.getTime()).toISOString();
+    return {
+        start: toUTC(start),
+        end: toUTC(end),
+        priorStart: toUTC(priorStart),
+        priorEnd: toUTC(priorEnd),
+    };
+}
+//# sourceMappingURL=daterange.js.map

package/dist/filters/daterange.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daterange.js","sourceRoot":"","sources":["../../src/filters/daterange.ts"],"names":[],"mappings":"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"}

package/dist/filters/index.d.ts

@@ -0,0 +1,7 @@
+export { resolveFilters } from "./resolver";
+export { resolveDateRange } from "./daterange";
+export type { DateRange } from "./daterange";
+export { validateParam, ParamValidationError } from "./validation";
+export type { ParamSchema } from "./validation";
+export { resolveCascadingParams } from "./cascade";
+//# sourceMappingURL=index.d.ts.map

package/dist/filters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/filters/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACnE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC"}

package/dist/filters/index.js

@@ -0,0 +1,18 @@
+// Copyright 2026 Mataki Labs LLC
+//
+// Licensed under the Business Source License 1.1 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://github.com/panoboard/panoboard/blob/main/LICENSE
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+export { resolveFilters } from "./resolver";
+export { resolveDateRange } from "./daterange";
+export { validateParam, ParamValidationError } from "./validation";
+export { resolveCascadingParams } from "./cascade";
+//# sourceMappingURL=index.js.map

package/dist/filters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/filters/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,+DAA+D;AAC/D,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC"}

package/dist/filters/resolver.d.ts

@@ -0,0 +1,3 @@
+import type { Filter } from "../schemas/dashboard";
+export declare function resolveFilters(searchParams: URLSearchParams, filterDefs: Filter[], timezone: string, ctx?: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/filters/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/filters/resolver.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,wBAAgB,cAAc,CAC5B,YAAY,EAAE,eAAe,EAC7B,UAAU,EAAE,MAAM,EAAE,EACpB,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiIzB"}

package/dist/filters/resolver.js

@@ -0,0 +1,122 @@
+// Copyright 2026 Mataki Labs LLC
+//
+// Licensed under the Business Source License 1.1 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://github.com/panoboard/panoboard/blob/main/LICENSE
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import { resolveDateRange } from "./daterange";
+import { validateParam } from "./validation";
+export function resolveFilters(searchParams, filterDefs, timezone, ctx = {}) {
+    const resolved = {};
+    for (const filter of filterDefs) {
+        // Hidden filters: resolve from auth context (source: "ctx.<claim_name>")
+        // or fall back to filter.default when no source is defined.
+        if ("hidden" in filter && filter.hidden) {
+            const source = filter.source ?? "";
+            if (source.startsWith("ctx.")) {
+                const claimName = source.slice(4);
+                resolved[filter.id] = ctx[claimName] ?? null;
+            }
+            else {
+                // No source (or non-ctx source): use filter default
+                resolved[filter.id] = filter.default ?? null;
+            }
+            continue;
+        }
+        const rawValue = searchParams.get(filter.id);
+        switch (filter.type) {
+            case "daterange": {
+                const preset = rawValue ?? filter.default ?? "last_30d";
+                const range = resolveDateRange(preset, timezone);
+                if (filter.outputs) {
+                    if (filter.outputs.start)
+                        resolved[filter.outputs.start] = range.start;
+                    if (filter.outputs.end)
+                        resolved[filter.outputs.end] = range.end;
+                    if (filter.outputs.prior_start)
+                        resolved[filter.outputs.prior_start] = range.priorStart;
+                    if (filter.outputs.prior_end)
+                        resolved[filter.outputs.prior_end] = range.priorEnd;
+                }
+                break;
+            }
+            case "select": {
+                let value = rawValue ?? filter.default;
+                // If static options are defined and the URL value doesn't match any
+                // option, fall back to the filter's default.
+                if (rawValue !== null &&
+                    "options" in filter &&
+                    Array.isArray(filter.options) &&
+                    filter.options.length > 0) {
+                    const validValues = filter.options.map((o) => o.value);
+                    if (!validValues.includes(rawValue)) {
+                        value = filter.default ?? undefined;
+                    }
+                }
+                if (filter.include_all &&
+                    (value === "__all__" || value === null || value === undefined)) {
+                    resolved[filter.id] = null;
+                }
+                else {
+                    resolved[filter.id] = value ?? null;
+                }
+                break;
+            }
+            case "string": // hidden string — already handled above by `hidden` check, but type: "string" without hidden falls through here
+            case "text": {
+                const value = rawValue ?? null;
+                if (value !== null) {
+                    const { type: _t1, ...rest } = filter;
+                    validateParam(value, { ...rest, type: "string" });
+                }
+                resolved[filter.id] = value;
+                break;
+            }
+            case "integer": {
+                const value = rawValue !== null ? parseInt(rawValue, 10) : (filter.default ?? null);
+                if (value !== null) {
+                    const { type: _t2, ...rest } = filter;
+                    validateParam(value, { ...rest, type: "integer" });
+                }
+                resolved[filter.id] = value;
+                break;
+            }
+            case "number": {
+                const value = rawValue !== null ? parseFloat(rawValue) : (filter.default ?? null);
+                if (value !== null) {
+                    const { type: _t3, ...rest } = filter;
+                    validateParam(value, { ...rest, type: "number" });
+                }
+                resolved[filter.id] = value;
+                break;
+            }
+            case "boolean": {
+                const value = rawValue !== null ? rawValue : String(filter.default ?? false);
+                resolved[filter.id] = value === "true";
+                break;
+            }
+            case "array": {
+                // Parse comma-separated URL value into an array of strings
+                if (rawValue === null || rawValue === "") {
+                    resolved[filter.id] = [];
+                }
+                else {
+                    resolved[filter.id] = rawValue
+                        .split(",")
+                        .map((v) => v.trim())
+                        .filter(Boolean);
+                }
+                break;
+            }
+        }
+    }
+    return resolved;
+}
+//# sourceMappingURL=resolver.js.map

package/dist/filters/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/filters/resolver.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,+DAA+D;AAC/D,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C,MAAM,UAAU,cAAc,CAC5B,YAA6B,EAC7B,UAAoB,EACpB,QAAgB,EAChB,MAA+B,EAAE;IAEjC,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAE7C,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,yEAAyE;QACzE,4DAA4D;QAC5D,IAAI,QAAQ,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YACxC,MAAM,MAAM,GAAY,MAA8B,CAAC,MAAM,IAAI,EAAE,CAAC;YACpE,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9B,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACN,oDAAoD;gBACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,GAAI,MAAgC,CAAC,OAAO,IAAI,IAAI,CAAC;YAC1E,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAE7C,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,MAAM,MAAM,GAAG,QAAQ,IAAI,MAAM,CAAC,OAAO,IAAI,UAAU,CAAC;gBACxD,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;gBACjD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnB,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK;wBACtB,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC;oBAC/C,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG;wBAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC;oBACjE,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW;wBAC5B,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC;oBAC1D,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS;wBAC1B,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC;gBACxD,CAAC;gBACD,MAAM;YACR,CAAC;YAED,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,IAAI,KAAK,GAAG,QAAQ,IAAI,MAAM,CAAC,OAAO,CAAC;gBAEvC,oEAAoE;gBACpE,6CAA6C;gBAC7C,IACE,QAAQ,KAAK,IAAI;oBACjB,SAAS,IAAI,MAAM;oBACnB,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;oBAC7B,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EACzB,CAAC;oBACD,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;oBACvD,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;wBACpC,KAAK,GAAG,MAAM,CAAC,OAAO,IAAI,SAAS,CAAC;oBACtC,CAAC;gBACH,CAAC;gBAED,IACE,MAAM,CAAC,WAAW;oBAClB,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC,EAC9D,CAAC;oBACD,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;gBAC7B,CAAC;qBAAM,CAAC;oBACN,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC;gBACtC,CAAC;gBACD,MAAM;YACR,CAAC;YAED,KAAK,QAAQ,CAAC,CAAC,gHAAgH;YAC/H,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,KAAK,GAAG,QAAQ,IAAI,IAAI,CAAC;gBAC/B,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBACnB,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,MAG9B,CAAC;oBACF,aAAa,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;gBACpD,CAAC;gBACD,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC;gBAC5B,MAAM;YACR,CAAC;YAED,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,MAAM,KAAK,GACT,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC;gBACxE,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBACnB,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,MAG9B,CAAC;oBACF,aAAa,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;gBACrD,CAAC;gBACD,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC;gBAC5B,MAAM;YACR,CAAC;YAED,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,KAAK,GACT,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC;gBACtE,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBACnB,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,MAG9B,CAAC;oBACF,aAAa,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;gBACpD,CAAC;gBACD,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC;gBAC5B,MAAM;YACR,CAAC;YAED,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,MAAM,KAAK,GACT,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC;gBACjE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,KAAK,KAAK,MAAM,CAAC;gBACvC,MAAM;YACR,CAAC;YAED,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,2DAA2D;gBAC3D,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,EAAE,EAAE,CAAC;oBACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;gBAC3B,CAAC;qBAAM,CAAC;oBACN,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,QAAQ;yBAC3B,KAAK,CAAC,GAAG,CAAC;yBACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;yBACpB,MAAM,CAAC,OAAO,CAAC,CAAC;gBACrB,CAAC;gBACD,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/filters/validation.d.ts

@@ -0,0 +1,17 @@
+export declare class ParamValidationError extends Error {
+    param: string;
+    reason: string;
+    constructor(param: string, reason: string);
+}
+export interface ParamSchema {
+    type: "string" | "integer" | "number" | "boolean";
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    minimum?: number;
+    maximum?: number;
+    decimals?: number;
+    [key: string]: unknown;
+}
+export declare function validateParam(value: unknown, schema: ParamSchema): unknown;
+//# sourceMappingURL=validation.d.ts.map

package/dist/filters/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/filters/validation.ts"],"names":[],"mappings":"AAcA,qBAAa,oBAAqB,SAAQ,KAAK;IAEpC,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;gBADd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM;CAKxB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IAElD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAgG1E"}

package/dist/filters/validation.js

@@ -0,0 +1,84 @@
+// Copyright 2026 Mataki Labs LLC
+//
+// Licensed under the Business Source License 1.1 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://github.com/panoboard/panoboard/blob/main/LICENSE
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+export class ParamValidationError extends Error {
+    param;
+    reason;
+    constructor(param, reason) {
+        super(`Parameter '${param}' validation failed: ${reason}`);
+        this.param = param;
+        this.reason = reason;
+        this.name = "ParamValidationError";
+    }
+}
+export function validateParam(value, schema) {
+    switch (schema.type) {
+        case "string": {
+            if (typeof value !== "string") {
+                throw new ParamValidationError(schema.type, `expected string, got ${typeof value}`);
+            }
+            if (schema.minLength !== undefined && value.length < schema.minLength) {
+                throw new ParamValidationError(schema.type, `value length ${value.length} is less than minLength ${schema.minLength}`);
+            }
+            if (schema.maxLength !== undefined && value.length > schema.maxLength) {
+                throw new ParamValidationError(schema.type, `value length ${value.length} exceeds maxLength ${schema.maxLength}`);
+            }
+            if (schema.pattern !== undefined &&
+                !new RegExp(schema.pattern).test(value)) {
+                throw new ParamValidationError(schema.type, `value does not match pattern ${schema.pattern}`);
+            }
+            return value;
+        }
+        case "integer": {
+            const intVal = parseInt(String(value), 10);
+            if (isNaN(intVal)) {
+                throw new ParamValidationError(schema.type, `value '${value}' is not a valid integer`);
+            }
+            if (schema.minimum !== undefined && intVal < schema.minimum) {
+                throw new ParamValidationError(schema.type, `value ${intVal} is less than minimum ${schema.minimum}`);
+            }
+            if (schema.maximum !== undefined && intVal > schema.maximum) {
+                throw new ParamValidationError(schema.type, `value ${intVal} exceeds maximum ${schema.maximum}`);
+            }
+            return intVal;
+        }
+        case "number": {
+            let numVal = parseFloat(String(value));
+            if (isNaN(numVal)) {
+                throw new ParamValidationError(schema.type, `value '${value}' is not a valid number`);
+            }
+            if (schema.decimals !== undefined) {
+                numVal = parseFloat(numVal.toFixed(schema.decimals));
+            }
+            if (schema.minimum !== undefined && numVal < schema.minimum) {
+                throw new ParamValidationError(schema.type, `value ${numVal} is less than minimum ${schema.minimum}`);
+            }
+            if (schema.maximum !== undefined && numVal > schema.maximum) {
+                throw new ParamValidationError(schema.type, `value ${numVal} exceeds maximum ${schema.maximum}`);
+            }
+            return numVal;
+        }
+        case "boolean": {
+            if (value === "true" || value === true)
+                return true;
+            if (value === "false" || value === false)
+                return false;
+            throw new ParamValidationError(schema.type, `value '${value}' is not a valid boolean (expected 'true' or 'false')`);
+        }
+        default: {
+            // Unknown type — pass through
+            return value;
+        }
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/filters/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/filters/validation.ts"],"names":[],"mappings":"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"}

package/dist/formats.d.ts

@@ -0,0 +1,4 @@
+/** Abbreviated format for axis labels — e.g. $1.2M, 45K, 3.5% */
+export declare function formatValueShort(value: unknown, format: string, _locale?: string): string;
+export declare function formatValue(value: unknown, format: string, locale?: string): string;
+//# sourceMappingURL=formats.d.ts.map

package/dist/formats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../src/formats.ts"],"names":[],"mappings":"AAcA,iEAAiE;AACjE,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,EACd,OAAO,SAAU,GAChB,MAAM,CAoCR;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,EACd,MAAM,SAAU,GACf,MAAM,CAiDR"}

package/dist/formats.js

@@ -0,0 +1,127 @@
+// Copyright 2026 Mataki Labs LLC
+//
+// Licensed under the Business Source License 1.1 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://github.com/panoboard/panoboard/blob/main/LICENSE
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+/** Abbreviated format for axis labels — e.g. $1.2M, 45K, 3.5% */
+export function formatValueShort(value, format, _locale = "en-US") {
+    if (value === null || value === undefined)
+        return "";
+    const num = typeof value === "number" ? value : parseFloat(String(value));
+    if (isNaN(num))
+        return String(value);
+    const abbrev = (n) => {
+        const abs = Math.abs(n);
+        if (abs >= 1_000_000_000)
+            return `${(n / 1_000_000_000).toFixed(1)}B`;
+        if (abs >= 1_000_000)
+            return `${(n / 1_000_000).toFixed(1)}M`;
+        if (abs >= 1_000)
+            return `${(n / 1_000).toFixed(0)}K`;
+        return n.toFixed(0);
+    };
+    switch (format) {
+        case "currency":
+            return `$${abbrev(num)}`;
+        case "percent":
+            return `${num.toFixed(1)}%`;
+        case "duration_ms":
+            if (num < 1000)
+                return `${Math.round(num)}ms`;
+            return `${(num / 1000).toFixed(1)}s`;
+        default:
+            if (format.startsWith("currency_")) {
+                const code = format.replace("currency_", "").toUpperCase();
+                const symbol = code === "USD"
+                    ? "$"
+                    : code === "EUR"
+                        ? "€"
+                        : code === "GBP"
+                            ? "£"
+                            : `${code} `;
+                return `${symbol}${abbrev(num)}`;
+            }
+            return abbrev(num);
+    }
+}
+export function formatValue(value, format, locale = "en-US") {
+    if (value === null || value === undefined)
+        return "—";
+    const num = typeof value === "number" ? value : parseFloat(String(value));
+    if (isNaN(num))
+        return String(value);
+    switch (format) {
+        case "number":
+            return new Intl.NumberFormat(locale, { maximumFractionDigits: 0 }).format(num);
+        case "decimal":
+            return new Intl.NumberFormat(locale, {
+                minimumFractionDigits: 2,
+                maximumFractionDigits: 2,
+            }).format(num);
+        case "percent":
+            return `${num}%`;
+        // Note: value is already a percentage (e.g., 42.3), not a fraction (0.423)
+        case "bytes":
+            return formatBytes(num);
+        case "duration_ms":
+            return formatDurationMs(num);
+        case "duration_s":
+            return formatDurationS(num);
+        case "currency":
+            return new Intl.NumberFormat(locale, {
+                style: "currency",
+                currency: "USD",
+                maximumFractionDigits: 0,
+            }).format(num);
+        default:
+            // Handle currency_xxx pattern (e.g. currency_eur, currency_gbp)
+            if (format.startsWith("currency_")) {
+                const code = format.replace("currency_", "").toUpperCase();
+                return new Intl.NumberFormat(locale, {
+                    style: "currency",
+                    currency: code,
+                    maximumFractionDigits: 0,
+                }).format(num);
+            }
+            return String(value);
+    }
+}
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return "0 B";
+    const units = ["B", "KB", "MB", "GB", "TB", "PB"];
+    const i = Math.floor(Math.log(bytes) / Math.log(1024));
+    const val = bytes / Math.pow(1024, i);
+    if (Number.isInteger(val) || val >= 10)
+        return `${Math.round(val)} ${units[i]}`;
+    return `${val.toFixed(1)} ${units[i]}`;
+}
+function formatDurationMs(ms) {
+    if (ms < 1000)
+        return `${Math.round(ms)}ms`;
+    if (ms < 60000)
+        return `${(ms / 1000).toFixed(2)}s`;
+    const mins = Math.floor(ms / 60000);
+    const secs = Math.round((ms % 60000) / 1000);
+    return `${mins}m ${secs}s`;
+}
+function formatDurationS(seconds) {
+    if (seconds < 60)
+        return `${Math.round(seconds)}s`;
+    const mins = Math.floor(seconds / 60);
+    const secs = Math.round(seconds % 60);
+    if (mins < 60)
+        return `${mins}m ${secs}s`;
+    const hours = Math.floor(mins / 60);
+    const remainMins = mins % 60;
+    return `${hours}h ${remainMins}m`;
+}
+//# sourceMappingURL=formats.js.map

package/dist/formats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.js","sourceRoot":"","sources":["../src/formats.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export declare const VERSION = "0.1.0";
+export * from "./schemas";
+export * from "./interfaces";
+export * from "./connectors";
+export * from "./query";
+export * from "./cache";
+export * from "./filters";
+export * from "./components";
+export * from "./theme";
+export * from "./locale";
+export { formatValue, formatValueShort } from "./formats";
+export * from "./startup";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,cAAc,WAAW,CAAC;AAG1B,cAAc,cAAc,CAAC;AAG7B,cAAc,cAAc,CAAC;AAG7B,cAAc,SAAS,CAAC;AAGxB,cAAc,SAAS,CAAC;AAGxB,cAAc,WAAW,CAAC;AAG1B,cAAc,cAAc,CAAC;AAG7B,cAAc,SAAS,CAAC;AAGxB,cAAc,UAAU,CAAC;AAGzB,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAG1D,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,37 @@
+// Copyright 2026 Mataki Labs LLC
+//
+// Licensed under the Business Source License 1.1 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://github.com/panoboard/panoboard/blob/main/LICENSE
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+export const VERSION = "0.1.0";
+// Schemas & types
+export * from "./schemas";
+// Interfaces
+export * from "./interfaces";
+// Connectors
+export * from "./connectors";
+// Query engine
+export * from "./query";
+// Cache
+export * from "./cache";
+// Filters
+export * from "./filters";
+// Components
+export * from "./components";
+// Theme
+export * from "./theme";
+// Locale
+export * from "./locale";
+// Formatting
+export { formatValue, formatValueShort } from "./formats";
+// SQL lint
+export * from "./startup";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,+DAA+D;AAC/D,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,kBAAkB;AAClB,cAAc,WAAW,CAAC;AAE1B,aAAa;AACb,cAAc,cAAc,CAAC;AAE7B,aAAa;AACb,cAAc,cAAc,CAAC;AAE7B,eAAe;AACf,cAAc,SAAS,CAAC;AAExB,QAAQ;AACR,cAAc,SAAS,CAAC;AAExB,UAAU;AACV,cAAc,WAAW,CAAC;AAE1B,aAAa;AACb,cAAc,cAAc,CAAC;AAE7B,QAAQ;AACR,cAAc,SAAS,CAAC;AAExB,SAAS;AACT,cAAc,UAAU,CAAC;AAEzB,aAAa;AACb,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE1D,WAAW;AACX,cAAc,WAAW,CAAC"}