map_view_vue3 0.0.0-stage → 0.0.2

package/package.json

@@ -1,6 +1,13 @@
 {
   "name": "map_view_vue3",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.2",
+  "description": "",
+  "main": "map_view_vue3.js",
+  "types": "types/index.d.ts",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC"
+}

package/types/index.d.ts

@@ -0,0 +1,404 @@
+import type { DefineComponent } from 'vue';
+
+export type MapViewerTheme = 'light' | 'dark';
+export type MapViewerSourceCategory = 'raster' | 'vector';
+export type MapViewerTab = 'image' | 'tiles' | 'url' | 'geojson';
+export type MapViewerToastType = 'info' | 'ok' | 'warn' | 'err';
+
+export type Extent4 = [number, number, number, number];
+export type ExtentInput = Extent4 | number[] | string | null;
+
+export interface CrsOption {
+  code: string;
+  name: string;
+  def?: string;
+  geoBox?: Extent4;
+  pixel?: boolean;
+}
+
+export interface CrsGroup {
+  label: string;
+  items: CrsOption[];
+}
+
+export interface AutoLoadImageConfig {
+  type: 'image';
+  url: string;
+  name?: string | null;
+  crs?: string | null;
+  worldFile?: string | null;
+  worldText?: string | null;
+  extent?: ExtentInput;
+}
+
+export interface AutoLoadManifestConfig {
+  type: 'manifest';
+  url: string;
+  baseUrl?: string;
+}
+
+export type AutoLoadConfig = AutoLoadImageConfig | AutoLoadManifestConfig;
+
+export interface MapViewerProps {
+  theme?: MapViewerTheme;
+  dataCrs?: string;
+  zoom?: number;
+  hidePanels?: boolean;
+  width?: string | number | null;
+  height?: string | number | null;
+  mapBackground?: string | null;
+  autoLoad?: AutoLoadConfig | null;
+}
+
+export interface MapViewerEmits {
+  (e: 'theme-changed', theme: MapViewerTheme): void;
+  (e: 'view-changed', state: MapViewerViewState): void;
+  (e: 'active-map-changed', payload: { id: number; name: string; kind: string }): void;
+  (e: 'map-removed', payload: { id: number; name: string; kind: string }): void;
+  (e: 'layer-removed', payload: { isGroup: boolean; name: string; layerCount: number | null; group: string | null }): void;
+  (e: 'notify', payload: { message: string; type: string }): void;
+}
+
+export interface MapViewerViewState {
+  center: number[] | null;
+  zoom: number | null;
+  crs: string;
+}
+
+export interface MapViewerActiveMapInfo {
+  id: number;
+  name: string;
+  kind: string;
+  dataCrs: string;
+  viewCrs: string;
+  extent: number[] | null;
+  sublayerCount: number;
+  center: number[] | null;
+  zoom: number | null;
+}
+
+export interface MapInfoState {
+  active: boolean;
+  name: string;
+  kind: string;
+  dataCrs: string;
+  extent: string;
+}
+
+export interface MapExtentState {
+  minx: string | number;
+  miny: string | number;
+  maxx: string | number;
+  maxy: string | number;
+}
+
+export interface MapViewerFormState {
+  dataCrs: string;
+  viewCrs: string;
+  urlExtentCrs: string;
+  imgFileName: string;
+  worldFileName: string;
+  zoneHint: { message: string; options: CrsOption[] };
+  tilesDirName: string;
+  tilesInfo: string;
+  tilesTms: boolean;
+  geojsonDirName: string;
+  geojsonInfo: string;
+  geojsonCrsHint: string;
+  geojsonCrsOptions: CrsOption[];
+  urlTemplate: string;
+  urlInfo: string;
+  urlMinzoom: string | number;
+  urlMaxzoom: string | number;
+  customEpsg: string | number;
+}
+
+export interface Sublayer {
+  name: string;
+  kind: string;
+  layer: unknown;
+  visible: boolean;
+  group?: string | null;
+  groupVisible?: boolean;
+  featureCount?: number;
+}
+
+export interface MapEntry {
+  id: number;
+  name: string;
+  kind: string;
+  projection: unknown;
+  sourceCrs?: string | null;
+  viewProjectionCode: string;
+  extent?: number[] | null;
+  sublayers: Sublayer[];
+  viewState?: { center: number[]; resolution: number } | null;
+  layer: unknown;
+  sources?: Array<{ refresh(): void }>;
+  cleanup?: () => void;
+  expandedLayerGroups?: Set<string>;
+}
+
+export interface MapListItem {
+  id: number;
+  entry: MapEntry;
+  active: boolean;
+  icon: string;
+  name: string;
+  meta: string;
+}
+
+export interface LayerRow {
+  type: 'layer' | 'group';
+  key?: string;
+  name: string;
+  meta?: string;
+  visible?: boolean;
+  collapsed?: boolean;
+  sublayer?: Sublayer;
+  children?: Array<{ key: string; name: string; meta: string; visible: boolean; sublayer: Sublayer }>;
+}
+
+export interface MapViewerLoadImageOptions {
+  url: string;
+  name?: string | null;
+  crs?: string | null;
+  worldFileUrl?: string | null;
+  worldText?: string | null;
+  extent?: ExtentInput;
+}
+
+export interface MapViewerGeoJsonLayerData {
+  name: string;
+  geojson: string | Record<string, unknown>;
+  sld?: string | Record<string, unknown> | null;
+}
+
+export interface AddImageFromUrlOptions {
+  url: string;
+  name: string;
+  worldText?: string | null;
+  extent?: ExtentInput;
+  crs?: string | null;
+}
+
+export interface GeoJsonPair {
+  file: File;
+  sld?: File | null;
+  layerTitle?: string;
+}
+
+export interface MapViewerXyzOptions {
+  url: string;
+  crs?: string;
+  minZoom?: number;
+  maxZoom?: number;
+  extent?: ExtentInput;
+  extentCrs?: string | null;
+}
+
+export interface ManifestEntry {
+  url: string;
+  type?: string | null;
+  name?: string | null;
+  crs?: string | null;
+  worldFile?: string | null;
+  worldText?: string | null;
+  extent?: ExtentInput;
+  sld?: string | null;
+}
+
+export interface ManifestLayerItem {
+  name?: string;
+  title?: string;
+  geojson?: string;
+  sld?: string;
+  crs?: string;
+  worldFile?: string;
+  worldText?: string;
+  extent?: ExtentInput;
+}
+
+export interface ManifestInput {
+  files?: Array<string | ManifestEntry>;
+  layers?: ManifestLayerItem[];
+}
+
+export type ManifestLike = Array<string | ManifestEntry | ManifestLayerItem> | ManifestInput;
+
+export interface MapViewerInstance {
+  viewerReady: boolean;
+  sidebarWidth: number;
+  loadingTasks: number;
+  olLoading: boolean;
+  dropVisible: boolean;
+  sourceCategory: MapViewerSourceCategory;
+  currentTab: MapViewerTab;
+  loadDialogVisible: boolean;
+  sidebarCollapsed: boolean;
+  panelRightCollapsed: boolean;
+  isLight: boolean;
+  themeIcon: string;
+  themeTitle: string;
+  statusInfo: string;
+  toastText: string;
+  toastType: MapViewerToastType;
+  toastVisible: boolean;
+  mapInfo: MapInfoState;
+  mapListItems: MapListItem[];
+  layerListVisible: boolean;
+  layerListHint: string;
+  layerTotal: number;
+  layerFeatureTotal: number;
+  layerListItems: LayerRow[];
+  crsOptions: { dataCrs: CrsGroup[]; viewCrs: CrsGroup[]; urlExtentCrs: CrsGroup[] };
+  customCrsOptions: CrsOption[];
+  mapExtent: MapExtentState;
+  viewExtent: MapExtentState;
+  form: MapViewerFormState;
+
+  initViewer(): void;
+  pushLoading(): void;
+  popLoading(): void;
+  startSidebarResize(event: MouseEvent): void;
+  collapseSidebar(): void;
+  expandSidebar(): void;
+  collapsePanelRight(): void;
+  expandPanelRight(): void;
+  toggleTheme(): void;
+  loadToMap(): Promise<void> | void;
+  destroyViewer(): void;
+  createFitAllControl(): unknown;
+  gkDef(cm: number, x0: number): string;
+  addGroup(label: string, items: CrsOption[]): void;
+  buildCrsOptionGroups(includePixel?: boolean): CrsGroup[];
+  refillCrsSelects(): void;
+  ensureProjection(code: string): unknown;
+  formatCoord(coord: number[]): string;
+  attachViewListener(): void;
+  fmtRes(resolution: number): string;
+  updateStatus(): void;
+  updateMapExtent(): void;
+  updateViewExtent(): void;
+  fmtExtentInput(value: number | string): string;
+  toast(message: string, type?: MapViewerToastType): void;
+  kindIcon(kind: string): string;
+  selectAndFitMap(entry: MapEntry): void;
+  renderMapList(): void;
+  renderMapInfo(): void;
+  inferGeoJsonGroup(features: unknown[]): string | null;
+  buildLayerGroups(sublayers: Sublayer[]): LayerRow[];
+  isLayerEffectivelyVisible(sublayer: Sublayer): boolean;
+  renderLayerList(): void;
+  toggleLayerVisible(row: LayerRow): void;
+  toggleLayerGroupExpanded(row: LayerRow): void;
+  toggleLayerGroupVisible(row: LayerRow): void;
+  toggleLayerChildVisible(row: LayerRow, child: unknown): void;
+  getVectorSourceExtent(sublayer: Sublayer): number[] | null;
+  zoomToLayer(row: LayerRow): void;
+  zoomToLayerGroup(row: LayerRow): void;
+  removeSublayerInternal(sublayer: Sublayer): void;
+  afterLayersRemoved(message?: string): void;
+  removeLayerItem(row: LayerRow): void;
+  removeLayerGroup(row: LayerRow): void;
+  normalizeSublayers(entry: MapEntry): Sublayer[];
+  saveActiveViewState(): void;
+  selectMapEntry(entry: MapEntry): void;
+  addMapEntry(entry: MapEntry): void;
+  deleteMapEntry(entry: MapEntry): void;
+  fitActiveMap(): void;
+  fitToExtent(extent: ExtentInput, projection?: string | object): void;
+  syncViewCrsSelect(): void;
+  computeViewTransition(newProj: unknown): unknown;
+  setViewProjection(proj: string | object, options?: Record<string, any>): void | Promise<void>;
+  worldSquareExtent(proj: unknown): number[] | null;
+  buildTileGrid(proj: unknown, maxZoom: number, minZoom?: number, extentOverride?: number[] | null): unknown;
+  tilesExtent(grid: unknown, stats: unknown): number[] | null;
+  fmtExtentNum(value: number | string): string;
+  extentText(extent: number[] | null): string;
+  extentFromTileMap(tmap: unknown, crsCode: string): number[] | null;
+  scanTileFiles(files: FileList | File[], tms: boolean): unknown;
+  tileStats(tmap: unknown): unknown;
+  clampInt(value: unknown, lo: number, hi: number, defaultValue?: number): number;
+  getImageSize(url: string): Promise<{ width: number; height: number }>;
+  parseWorldFile(text: string): number[];
+  extentFromWorldFile(width: number, height: number, wf: number[]): number[] | null;
+  guessCrsFromExtent(extent: number[] | null): string | null;
+  updateZoneHint(extent: number[] | null): void;
+  applyWorldFileToExtent(): void;
+  readExtentInputs(): number[] | null;
+  onImageFileChosen(file: File): Promise<void>;
+  loadImageLayer(): Promise<void>;
+  addImageFromUrl(options: AddImageFromUrlOptions): Promise<void>;
+  createXyzEntry(template: string, crsCode: string, minZoom?: number | null, maxZoom?: number | null, extentOpt?: { extent: number[]; crs: string } | null): Promise<{ entry?: MapEntry; error?: string }>;
+  loadUrlLayer(): Promise<void>;
+  detectGeoJsonCrsHints(pairs: GeoJsonPair[], token: number): Promise<void>;
+  orderGeoJsonPairsByMetadata(pairs: GeoJsonPair[], metadataFile: File): Promise<{ pairs: GeoJsonPair[]; metadata: Record<string, unknown> | null }>;
+  onTilesDirChosen(fileList: FileList | File[]): void;
+  updateTilesInfo(): void;
+  loadTilesLayer(): void;
+  updateUrlTemplateHint(): void;
+  vectorColor(name: string): string;
+  descendants(root: unknown, localName: string): unknown[];
+  svgParameters(parent: unknown): Record<string, string>;
+  strokeFromParams(params: Record<string, string>, prefix?: string): unknown;
+  parseSldStyles(text: string): unknown[];
+  sldLabelProperty(text: string): string | null;
+  parseCadColor(value: unknown): unknown;
+  parseCadColor24(value: unknown): unknown;
+  resolveGeoJsonCadColor(feature: unknown): unknown;
+  setStyleColor(style: unknown, color: unknown, geometryType: string): void;
+  makeSldStyleFunction(styles: unknown[], labelProperty?: string | null): unknown;
+  defaultVectorStyle(feature: unknown, resolution?: number): unknown;
+  featuresExtent(features: unknown[]): number[] | null;
+  createReprojectingVectorSource(features: unknown[], dataProjection: string | object): unknown;
+  geoJsonCrsCode(object: unknown): string | null;
+  geoJsonCrsChipLabel(code: string, count: number): string;
+  updateGeoJsonCrsHint(codes: Set<string>, checkedCount: number): void;
+  isMetadataJson(file: File): boolean;
+  matchGeoJsonPairs(files: FileList | File[]): unknown[];
+  onGeoJsonDirChosen(fileList: FileList | File[]): void;
+  loadGeoJsonLayers(): Promise<void>;
+  switchViewProjection(): void;
+  registerCustom(code: string, def: string): boolean;
+  fetchAndRegisterEpsg(): Promise<void>;
+  setSourceCategory(category: MapViewerSourceCategory): void;
+  setActiveTab(name: MapViewerTab): void;
+  setSourceCategoryAndDefault(category: MapViewerSourceCategory): void;
+  resetLoadDialog(): void;
+  openLoadDialog(): void;
+  closeLoadDialog(): void;
+  getViewState(): MapViewerViewState | null;
+  getActiveMapInfo(): MapViewerActiveMapInfo | null;
+  addXyzLayer(options?: MapViewerXyzOptions): Promise<MapEntry | null>;
+  loadImageFromUrl(options?: MapViewerLoadImageOptions): Promise<MapEntry | null>;
+  loadGeoJsonFromFiles(files: FileList | File[]): Promise<MapEntry | null>;
+  loadGeoJsonFromManifest(manifest: ManifestLike, baseUrl?: string): Promise<MapEntry | null>;
+  manifestEntries(manifest: ManifestLike): ManifestEntry[];
+  resolveManifestUrl(url: string, baseUrl?: string): string;
+  manifestUrlName(url: string): string;
+  loadGeoJsonFromData(layers: MapViewerGeoJsonLayerData[]): Promise<MapEntry | null>;
+  loadGeoJsonForCurrentSource(): Promise<void>;
+  waitViewerReady(): Promise<void>;
+  processAutoLoad(): Promise<void>;
+  applyTheme(theme: MapViewerTheme): void;
+  readDroppedEntry(entry: DataTransferItem, path?: string): Promise<File[]>;
+  filesFromDataTransfer(dataTransfer: DataTransfer): Promise<File[]>;
+  normalizeEpsg(value: string | number): string | null;
+
+  [key: string]: unknown;
+}
+
+export type MapViewerComponent = DefineComponent<
+  MapViewerProps,
+  MapViewerEmits,
+  MapViewerInstance
+>;
+
+declare const MapViewVue3: MapViewerComponent;
+export default MapViewVue3;
+
+declare module '*.vue' {
+  const component: MapViewerComponent;
+  export default component;
+}