@theseam/ui-common 1.0.2-beta.51 → 1.0.2-beta.57

package/states-counties-map/index.d.ts

@@ -0,0 +1,120 @@
+import * as _angular_core from '@angular/core';
+import { InjectionToken, Provider } from '@angular/core';
+import { Feature, Geometry } from 'geojson';
+import { Topology } from 'topojson-specification';
+import { ComponentHarness, TestElement } from '@angular/cdk/testing';
+
+/**
+ * Payload emitted by `countyClick` / `countyEnter` / `countyLeave` outputs.
+ *
+ * `id` is the FIPS county code as a string (e.g., `"01001"`), matching the
+ * format consumers pass to `selectedCountyIds`. `feature` is the raw
+ * GeoJSON feature produced by `topojson.feature(...)`.
+ */
+interface TheSeamStatesCountiesMapCountyEvent {
+    readonly id: string;
+    readonly feature: Feature<Geometry>;
+}
+
+declare class TheSeamStatesCountiesMapComponent {
+    /** FIPS state code (e.g., `"48"` for Texas). Null/undefined renders nothing. */
+    readonly stateNumber: _angular_core.InputSignal<string | null | undefined>;
+    /** FIPS county codes to highlight with the `county-selected` class. */
+    readonly selectedCountyIds: _angular_core.InputSignal<readonly string[]>;
+    /** Enable pointer interaction (click, enter, leave) on counties. */
+    readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly countyClick: _angular_core.OutputEmitterRef<TheSeamStatesCountiesMapCountyEvent>;
+    readonly countyEnter: _angular_core.OutputEmitterRef<TheSeamStatesCountiesMapCountyEvent>;
+    readonly countyLeave: _angular_core.OutputEmitterRef<TheSeamStatesCountiesMapCountyEvent>;
+    private readonly _wrapper;
+    private readonly _data;
+    private _topologyPromise;
+    private _lastRenderedState;
+    private _lastRenderedInteractive;
+    private _renderSerial;
+    constructor();
+    private _loadTopology;
+    private _render;
+    private _updateSelectedCounties;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TheSeamStatesCountiesMapComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TheSeamStatesCountiesMapComponent, "seam-states-counties-map", never, { "stateNumber": { "alias": "stateNumber"; "required": false; "isSignal": true; }; "selectedCountyIds": { "alias": "selectedCountyIds"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; }, { "countyClick": "countyClick"; "countyEnter": "countyEnter"; "countyLeave": "countyLeave"; }, never, never, true, never>;
+}
+
+/** Configuration for `TheSeamStatesCountiesMapComponent`. */
+interface TheSeamStatesCountiesMapConfig {
+    /**
+     * URL to the TopoJSON topology file.
+     *
+     * Defaults to `/assets/geoData/us.json` when the token is not provided.
+     * The file is not shipped with the library — each consuming app must
+     * place a compatible topology at this path or provide a different URL
+     * via `provideStatesCountiesMap({ topologyUrl })`.
+     */
+    readonly topologyUrl?: string;
+}
+/** Default URL used when no config is provided. */
+declare const THE_SEAM_STATES_COUNTIES_MAP_DEFAULT_URL = "/assets/geoData/us.json";
+/** DI token for `TheSeamStatesCountiesMapConfig`. */
+declare const THE_SEAM_STATES_COUNTIES_MAP_CONFIG: InjectionToken<TheSeamStatesCountiesMapConfig>;
+/**
+ * Register configuration for the states-counties map.
+ *
+ * ```ts
+ * bootstrapApplication(AppComponent, {
+ *   providers: [
+ *     provideStatesCountiesMap({ topologyUrl: '/static/us.json' }),
+ *   ],
+ * })
+ * ```
+ */
+declare function provideStatesCountiesMap(config: TheSeamStatesCountiesMapConfig): Provider;
+
+/**
+ * Loads and caches TopoJSON topology data for the states/counties map.
+ *
+ * Provided in root so that multiple component instances share a single
+ * in-flight/cached request per URL.
+ */
+declare class TheSeamStatesCountiesMapDataService {
+    private readonly _config;
+    private readonly _cache;
+    /**
+     * Load the topology from the configured URL (or an explicit override).
+     * Concurrent calls for the same URL share a single fetch promise.
+     */
+    load(url?: string): Promise<Topology>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TheSeamStatesCountiesMapDataService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<TheSeamStatesCountiesMapDataService>;
+}
+
+/**
+ * Harness for `TheSeamStatesCountiesMapComponent`. Designed for use in both
+ * TestBed and Storybook (via `@marklb/storybook-harness`).
+ */
+declare class TheSeamStatesCountiesMapHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly _wrapper;
+    private readonly _svg;
+    /** Whether the SVG has been rendered yet. */
+    hasRendered(): Promise<boolean>;
+    /** Returns all county path elements that have been rendered. */
+    getCountyPaths(): Promise<TestElement[]>;
+    /** Returns the path for a single county by its FIPS id, or null. */
+    getCountyPath(countyId: string): Promise<TestElement | null>;
+    /** Ids of every county currently marked `county-selected`. */
+    getSelectedCountyIds(): Promise<string[]>;
+    /** Click a county by FIPS id. Throws if the county is not rendered. */
+    clickCounty(countyId: string): Promise<void>;
+    /** Simulate pointer entering a county area. Throws if the county is not rendered. */
+    enterCounty(countyId: string): Promise<void>;
+    /** Simulate pointer leaving a county area by hovering away from it. */
+    leaveCounty(countyId: string): Promise<void>;
+    /** Rendered viewport dimensions, for layout-sensitive assertions. */
+    getWrapperSize(): Promise<{
+        width: number;
+        height: number;
+    }>;
+}
+
+export { THE_SEAM_STATES_COUNTIES_MAP_CONFIG, THE_SEAM_STATES_COUNTIES_MAP_DEFAULT_URL, TheSeamStatesCountiesMapComponent, TheSeamStatesCountiesMapDataService, TheSeamStatesCountiesMapHarness, provideStatesCountiesMap };
+export type { TheSeamStatesCountiesMapConfig, TheSeamStatesCountiesMapCountyEvent };

package/states-counties-map/package.json

@@ -0,0 +1,3 @@
+{
+  "module": "../fesm2022/theseam-ui-common-states-counties-map.mjs"
+}