@honua/react 0.1.12 → 0.1.13

package/columnar/geoarrow-types.d.ts

@@ -0,0 +1,271 @@
+import type { ColumnarBatchIdentityV1, ColumnarBatchLimits, ColumnarBatchV1 } from "./types.js";
+export type { ColumnarBatchIdentityV1 } from "./types.js";
+/** Honua's dependency-free mapping over GeoArrow format 0.2. */
+export declare const HONUA_GEOARROW_LAYOUT_VERSION: "1.0";
+/** GeoArrow specification version implemented by this mapping. */
+export declare const GEOARROW_SPEC_VERSION: "0.2";
+export type GeoArrowGeometryKind = "point" | "linestring" | "polygon";
+export type GeoArrowDimensions = "xy" | "xyz" | "xym" | "xyzm";
+export type GeoArrowCoordinateLayout = "interleaved" | "separated";
+export type GeoArrowEdges = "planar" | "spherical" | "vincenty" | "thomas" | "andoyer" | "karney";
+export type GeoArrowCrsType = "projjson" | "wkt2:2019" | "authority_code" | "srid";
+export type GeoArrowTimestampUnit = "second" | "millisecond" | "microsecond" | "nanosecond";
+/** CRS metadata accepted by GeoArrow: preferably PROJJSON, or an opaque serialized CRS string. */
+export type GeoArrowCrs = string | Readonly<Record<string, unknown>>;
+/** Coordinate dimensions are ordered x, y, then z and/or m according to `dimensions`. */
+export type GeoArrowPosition = readonly number[];
+export type GeoArrowPoint = GeoArrowPosition;
+export type GeoArrowLineString = readonly GeoArrowPosition[];
+export type GeoArrowPolygon = readonly (readonly GeoArrowPosition[])[];
+export interface GeoArrowGeometryColumnBase {
+    readonly field?: string;
+    readonly dimensions?: GeoArrowDimensions;
+    /** Both official layouts are supported; separated is the GeoArrow-recommended default. */
+    readonly coordinateLayout?: GeoArrowCoordinateLayout;
+    readonly crs?: GeoArrowCrs;
+    /** Disambiguates a serialized CRS value; invalid without `crs`. */
+    readonly crsType?: GeoArrowCrsType;
+    readonly edges?: GeoArrowEdges;
+}
+export interface GeoArrowPointColumnInput extends GeoArrowGeometryColumnBase {
+    readonly kind: "point";
+    readonly values: readonly (GeoArrowPoint | null)[];
+}
+export interface GeoArrowLineStringColumnInput extends GeoArrowGeometryColumnBase {
+    readonly kind: "linestring";
+    readonly values: readonly (GeoArrowLineString | null)[];
+}
+export interface GeoArrowPolygonColumnInput extends GeoArrowGeometryColumnBase {
+    readonly kind: "polygon";
+    readonly values: readonly (GeoArrowPolygon | null)[];
+}
+export type GeoArrowGeometryColumnInput = GeoArrowPointColumnInput | GeoArrowLineStringColumnInput | GeoArrowPolygonColumnInput;
+export interface GeoArrowTemporalColumnInput {
+    readonly field: string;
+    readonly unit: GeoArrowTimestampUnit;
+    readonly timezone?: string;
+    /** Signed Arrow timestamp values in the declared unit. */
+    readonly values: readonly (bigint | null)[];
+}
+export interface GeoArrowDictionaryColumnInput {
+    readonly field: string;
+    readonly ordered?: boolean;
+    readonly values: readonly (string | null)[];
+}
+export interface GeoArrowFeatureIdColumnInput {
+    readonly field: string;
+    readonly values: ArrayLike<number>;
+}
+/** Semantic input converted into one normative, independently transferable batch. */
+export interface CreateGeoArrowBatchInput {
+    readonly id: string;
+    readonly sequence: number;
+    readonly rowOffset?: number;
+    readonly schemaId: string;
+    readonly identity: ColumnarBatchIdentityV1;
+    readonly geometry: GeoArrowGeometryColumnInput;
+    readonly temporal?: GeoArrowTemporalColumnInput;
+    readonly dictionary?: GeoArrowDictionaryColumnInput;
+    readonly featureIds?: GeoArrowFeatureIdColumnInput;
+}
+/** Every semantic conversion is bounded; there is no opt-out or unbounded sentinel. */
+export interface GeoArrowConversionLimits extends ColumnarBatchLimits {
+    readonly maxVertices?: number;
+    readonly maxRings?: number;
+    readonly maxDictionaryValues?: number;
+    /** Exact ceiling for newly allocated payload buffers. */
+    readonly maxCopiedBytes?: number;
+}
+/**
+ * One ordered step of the persisted-envelope migration ladder.
+ *
+ * A step is a pure structural rewrite of one parsed envelope. It never receives
+ * the caller's {@link GeoArrowSerializationOptions}, so a migration cannot widen
+ * a bound; every ceiling is enforced against the migrated envelope.
+ */
+export interface GeoArrowEnvelopeMigrationV1 {
+    readonly fromVersion: string;
+    readonly toVersion: string;
+    readonly migrate: (envelope: Readonly<Record<string, unknown>>) => Record<string, unknown>;
+}
+/** Why an envelope version cannot be carried forward to the current layout. */
+export type GeoArrowEnvelopeMigrationRefusal = "unknown-version" | "future-version" | "unreachable-version";
+/** Resolved migration chain for one stored envelope version, or the refusal. */
+export type GeoArrowEnvelopeMigrationPlanV1 = {
+    readonly applicable: true;
+    /** Applied steps in order, as `from->to`; empty when already current. */
+    readonly steps: readonly string[];
+    readonly migrations: readonly GeoArrowEnvelopeMigrationV1[];
+} | {
+    readonly applicable: false;
+    readonly reason: GeoArrowEnvelopeMigrationRefusal;
+    readonly detail: string;
+};
+/** Bounds and migration policy for dependency-free persisted GeoArrow batches. */
+export interface GeoArrowSerializationOptions extends GeoArrowConversionLimits {
+    /** Maximum UTF-8 envelope size accepted or produced. */
+    readonly maxSerializedBytes?: number;
+    /**
+     * Replaces the shipped ladder for this read. Steps still receive only the
+     * parsed envelope, so an injected ladder cannot widen the bounds above.
+     */
+    readonly migrations?: readonly GeoArrowEnvelopeMigrationV1[];
+}
+export interface GeoArrowSerializationMetrics {
+    readonly serializedBytes: number;
+    readonly backingBytes: number;
+    readonly backingBuffers: number;
+    /** Envelope layout version the batch was materialized at, after migration. */
+    readonly envelopeVersion: string;
+    /** Applied migration chain in order, as `from->to`; empty when none ran. */
+    readonly migrations: readonly string[];
+}
+export interface GeoArrowBatchSerializationResult {
+    readonly batch: ColumnarBatchV1;
+    readonly metrics: GeoArrowSerializationMetrics;
+}
+export interface GeoArrowConversionMetrics {
+    readonly rows: number;
+    readonly vertices: number;
+    readonly rings: number;
+    readonly dictionaryValues: number;
+    /** Exact bytes allocated and populated by semantic-to-columnar conversion. */
+    readonly copiedBytes: number;
+    readonly backingBytes: number;
+}
+export interface CreatedGeoArrowBatch {
+    readonly batch: ColumnarBatchV1;
+    readonly metrics: GeoArrowConversionMetrics;
+}
+export interface DecodedGeoArrowRow {
+    readonly geometry: GeoArrowPoint | GeoArrowLineString | GeoArrowPolygon | null;
+    readonly timestamp?: bigint | null;
+    readonly dictionaryValue?: string | null;
+    readonly featureId?: number;
+}
+export interface DecodedGeoArrowBatch {
+    readonly rows: readonly DecodedGeoArrowRow[];
+    readonly metrics: Omit<GeoArrowConversionMetrics, "copiedBytes" | "backingBytes"> & {
+        /** No payload buffer is copied; this count makes row-object materialization explicit. */
+        readonly materializedRows: number;
+    };
+}
+export interface GeoArrowGeometryBuffers {
+    readonly kind: GeoArrowGeometryKind;
+    readonly field: string;
+    readonly dimensions: GeoArrowDimensions;
+    readonly coordinateLayout: GeoArrowCoordinateLayout;
+    readonly crs?: GeoArrowCrs;
+    readonly crsType?: GeoArrowCrsType;
+    readonly edges: GeoArrowEdges;
+    readonly validity?: Uint8Array;
+    readonly offsets?: Int32Array;
+    readonly ringOffsets?: Int32Array;
+    readonly coordinates: Readonly<Record<"x" | "y" | "z" | "m" | "interleaved", Float64Array | undefined>>;
+}
+export interface GeoArrowTemporalBuffers {
+    readonly field: string;
+    readonly unit: GeoArrowTimestampUnit;
+    readonly timezone?: string;
+    readonly validity?: Uint8Array;
+    readonly values: BigInt64Array;
+}
+export interface GeoArrowDictionaryBuffers {
+    readonly field: string;
+    readonly ordered: boolean;
+    readonly validity?: Uint8Array;
+    readonly indices: Int32Array;
+    readonly offsets: Int32Array;
+    readonly values: Uint8Array;
+}
+/** Validated typed views that alias the batch's own backing buffers. */
+export interface GeoArrowBatchInspection {
+    readonly batch: ColumnarBatchV1;
+    readonly geometry: GeoArrowGeometryBuffers;
+    readonly temporal?: GeoArrowTemporalBuffers;
+    readonly dictionary?: GeoArrowDictionaryBuffers;
+    readonly featureIds?: {
+        readonly field: string;
+        readonly values: Uint32Array;
+    };
+    readonly metrics: GeoArrowConversionMetrics;
+}
+/** Structural Apache Arrow data node used without importing peer declarations. */
+export interface ApacheArrowDataLike {
+    readonly length: number;
+    readonly offset: number;
+    readonly values?: ArrayBufferView;
+    readonly nullBitmap?: Uint8Array;
+    readonly valueOffsets?: Int32Array;
+    readonly children: readonly ApacheArrowDataLike[];
+    readonly dictionary?: ApacheArrowVectorLike;
+}
+/** Structural Apache Arrow vector used by the optional adapter. */
+export interface ApacheArrowVectorLike {
+    readonly length: number;
+    readonly data: readonly ApacheArrowDataLike[];
+}
+export interface ApacheArrowFieldLike {
+    readonly name: string;
+    readonly nullable: boolean;
+    readonly metadata: ReadonlyMap<string, string>;
+    readonly type: ApacheArrowTypeLike;
+}
+/** Structural Arrow type metadata needed for schema-safe zero-copy import. */
+export interface ApacheArrowTypeLike {
+    toString(): string;
+    readonly children?: readonly ApacheArrowFieldLike[];
+    readonly isOrdered?: boolean;
+}
+/** Minimum RecordBatch surface accepted and returned by the adapter. */
+export interface ApacheArrowRecordBatchLike {
+    readonly numRows: number;
+    readonly schema: {
+        readonly fields: readonly ApacheArrowFieldLike[];
+        readonly metadata: ReadonlyMap<string, string>;
+    };
+    getChildAt(index: number): ApacheArrowVectorLike | null;
+}
+/** Opaque module namespace for an injected Apache Arrow implementation. */
+export type ApacheArrowModuleLike = Readonly<Record<string, unknown>>;
+export type ApacheArrowModuleImporter = (specifier: string) => Promise<unknown>;
+export interface LoadApacheArrowOptions {
+    readonly importModule?: ApacheArrowModuleImporter;
+}
+export interface ApacheArrowAdapterOptions extends LoadApacheArrowOptions {
+    readonly module?: ApacheArrowModuleLike;
+}
+export interface ApacheArrowAdapterMetrics {
+    readonly rows: number;
+    readonly backingBytes: number;
+    readonly referencedBytes: number;
+    /** Exact payload bytes copied to isolate a foreign shared/padded backing. */
+    readonly copiedBytes: number;
+}
+export interface ApacheArrowRecordBatchResult {
+    readonly recordBatch: ApacheArrowRecordBatchLike;
+    readonly metrics: ApacheArrowAdapterMetrics;
+}
+export interface FromApacheArrowRecordBatchOptions {
+    /** Required with `schemaId` and `identity` when importing a non-Honua RecordBatch. */
+    readonly id?: string;
+    readonly sequence?: number;
+    readonly rowOffset?: number;
+    /** Required with `id` and `identity` when importing a non-Honua RecordBatch. */
+    readonly schemaId?: string;
+    /** Required with `id` and `schemaId` when importing a non-Honua RecordBatch. */
+    readonly identity?: ColumnarBatchIdentityV1;
+    readonly limits?: GeoArrowConversionLimits;
+}
+export interface GeoArrowBatchFromApacheResult {
+    readonly batch: ColumnarBatchV1;
+    readonly metrics: ApacheArrowAdapterMetrics;
+}
+export type HonuaGeoArrowErrorCode = "invalid-input" | "invalid-batch" | "unsupported-layout" | "row-limit-exceeded" | "vertex-limit-exceeded" | "ring-limit-exceeded" | "dictionary-limit-exceeded" | "group-limit-exceeded" | "copy-limit-exceeded" | "serialization-limit-exceeded" | "unsupported-serialization" | "missing-peer";
+/** Typed failures for layout drift, conversion bounds, and optional peers. */
+export declare class HonuaGeoArrowError extends Error {
+    readonly code: HonuaGeoArrowErrorCode;
+    readonly detail?: Readonly<Record<string, unknown>> | undefined;
+    constructor(code: HonuaGeoArrowErrorCode, message: string, detail?: Readonly<Record<string, unknown>> | undefined, options?: ErrorOptions);
+}
+//# sourceMappingURL=geoarrow-types.d.ts.map

