@honua/app-platform 0.0.20-alpha.0

package/expr/index.js

@@ -0,0 +1,30 @@
+/**
+ * `@honua/sdk-js/expr` — Honua expression builder.
+ *
+ * A small, typed DSL that compiles to the MapLibre-style style/filter
+ * expression shape. Use it to build runtime style expressions, layer
+ * filters, and Honua-side projections without hand-rolling JSON arrays.
+ *
+ * @example
+ * ```ts
+ * import { get, eq, all, gt, interpolate, linear, zoom, rgb } from "@honua/sdk-js/expr";
+ *
+ * // Filter: STATUS = 'ACTIVE' AND POPULATION > 10000
+ * const filter = all(eq(get("STATUS"), "ACTIVE"), gt(get("POPULATION"), 10000));
+ *
+ * // Paint expression: interpolate point color by zoom
+ * const color = interpolate(linear(), zoom(), 8, rgb(70, 130, 180), 14, rgb(220, 20, 60));
+ * ```
+ *
+ * @example Render to a JSON expression
+ * ```ts
+ * import { expr, eq, get } from "@honua/sdk-js/expr";
+ *
+ * const isActive = eq(get("STATUS"), "ACTIVE");
+ * const json = expr(isActive); // ["==", ["get", "STATUS"], "ACTIVE"]
+ * map.setFilter("parcels", json);
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { expr, Expr, get, has, at, contains, indexOf, slice, length, id, geometryType, properties, featureState, lineProgress, heatmapDensity, pitch, accumulated, distanceFromCenter, literal, toBoolean, toNumber, exprToString, toColor, typeOf, eq, neq, lt, lte, gt, gte, not, all, any, switchCase, matchExpr, coalesce, add, subtract, multiply, divide, mod, pow, abs, ceil, floor, round, sqrt, ln, log2, log10, sin, cos, tan, asin, acos, atan, min, max, e, pi, ln2Const, concat, upcase, downcase, rgb, rgba, step, interpolate, interpolateHcl, interpolateLab, linear, exponential, cubicBezier, zoom, letExpr, varExpr, format, numberFormat, collator, resolvedLocale, hsl, hsla, toRgba, image, distance, within, intersects, } from "./expression.js";

package/filter-registry/index.d.ts

@@ -0,0 +1,145 @@
+/**
+ * `@honua/sdk-js/filter-registry` — shared filter / crossfilter registry.
+ *
+ * Protocol-neutral state container for map, chart, table, search, and control
+ * filters. Projection helpers translate active clauses into existing SDK
+ * query, linked-view, widget, runtime-style, and URL state.
+ *
+ * @example
+ * ```ts
+ * import { createFilterRegistry, projectFilterRegistryToQuery } from "@honua/sdk-js/filter-registry";
+ *
+ * const registry = createFilterRegistry();
+ * registry.set("status", { field: "STATUS", op: "=", value: "ACTIVE" });
+ * registry.set("severity", { field: "SEVERITY", op: ">=", value: 3 });
+ *
+ * const query = projectFilterRegistryToQuery(registry, { sourceId: "incidents" });
+ * const { features } = await dataset.source("incidents")!.queryAll(query);
+ * ```
+ *
+ * @packageDocumentation
+ */
+import type { DegradedReason, Query, SourceDescriptor, SourceId } from "../contract/types.js";
+import type { WidgetSourceProjection } from "../contract/widget-source.js";
+import type { SpatialFilter } from "../core/spatial-filter.js";
+import type { HonuaExtent } from "../core/types.js";
+import type { LinkedViewQueryProjection } from "../exploration/selectors.js";
+import type { FilterOperator } from "../exploration/types.js";
+export type FilterRegistryOwner = {
+    readonly kind: "map";
+    readonly id: string;
+} | {
+    readonly kind: "chart";
+    readonly id: string;
+} | {
+    readonly kind: "table";
+    readonly id: string;
+} | {
+    readonly kind: "search";
+    readonly id: string;
+} | {
+    readonly kind: "control";
+    readonly id: string;
+} | {
+    readonly kind: "component";
+    readonly id: string;
+};
+export type FilterLifecycle = "persistent" | "session" | "transient";
+export type FilterEffect = "filter" | "crossfilter" | "selection" | "search" | "spatial-mask";
+export type FilterSourceScope = "all" | readonly SourceId[];
+export type FilterRuntimeApplyMode = "server" | "runtime" | "client";
+export type RuntimeStyleFilterExpression = readonly unknown[];
+export interface FilterValuePolicy {
+    /** Omit this value from URL/share serialization. */
+    readonly secret?: boolean;
+    /** Omit values whose stable JSON representation exceeds this size. @default 2048 */
+    readonly maxSerializedBytes?: number;
+}
+export interface RegistrySpatialScope {
+    readonly filter?: SpatialFilter;
+    readonly extent?: HonuaExtent;
+}
+export interface FilterClause {
+    readonly id: string;
+    readonly owner: FilterRegistryOwner;
+    readonly sourceScope?: FilterSourceScope;
+    readonly field?: string;
+    readonly operator?: FilterOperator;
+    readonly value?: unknown;
+    readonly spatialScope?: RegistrySpatialScope;
+    readonly lifecycle?: FilterLifecycle;
+    readonly effect?: FilterEffect;
+    readonly enabled?: boolean;
+    readonly cacheable?: boolean;
+    readonly valuePolicy?: FilterValuePolicy;
+}
+export interface FilterRegistrySnapshot {
+    readonly version: 1;
+    readonly clauses: readonly FilterClause[];
+}
+export interface ShareableFilterRegistryState {
+    readonly version: 1;
+    readonly clauses: readonly FilterClause[];
+}
+export interface FilterRegistryChangeEvent {
+    readonly snapshot: FilterRegistrySnapshot;
+    readonly previous: FilterRegistrySnapshot;
+    readonly changedIds: ReadonlySet<string>;
+}
+export type FilterRegistryListener = (event: FilterRegistryChangeEvent) => void;
+export type FilterRegistrySelector<T> = (snapshot: FilterRegistrySnapshot) => T;
+export type FilterRegistrySelectorListener<T> = (value: T, event: FilterRegistryChangeEvent | undefined) => void;
+export type FilterRegistryUnsubscribe = () => void;
+export interface FilterRegistrySelectorOptions<T> {
+    readonly fireImmediately?: boolean;
+    readonly equals?: (left: T, right: T) => boolean;
+}
+export interface FilterRegistry {
+    readonly snapshot: FilterRegistrySnapshot;
+    upsert(clause: FilterClause): void;
+    remove(id: string): void;
+    clearOwner(owner: FilterRegistryOwner): void;
+    clearSource(sourceId: SourceId): void;
+    setEnabled(id: string, enabled: boolean): void;
+    replace(snapshot: FilterRegistrySnapshot): void;
+    subscribe(listener: FilterRegistryListener): FilterRegistryUnsubscribe;
+    select<T>(selector: FilterRegistrySelector<T>, listener: FilterRegistrySelectorListener<T>, options?: FilterRegistrySelectorOptions<T>): FilterRegistryUnsubscribe;
+}
+export interface CreateFilterRegistryOptions {
+    readonly initialClauses?: readonly FilterClause[];
+}
+export interface FilterRegistryProjectionOptions {
+    readonly sourceId?: SourceId;
+    readonly includeDisabled?: boolean;
+}
+export interface FilterRegistryQueryProjectionOptions extends FilterRegistryProjectionOptions {
+    readonly baseQuery?: Query;
+    readonly source?: Pick<SourceDescriptor, "id" | "protocol" | "capabilities">;
+}
+export interface FilterRegistryQueryProjection {
+    readonly query: Query;
+    readonly where?: string;
+    readonly projection: WidgetSourceProjection;
+    readonly linkedView: LinkedViewQueryProjection;
+    readonly runtimeFilter?: RuntimeStyleFilterExpression;
+    readonly degraded?: readonly DegradedReason[];
+    readonly cacheKey: string;
+    readonly cacheable: boolean;
+}
+/** Create an in-memory filter registry with owner-scoped mutation helpers. */
+export declare function createFilterRegistry(options?: CreateFilterRegistryOptions): FilterRegistry;
+/** Return active clauses in deterministic id order, optionally source-scoped. */
+export declare function selectActiveFilterClauses(snapshot: FilterRegistrySnapshot, options?: FilterRegistryProjectionOptions): readonly FilterClause[];
+/** Project active registry clauses into query/widget/linked-view/runtime state. */
+export declare function projectFilterRegistryToQuery(snapshot: FilterRegistrySnapshot, options?: FilterRegistryQueryProjectionOptions): FilterRegistryQueryProjection;
+/** Project active clauses directly into a `WidgetSourceProjection`. */
+export declare function projectFilterRegistryToWidgetProjection(snapshot: FilterRegistrySnapshot, options?: FilterRegistryProjectionOptions): WidgetSourceProjection;
+/** Project active clauses into the linked-view projection consumed by existing helpers. */
+export declare function projectFilterRegistryToLinkedView(snapshot: FilterRegistrySnapshot, options?: FilterRegistryQueryProjectionOptions): LinkedViewQueryProjection;
+/** Compile active field clauses into a MapLibre-compatible expression tree. */
+export declare function compileRuntimeStyleFilter(clauses: readonly FilterClause[]): RuntimeStyleFilterExpression | undefined;
+/** Deterministic URL/cache serialization. Secret or large values are omitted. */
+export declare function serializeFilterRegistry(snapshot: FilterRegistrySnapshot, options?: FilterRegistryProjectionOptions): string;
+/** Parse a registry serialization produced by `serializeFilterRegistry`. */
+export declare function parseFilterRegistry(value: string | null | undefined): FilterRegistrySnapshot;
+//# sourceMappingURL=index.d.ts.map

package/filter-registry/index.d.ts.map

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