@honua/app-platform 0.0.20-alpha.0

package/exploration/types.d.ts

@@ -0,0 +1,294 @@
+/**
+ * `ExplorationContext` types — the canonical, protocol-neutral exploration
+ * state shared across linked views (map, grid, chart, filters, detail, etc.).
+ *
+ * The runtime in `./context.ts` is a thin reducer + microtask coalescer
+ * over these types; the full design lives in `docs/exploration-context.md`.
+ *
+ * @module
+ */
+import type { AggregationSpec, FeatureId, PaginationSpec, SortSpec, SourceId } from "../contract/types.js";
+import type { SpatialFilter } from "../core/spatial-filter.js";
+import type { HonuaExtent } from "../core/types.js";
+/**
+ * Filter operator vocabulary. Adapter implementations translate these to
+ * GeoServices SQL-92, OGC CQL2, WFS Filter Encoding, OData $filter, etc.
+ * Keep the set protocol-neutral — anything that does not translate
+ * universally belongs in adapter-specific extensions.
+ */
+export type FilterOperator = "=" | "!=" | "<" | "<=" | ">" | ">=" | "in" | "not-in" | "between" | "like" | "is-null" | "is-not-null";
+/**
+ * One global filter clause keyed by field. A `FilterClause` is value-only —
+ * adapters build the protocol-specific WHERE / CQL2 / $filter expression
+ * from `field`, `operator`, and `value` together.
+ */
+export interface FilterClause {
+    field: string;
+    operator: FilterOperator;
+    value?: unknown;
+    /** Optional list of source ids the clause applies to. Empty = all sources. */
+    appliesTo?: ReadonlyArray<SourceId>;
+}
+/**
+ * Immutable exploration-state snapshot. Reducers return a new object on
+ * change; readers compare by reference (`prev.filters !== next.filters`).
+ *
+ * Fields map 1:1 to the slices that views can subscribe to (see
+ * `ExplorationSlice`). Adding a field requires extending the slice union,
+ * the reducer's diff logic, and the linked-view preset table.
+ */
+export interface ExplorationState {
+    /** Global filters keyed by clause id. */
+    readonly filters: Readonly<Record<string, FilterClause>>;
+    /** Optional spatial filter (geometry + relationship). */
+    readonly spatialFilter?: SpatialFilter;
+    /** Current viewport extent. */
+    readonly extent?: HonuaExtent;
+    /**
+     * Currently selected features. Raw ids are supported for single-source apps;
+     * multi-source apps should use source-qualified targets.
+     */
+    readonly selection: ReadonlyArray<FeatureSelectionTarget>;
+    /** Sort order shared across linked views. */
+    readonly sort: ReadonlyArray<SortSpec>;
+    /** Pagination offset / limit. */
+    readonly page: PaginationSpec;
+    /** Field visibility for tabular / form views. Empty = "all". */
+    readonly visibleFields: ReadonlyArray<string>;
+    /** Group-by keys for chart / pivot views. */
+    readonly grouping: ReadonlyArray<string>;
+    /** Aggregation spec (mirrors `Query.aggregation`). */
+    readonly aggregation?: AggregationSpec;
+    /** Active linked-view preset name. */
+    readonly preset: LinkedViewPresetName;
+}
+/** Initial empty state used when none is provided. */
+export declare const EMPTY_STATE: ExplorationState;
+/**
+ * Subscribable slice keys. `"all"` fires for every change; the others fire
+ * only when the corresponding state field actually changes by reference
+ * (the reducer enforces structural equality).
+ */
+export type ExplorationSlice = "all" | "filters" | "spatialFilter" | "extent" | "selection" | "sort" | "page" | "visibleFields" | "grouping" | "aggregation" | "preset";
+/** All slice keys, in declaration order. */
+export declare const SLICES: readonly ExplorationSlice[];
+/**
+ * Tagged union of all dispatchable intents. Reducers exhaustively match
+ * `intent.kind`; downstream tickets that need a new intent must extend this
+ * union rather than introducing parallel dispatch surfaces.
+ *
+ * `viewId` is optional and identifies the originating view so the
+ * linked-view policy can decide whether to propagate to peers.
+ */
+export type ExplorationIntent = SetFilterIntent | ClearFilterIntent | SetSpatialFilterIntent | SetExtentIntent | SelectIntent | DeselectIntent | SetSortIntent | SetPageIntent | SetVisibleFieldsIntent | SetGroupingIntent | SetAggregationIntent | ApplyPresetIntent | SnapshotRestoreIntent;
+interface IntentBase {
+    readonly viewId?: string;
+}
+export interface SetFilterIntent extends IntentBase {
+    readonly kind: "set-filter";
+    readonly id: string;
+    readonly clause: FilterClause;
+}
+export interface ClearFilterIntent extends IntentBase {
+    readonly kind: "clear-filter";
+    readonly id: string;
+}
+export interface SetSpatialFilterIntent extends IntentBase {
+    readonly kind: "set-spatial-filter";
+    readonly spatialFilter: SpatialFilter | undefined;
+}
+export interface SetExtentIntent extends IntentBase {
+    readonly kind: "set-extent";
+    readonly extent: HonuaExtent | undefined;
+}
+export interface SelectIntent extends IntentBase {
+    readonly kind: "select";
+    readonly ids: ReadonlyArray<FeatureSelectionTarget>;
+    /** When `true`, replaces the selection. Default = additive. */
+    readonly replace?: boolean;
+}
+export interface DeselectIntent extends IntentBase {
+    readonly kind: "deselect";
+    /** Omit `ids` to clear the entire selection. */
+    readonly ids?: ReadonlyArray<FeatureSelectionTarget>;
+}
+export interface SetSortIntent extends IntentBase {
+    readonly kind: "set-sort";
+    readonly sort: ReadonlyArray<SortSpec>;
+}
+export interface SetPageIntent extends IntentBase {
+    readonly kind: "set-page";
+    readonly page: PaginationSpec;
+}
+export interface SetVisibleFieldsIntent extends IntentBase {
+    readonly kind: "set-visible-fields";
+    readonly fields: ReadonlyArray<string>;
+}
+export interface SetGroupingIntent extends IntentBase {
+    readonly kind: "set-grouping";
+    readonly grouping: ReadonlyArray<string>;
+}
+export interface SetAggregationIntent extends IntentBase {
+    readonly kind: "set-aggregation";
+    readonly aggregation: AggregationSpec | undefined;
+}
+export interface ApplyPresetIntent extends IntentBase {
+    readonly kind: "apply-preset";
+    readonly preset: LinkedViewPresetName;
+}
+export interface SnapshotRestoreIntent extends IntentBase {
+    readonly kind: "snapshot-restore";
+    readonly snapshot: ExplorationStateSnapshot;
+}
+/**
+ * Serializable snapshot of an `ExplorationState`. Versioned so that future
+ * shape changes can migrate forward. The shape is structurally compatible
+ * with `ExplorationState` minus the live preset enum (carried verbatim).
+ */
+export interface ExplorationStateSnapshot {
+    readonly version: 1;
+    readonly state: ExplorationState;
+}
+/**
+ * Built-in linked-view presets. Each preset declares which slices propagate
+ * from the originating view to its peers.
+ *
+ * - `globalLinked`: every view sees every change. Default.
+ * - `mapDriven`: the map's extent / spatial filter / selection propagates
+ *   outward; filter controls can still contribute filter state.
+ * - `gridDriven`: only the grid's selection / sort / page propagates outward.
+ * - `chartDriven`: only the chart's grouping / aggregation / selection propagates outward.
+ * - `decoupled`: nothing propagates — each view is independent.
+ */
+export type LinkedViewPresetName = "globalLinked" | "mapDriven" | "gridDriven" | "chartDriven" | "decoupled";
+/**
+ * Per-view propagation rule. `propagatesFrom` lists the view roles whose
+ * changes a peer view will accept; `propagatesSlices` lists which state
+ * slices a view contributes when it is the origin.
+ */
+export interface LinkedViewRule {
+    readonly role: ViewRole;
+    readonly propagatesSlices: ReadonlyArray<ExplorationSlice>;
+}
+/**
+ * Coarse role that informs the linked-view policy.
+ *
+ * `form` remains for compatibility with older detail/filter integrations.
+ * New linked-workspace code should prefer the more precise `filter` and
+ * `detail` roles when a component is not a general form surface.
+ */
+export type ViewRole = "map" | "grid" | "chart" | "filter" | "detail" | "form" | "custom";
+export interface LinkedViewPolicy {
+    readonly preset: LinkedViewPresetName;
+    readonly rules: ReadonlyArray<LinkedViewRule>;
+}
+/**
+ * Descriptor a caller passes to `ExplorationContext.bind`. `role` is used
+ * by the linked-view policy. Callers opt into specific slice notifications
+ * by calling `ExplorationContext.subscribe(slice, fn)` directly — the
+ * binding itself only names the view and its role.
+ */
+export interface ViewBinding {
+    readonly id: string;
+    readonly role: ViewRole;
+}
+/** Handle returned from `ExplorationContext.bind`. */
+export interface ViewHandle {
+    readonly id: string;
+    /** Releases the binding. Raw context subscriptions must still be unsubscribed separately. */
+    unbind(): void;
+}
+export interface ChangeEvent {
+    readonly state: ExplorationState;
+    readonly previous: ExplorationState;
+    readonly changedSlices: ReadonlySet<ExplorationSlice>;
+    readonly origin: ExplorationIntent | undefined;
+}
+export type Listener = (event: ChangeEvent) => void;
+export type Unsubscribe = () => void;
+type WithoutViewId<T> = T extends ExplorationIntent ? Omit<T, "viewId"> & {
+    readonly viewId?: never;
+} : never;
+/**
+ * Intent shape accepted by a bound view controller. The controller injects
+ * its own `viewId`, so component code cannot accidentally publish as a peer.
+ */
+export type ExplorationViewIntent = WithoutViewId<ExplorationIntent>;
+export interface ExplorationViewChangeEvent extends ChangeEvent {
+    readonly view: ViewBinding;
+    /** True when the notification originated from the same bound view. */
+    readonly selfOrigin: boolean;
+}
+export type ExplorationViewListener = (event: ExplorationViewChangeEvent) => void;
+export interface ExplorationViewSubscribeOptions {
+    /**
+     * Bound views ignore their own notifications by default to avoid feedback
+     * loops between imperative UI callbacks and synced context updates.
+     */
+    readonly includeSelf?: boolean;
+}
+export type ExplorationViewSubscription = ExplorationSlice | ReadonlyArray<ExplorationSlice>;
+/**
+ * Ergonomic facade for one map, table, chart, filter panel, or custom view.
+ * It binds the view, injects `viewId` on every intent, and owns subscriptions
+ * so component teardown does not leak listeners.
+ */
+export interface ExplorationViewController extends ViewHandle {
+    readonly role: ViewRole;
+    readonly state: ExplorationState;
+    readonly policy: LinkedViewPolicy;
+    dispatch(intent: ExplorationViewIntent): void;
+    subscribe(slice: ExplorationViewSubscription, fn: ExplorationViewListener, options?: ExplorationViewSubscribeOptions): Unsubscribe;
+    setFilter(id: string, clause: FilterClause): void;
+    clearFilter(id: string): void;
+    setSpatialFilter(spatialFilter: SpatialFilter | undefined): void;
+    setExtent(extent: HonuaExtent | undefined): void;
+    select(ids: ReadonlyArray<FeatureSelectionTarget>, options?: {
+        readonly replace?: boolean;
+    }): void;
+    deselect(ids?: ReadonlyArray<FeatureSelectionTarget>): void;
+    setSort(sort: ReadonlyArray<SortSpec>): void;
+    setPage(page: PaginationSpec): void;
+    setVisibleFields(fields: ReadonlyArray<string>): void;
+    setGrouping(grouping: ReadonlyArray<string>): void;
+    setAggregation(aggregation: AggregationSpec | undefined): void;
+    applyPreset(preset: LinkedViewPresetName): void;
+    snapshot(): ExplorationStateSnapshot;
+    restore(snapshot: ExplorationStateSnapshot): void;
+}
+/**
+ * Protocol-neutral container for shared exploration state. One context
+ * normally backs one `Dataset`; multiple views attach via `bind`. State
+ * mutations go through `dispatch` and are visible synchronously to
+ * `state` / `snapshot` but listeners fire on a microtask so a burst of
+ * intents coalesces into a single notification per slice.
+ */
+export interface ExplorationContext {
+    readonly datasetId: string;
+    readonly sourceIds: ReadonlyArray<SourceId>;
+    readonly state: ExplorationState;
+    readonly policy: LinkedViewPolicy;
+    bind(view: ViewBinding): ViewHandle;
+    connectView(view: ViewBinding): ExplorationViewController;
+    dispatch(intent: ExplorationIntent): void;
+    subscribe(slice: ExplorationSlice, fn: Listener): Unsubscribe;
+    snapshot(): ExplorationStateSnapshot;
+    restore(snapshot: ExplorationStateSnapshot): void;
+    /** Releases all bindings, clears listeners, and stops accepting intents. */
+    dispose(): void;
+}
+export interface CreateExplorationContextOptions {
+    datasetId: string;
+    sourceIds: ReadonlyArray<SourceId>;
+    initialState?: Partial<ExplorationState>;
+    preset?: LinkedViewPresetName;
+}
+export interface SourceQualifiedFeatureSelectionTarget {
+    readonly sourceId: SourceId;
+    readonly id: FeatureId;
+    /** Source layer for vector-tile sources or other layered source identities. */
+    readonly sourceLayer?: string;
+}
+export type FeatureSelectionTarget = FeatureId | SourceQualifiedFeatureSelectionTarget;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/exploration/types.d.ts.map

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

package/exploration/types.js

@@ -0,0 +1,33 @@
+/**
+ * `ExplorationContext` types — the canonical, protocol-neutral exploration
+ * state shared across linked views (map, grid, chart, filters, detail, etc.).
+ *
+ * The runtime in `./context.ts` is a thin reducer + microtask coalescer
+ * over these types; the full design lives in `docs/exploration-context.md`.
+ *
+ * @module
+ */
+/** Initial empty state used when none is provided. */
+export const EMPTY_STATE = {
+    filters: {},
+    selection: [],
+    sort: [],
+    page: {},
+    visibleFields: [],
+    grouping: [],
+    preset: "globalLinked",
+};
+/** All slice keys, in declaration order. */
+export const SLICES = [
+    "all",
+    "filters",
+    "spatialFilter",
+    "extent",
+    "selection",
+    "sort",
+    "page",
+    "visibleFields",
+    "grouping",
+    "aggregation",
+    "preset",
+];