krackedmaps 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,92 @@
+export interface Point { x: number; y: number; }
+
+export interface StateFeature {
+  slug: string;
+  name: string;
+  type: "state" | "ft";
+  d: string;
+  centroid: Point;
+}
+
+export interface DistrictFeature {
+  slug: string;
+  name: string;
+  state: string;
+  d: string;
+  centroid: Point;
+}
+
+export interface Projection {
+  minx: number; maxy: number; scale: number; pad: number; eastLng: number;
+  shift: number; offX: number; offY: number; viewW: number; viewH: number;
+}
+
+export interface StateMeta { capital?: string; pop?: number; }
+
+export interface MalaysiaMapOptions {
+  /** render the built-in info panel (default true) */
+  panel?: boolean;
+  /** render the built-in hover tooltip (default true) */
+  tooltip?: boolean;
+  /** build the district drill-down layer (default true) */
+  showDistricts?: boolean;
+  /** attach pointer/click/keyboard handlers (default true) */
+  interactive?: boolean;
+  /** scoped Escape-to-step-out (default true) */
+  keyboard?: boolean;
+  /** start with state labels shown (default false) */
+  labels?: boolean;
+  /** slug to select after build */
+  initialState?: string | null;
+  /** preset name ("flat-dark" | "light" | "blueprint" | "batik") or a {cssVar: value} map */
+  theme?: string | Record<string, string> | null;
+  /** per-state metadata, merged over the built-in defaults */
+  meta?: Record<string, StateMeta> | null;
+  /** default choropleth colour ramp */
+  colors?: { from?: string; to?: string };
+  /** override the info-panel body; return an HTML string */
+  renderPanel?: (info: Record<string, unknown>) => string;
+}
+
+export type EventName = "select" | "hover" | "drill";
+
+export interface MalaysiaMapInstance {
+  select(slug: string): void;
+  deselect(): void;
+  focus(slug: string | null): void;
+  drillInto(slug: string | null): void;
+  selectDistrict(key: string): void;
+  addPin(pin: { lng: number; lat: number; label?: string; id?: string }): string;
+  removePin(id: string): void;
+  clearPins(): void;
+  setData(values: Record<string, number>, ramp?: { from?: string; to?: string }): void;
+  clearData(): void;
+  setTheme(theme: string | Record<string, string> | null): void;
+  toggleLabels(force?: boolean): void;
+  on(name: EventName, cb: (payload: any) => void): MalaysiaMapInstance;
+  off(name: EventName, cb: (payload: any) => void): MalaysiaMapInstance;
+  destroy(): void;
+  readonly STATES: StateFeature[];
+  readonly DISTRICTS: DistrictFeature[];
+  readonly META: Record<string, StateMeta>;
+  project(lng: number, lat: number): Point;
+  readonly distByState: Map<string, string[]>;
+  readonly root: HTMLElement;
+  readonly svg: SVGSVGElement;
+}
+
+export function createMalaysiaMap(
+  container: HTMLElement | string,
+  options?: MalaysiaMapOptions
+): MalaysiaMapInstance;
+
+export const STATES: StateFeature[];
+export const DISTRICTS: DistrictFeature[];
+export const PROJECTION: Projection;
+export function project(lng: number, lat: number): Point;
+export const data: {
+  STATES: StateFeature[];
+  DISTRICTS: DistrictFeature[];
+  PROJECTION: Projection;
+  project(lng: number, lat: number): Point;
+};