@theseam/ui-common 2.0.1 → 2.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theseam/ui-common",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "peerDependencies": {
     "@angular/cdk": "^20.2.3",
     "@angular/common": "^20.3.0",
@@ -8,6 +8,7 @@
     "@angular/forms": "^20.3.0",
     "@angular/animations": "^20.3.0",
     "@angular/router": "^20.3.0",
+    "@angular/google-maps": "^20.2.3",
     "rxjs": "~7.8.0",
     "@fortawesome/angular-fontawesome": "^0.13.0",
     "@fortawesome/fontawesome-svg-core": "^1.2.35",
@@ -43,6 +44,8 @@
     "@turf/kinks": "^7.2.0",
     "shpjs": "^6.2.0",
     "@types/geojson": "^7946.0.8",
+    "terra-draw": "^1.31.2",
+    "terra-draw-google-maps-adapter": "^1.6.1",
     "tslib": "^2.3.0"
   },
   "repository": {

package/toggle-group/index.d.ts

@@ -1,41 +1,46 @@
 import * as i0 from '@angular/core';
-import { EventEmitter, OnDestroy, AfterViewInit, QueryList } from '@angular/core';
+import { InjectionToken, EventEmitter, QueryList } from '@angular/core';
 import { BooleanInput } from '@angular/cdk/coercion';
 import { ControlValueAccessor } from '@angular/forms';
-import { Observable } from 'rxjs';
 
 declare class ToggleGroupOptionDirective {
-    private readonly _cdr;
+    private readonly _group;
     seamToggleGroupOption: string | undefined | null;
-    get selected(): boolean;
-    set selected(value: boolean);
-    private _selected;
-    /** Internal use only for now. */
-    _canUnselect: boolean;
-    selectionChange: EventEmitter<boolean>;
     get _checkioSelectedClass(): boolean;
     get value(): string | undefined | null;
     static ɵfac: i0.ɵɵFactoryDeclaration<ToggleGroupOptionDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<ToggleGroupOptionDirective, "[seamToggleGroupOption]", ["seamToggleGroupOption"], { "seamToggleGroupOption": { "alias": "seamToggleGroupOption"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; }, { "selectionChange": "selectionChange"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<ToggleGroupOptionDirective, "[seamToggleGroupOption]", ["seamToggleGroupOption"], { "seamToggleGroupOption": { "alias": "seamToggleGroupOption"; "required": false; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * The part of the toggle group that an option needs in order to resolve its own
+ * selected state.
+ *
+ * This exists as a separate token so `ToggleGroupOptionDirective` can reach its
+ * parent group without importing `ToggleGroupDirective`, which would create a
+ * circular import between the two directives.
+ */
+interface TheSeamToggleGroupParent {
+    isSelected(value: string | undefined | null): boolean;
+}
+declare const THESEAM_TOGGLE_GROUP_PARENT: InjectionToken<TheSeamToggleGroupParent>;
+
 declare const TOGGLE_GROUP_VALUE_ACCESSOR: any;
-declare class ToggleGroupDirective implements OnDestroy, AfterViewInit, ControlValueAccessor {
+declare class ToggleGroupDirective implements ControlValueAccessor {
     static ngAcceptInputType_disabled: BooleanInput;
     static ngAcceptInputType_multiple: BooleanInput;
     static ngAcceptInputType_selectionToggleable: BooleanInput;
-    private readonly _ngUnsubscribe;
     val: string | string[] | undefined | null;
     disabled: boolean;
     multiple: boolean;
     selectionToggleable: boolean;
     readonly change: EventEmitter<string | string[] | null | undefined>;
     optionDirectives?: QueryList<ToggleGroupOptionDirective>;
-    options?: Observable<ToggleGroupOptionDirective[]>;
     onChange: any;
     onTouched: any;
-    ngOnDestroy(): void;
-    ngAfterViewInit(): void;
+    private _selectedSet;
+    private _selectedSetSource;
+    private _selectedSetMultiple;
     get value(): string | string[] | undefined | null;
     set value(value: string | string[] | undefined | null);
     writeValue(value: any): void;
@@ -43,11 +48,29 @@ declare class ToggleGroupDirective implements OnDestroy, AfterViewInit, ControlV
     registerOnTouched(fn: any): void;
     setDisabledState(isDisabled: boolean): void;
     isSelected(value: string | undefined | null): boolean;
+    /**
+     * The current selection as a set, rebuilt only when the value (or `multiple`)
+     * changes.
+     *
+     * `isSelected` is called from templates and from every option's host binding,
+     * so it runs several times per option per change detection pass. Hashing the
+     * selection once keeps those lookups O(1) instead of scanning the value array
+     * on every call.
+     *
+     * Invalidation is keyed on the `val` reference rather than done in the `value`
+     * setter, because `val` is also written directly by the `[value]` input, which
+     * does not go through the setter.
+     */
+    private _selected;
+    private _buildSelectedSet;
+    /**
+     * Toggles an option's selected state by value.
+     */
+    toggleOptionSelect(value: string | undefined | null): void;
+    private _selectedCount;
     unselectValue(value: string | undefined | null): void;
     selectValue(value: string | undefined | null): void;
     getOptionDirectiveByValue(value: string): ToggleGroupOptionDirective | null | undefined;
-    private _updateDirectiveStates;
-    private _updateDirectiveState;
     static ɵfac: i0.ɵɵFactoryDeclaration<ToggleGroupDirective, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<ToggleGroupDirective, "[seamToggleGroup]", ["seamToggleGroup"], { "val": { "alias": "value"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; "selectionToggleable": { "alias": "selectionToggleable"; "required": false; }; }, { "change": "change"; }, ["optionDirectives"], never, true, never>;
 }
@@ -58,4 +81,5 @@ declare class TheSeamToggleGroupModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<TheSeamToggleGroupModule>;
 }
 
-export { TOGGLE_GROUP_VALUE_ACCESSOR, TheSeamToggleGroupModule, ToggleGroupDirective, ToggleGroupOptionDirective };
+export { THESEAM_TOGGLE_GROUP_PARENT, TOGGLE_GROUP_VALUE_ACCESSOR, TheSeamToggleGroupModule, ToggleGroupDirective, ToggleGroupOptionDirective };
+export type { TheSeamToggleGroupParent };

package/utils/index.d.ts

@@ -3,7 +3,7 @@ import { ElementRef, QueryList } from '@angular/core';
 import { AbstractControl, ValidatorFn } from '@angular/forms';
 import { Observable } from 'rxjs';
 import { ActivatedRoute, Data, ActivatedRouteSnapshot } from '@angular/router';
-import { FeatureCollection, GeoJSON, Feature, GeoJsonProperties, Geometry, Polygon, MultiPolygon } from 'geojson';
+import { FeatureCollection, GeoJSON, Feature, GeoJsonProperties, Geometry, Polygon, MultiPolygon, Position } from 'geojson';
 import { AreaUnits } from '@turf/helpers';
 
 /**
@@ -234,14 +234,46 @@ declare function readGeoFile(fileOrBuffer: File | ArrayBuffer): Promise<FeatureC
 declare function splitMultiPolygons(featureCollection: FeatureCollection): void;
 
 /**
- * Close all polygons in the GeoJSON.
+ * Close all polygons in the GeoJSON so the first and last position of every
+ * ring are identical.
  *
- * Google Maps requires that polygons be closed, but not all libraries have that
- * requirement. This may add redundent points to the GeoJSON, but it will ensure
- * that the GeoJSON is valid for Google Maps.
+ * Google Maps requires closed polygon rings, but not all libraries produce
+ * them. This is idempotent: rings that are already closed are left unchanged.
  */
 declare function closePolygons(geoJson: FeatureCollection | Feature | Polygon | MultiPolygon): void;
 
+/**
+ * Checks if a single polygon ring's coordinate count violates the given
+ * min/max point bounds. `max` is only applied when it is greater than `min`.
+ */
+declare function polygonViolatesMinMax(coordinateLength: number, min: number, max?: number | undefined): boolean;
+
+/**
+ * Whether a polygon's outer ring has at least `min` distinct vertices.
+ * Ring closure (a repeated first/last point) does not count toward the total,
+ * so this behaves the same for closed and unclosed rings.
+ */
+declare function polygonHasMinDistinctVertices(polygon: Polygon, min?: number): boolean;
+
+/**
+ * Whether `outer` fully contains `inner`, using turf's boolean-contains on the
+ * GeoJSON geometries directly (no Google Maps dependency).
+ */
+declare function polygonContains(outer: Polygon, inner: Polygon): boolean;
+
+/**
+ * Whether a ring is wound clockwise, via the shoelace signed-area sign.
+ * Sum of (x2 - x1) * (y2 + y1) is positive for clockwise rings in standard
+ * (x = lng, y = lat) orientation.
+ */
+declare function ringIsClockwise(ring: Position[]): boolean;
+/**
+ * Append the outer ring of `hole` to `exterior` as an interior ring (a
+ * cutout), wound opposite the exterior ring so it renders as a hole. Returns a
+ * new Polygon; inputs are not mutated.
+ */
+declare function addHoleToPolygon(exterior: Polygon, hole: Polygon): Polygon;
+
 /**
   Moves the item to the new position in the input array. Useful for huge arrays
   where absolute performance is needed.
@@ -452,5 +484,5 @@ interface SanitizeFilenameOptions {
 }
 declare function sanitizeFilename(filename: string, options?: SanitizeFilenameOptions): string;
 
-export { IS_FEATURE_COLLECTION_VALIDATOR_NAME, IS_ONLY_GEOMETRY_TYPES_VALIDATOR_NAME, MIN_MAX_POINTS_VALIDATOR_NAME, NO_EMPTY_FEATURE_COLLECTION_VALIDATOR_NAME, NO_INNER_RINGS_VALIDATOR_NAME, NO_KINKS_VALIDATOR_NAME, PollingTickerOptions, Refreshable, activatedRoutesWithDataProperty, arrayMoveImmutable, arrayMoveMutable, calcPercentage, closePolygons, coerceFeatureCollection, createPadding, deleteProperties, deleteProperty, fileBufferToBlob, fileBufferToObjectUrl, fileDataFromBuffer, fractionalDigitsCount, geoJsonToArea, getAttribute, getClosestWidgetCdkDrag, getControlName, getControlPath, hasAttribute, hasProperty, hasRequiredControl, isAbsoluteUrl, isEmptyInputValue, isEmptyUrlRoute, isFeatureCollectionValidator, isNullOrUndefined, isNullOrUndefinedOrEmpty, isNumeric, isOnlyGeometryTypes, isOnlyGeometryTypesValidator, leafChildRoute, loadStyle, loadStyleSheet, mapEach, mergePolygons, minMaxPointsValidator, noEmptyFeatureCollectionValidator, noInnerRingsValidator, noKinksValidator, notNullOrUndefined, notNullOrUndefinedOrEmpty, observeControlIsDifferent, observeControlStatus, observeControlValid, observeControlValue, observeControlValueChange, observeQueryList, openBlob, padEnd, padStart, phoneNumberMask, pollingTicker, readFileAsDataUrlAsync, readFileAsync, readGeoFile, routeSnapshotPathFull, routeSnapshotPathRelative, sanitizeFilename, splitMultiPolygons, stripOuter, subscriberCount, tapFirst, toggleAttribute, trimRepeated, waitOnConditionAsync, waitOnNonPendingStatus, willHaveDataProp, withoutProperties, withoutProperty, wrapIntoObservable };
+export { IS_FEATURE_COLLECTION_VALIDATOR_NAME, IS_ONLY_GEOMETRY_TYPES_VALIDATOR_NAME, MIN_MAX_POINTS_VALIDATOR_NAME, NO_EMPTY_FEATURE_COLLECTION_VALIDATOR_NAME, NO_INNER_RINGS_VALIDATOR_NAME, NO_KINKS_VALIDATOR_NAME, PollingTickerOptions, Refreshable, activatedRoutesWithDataProperty, addHoleToPolygon, arrayMoveImmutable, arrayMoveMutable, calcPercentage, closePolygons, coerceFeatureCollection, createPadding, deleteProperties, deleteProperty, fileBufferToBlob, fileBufferToObjectUrl, fileDataFromBuffer, fractionalDigitsCount, geoJsonToArea, getAttribute, getClosestWidgetCdkDrag, getControlName, getControlPath, hasAttribute, hasProperty, hasRequiredControl, isAbsoluteUrl, isEmptyInputValue, isEmptyUrlRoute, isFeatureCollectionValidator, isNullOrUndefined, isNullOrUndefinedOrEmpty, isNumeric, isOnlyGeometryTypes, isOnlyGeometryTypesValidator, leafChildRoute, loadStyle, loadStyleSheet, mapEach, mergePolygons, minMaxPointsValidator, noEmptyFeatureCollectionValidator, noInnerRingsValidator, noKinksValidator, notNullOrUndefined, notNullOrUndefinedOrEmpty, observeControlIsDifferent, observeControlStatus, observeControlValid, observeControlValue, observeControlValueChange, observeQueryList, openBlob, padEnd, padStart, phoneNumberMask, pollingTicker, polygonContains, polygonHasMinDistinctVertices, polygonViolatesMinMax, readFileAsDataUrlAsync, readFileAsync, readGeoFile, ringIsClockwise, routeSnapshotPathFull, routeSnapshotPathRelative, sanitizeFilename, splitMultiPolygons, stripOuter, subscriberCount, tapFirst, toggleAttribute, trimRepeated, waitOnConditionAsync, waitOnNonPendingStatus, willHaveDataProp, withoutProperties, withoutProperty, wrapIntoObservable };
 export type { IActivatedRouteWithData, IFileData, PollingActionFn, RefreshableOptions, SanitizeFilenameOptions, SubscriberCountChangedFn };