package/columnar/geoarrow-types.d.ts.map

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

package/columnar/geoarrow-types.js

@@ -0,0 +1,15 @@
+/** Honua's dependency-free mapping over GeoArrow format 0.2. */
+export const HONUA_GEOARROW_LAYOUT_VERSION = "1.0";
+/** GeoArrow specification version implemented by this mapping. */
+export const GEOARROW_SPEC_VERSION = "0.2";
+/** Typed failures for layout drift, conversion bounds, and optional peers. */
+export class HonuaGeoArrowError extends Error {
+    code;
+    detail;
+    constructor(code, message, detail, options) {
+        super(message, options);
+        this.code = code;
+        this.detail = detail;
+        this.name = "HonuaGeoArrowError";
+    }
+}

package/columnar/geoarrow.d.ts

@@ -0,0 +1,52 @@
+import { type CreateGeoArrowBatchInput, type CreatedGeoArrowBatch, type DecodedGeoArrowBatch, type DecodedGeoArrowRow, type GeoArrowBatchInspection, type GeoArrowConversionLimits, type GeoArrowGeometryBuffers } from "./geoarrow-types.js";
+import { type ColumnarBatchV1 } from "./types.js";
+/**
+ * Payload-validation scope for one inspection.
+ *
+ * `"full"` walks every payload byte the batch declares, which is what an
+ * unbounded consumer needs and what {@link inspectGeoArrowBatch} always does.
+ * `"window"` performs the same structural and schema validation but defers the
+ * per-row payload checks (coordinate finiteness, dictionary index range, and
+ * dictionary UTF-8 decoding) to a caller that reads only a bounded row window
+ * and validates exactly the rows it materializes. It exists so a bounded
+ * conversion stays proportional to its window instead of to the batch.
+ *
+ * @internal
+ */
+export type GeoArrowInspectionScope = "full" | "window";
+/**
+ * Convert bounded semantic geometry/temporal/dictionary values to the normative
+ * Honua GeoArrow mapping. All returned payload buffers are newly owned, exact
+ * copy accounting is returned, and the generic transfer contract remains valid.
+ */
+export declare function createGeoArrowBatch(input: CreateGeoArrowBatchInput, limits?: GeoArrowConversionLimits): CreatedGeoArrowBatch;
+/** Validate the normative mapping and return zero-copy typed-array views. */
+export declare function inspectGeoArrowBatch(batch: ColumnarBatchV1, limits?: GeoArrowConversionLimits): GeoArrowBatchInspection;
+/**
+ * {@link inspectGeoArrowBatch} with an explicit payload-validation scope.
+ *
+ * Only bounded conversions inside this module pass `"window"`, and they must
+ * validate coordinate finiteness, dictionary index range, and dictionary UTF-8
+ * for every row they materialize. It is deliberately absent from the package
+ * surface: an external consumer must not be able to skip payload validation.
+ *
+ * @internal
+ */
+export declare function inspectGeoArrowBatchScoped(batch: ColumnarBatchV1, limits: GeoArrowConversionLimits, scope: GeoArrowInspectionScope): GeoArrowBatchInspection;
+declare function isValid(validity: Uint8Array | undefined, index: number): boolean;
+/**
+ * Row-level primitives shared with the bounded object-`Result` conversion.
+ * They are module exports rather than package exports: `columnar/index.ts`
+ * deliberately does not re-export them.
+ *
+ * @internal
+ */
+export { decodeGeometry as decodeGeoArrowGeometryAt, isValid as isGeoArrowRowValid };
+declare function decodeGeometry(geometry: GeoArrowGeometryBuffers, row: number): DecodedGeoArrowRow["geometry"];
+/**
+ * Explicitly materialize bounded semantic rows. Callers cannot accidentally
+ * decode an unbounded result because the same finite row/vertex/ring limits are
+ * mandatory and defaulted before any row object is created.
+ */
+export declare function decodeGeoArrowBatch(batch: ColumnarBatchV1, limits?: GeoArrowConversionLimits): DecodedGeoArrowBatch;
+//# sourceMappingURL=geoarrow.d.ts.map

package/columnar/geoarrow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geoarrow.d.ts","sourceRoot":"","sources":["../../../src/columnar/geoarrow.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EAEvB,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAO7B,KAAK,uBAAuB,EAW7B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAEL,KAAK,eAAe,EAOrB,MAAM,YAAY,CAAC;AAyBpB;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAgtBxD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,wBAAwB,EAC/B,MAAM,GAAE,wBAA6B,GACpC,oBAAoB,CAiLtB;AA2iBD,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,eAAe,EACtB,MAAM,GAAE,wBAA6B,GACpC,uBAAuB,CAEzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,wBAAwB,EAChC,KAAK,EAAE,uBAAuB,GAC7B,uBAAuB,CAkEzB;AAED,iBAAS,OAAO,CAAC,QAAQ,EAAE,UAAU,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAEzE;AAED;;;;;;GAMG;AACH,OAAO,EAAE,cAAc,IAAI,wBAAwB,EAAE,OAAO,IAAI,kBAAkB,EAAE,CAAC;AAWrF,iBAAS,cAAc,CAAC,QAAQ,EAAE,uBAAuB,EAAE,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAmBtG;AAWD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,EACtB,MAAM,GAAE,wBAA6B,GACpC,oBAAoB,CAkCtB"}