@rytass/wms-map-react-components 0.1.10 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (97) hide show
  1. package/components/breadcrumb/breadcrumb-edit-modal.cjs +92 -0
  2. package/components/breadcrumb/breadcrumb-edit-modal.d.cts +9 -0
  3. package/components/breadcrumb/breadcrumb-edit-modal.module.scss.cjs +5 -0
  4. package/components/breadcrumb/breadcrumb.cjs +171 -0
  5. package/components/breadcrumb/breadcrumb.d.cts +11 -0
  6. package/components/breadcrumb/breadcrumb.d.ts +1 -1
  7. package/components/breadcrumb/breadcrumb.module.scss.cjs +5 -0
  8. package/components/canvas/react-flow-canvas.cjs +321 -0
  9. package/components/canvas/react-flow-canvas.d.cts +38 -0
  10. package/components/canvas/react-flow-canvas.d.ts +1 -1
  11. package/components/canvas/react-flow-canvas.module.scss.cjs +5 -0
  12. package/components/modal/wms-map-content.cjs +808 -0
  13. package/components/modal/wms-map-content.d.cts +4 -0
  14. package/components/modal/wms-map-content.d.ts +1 -1
  15. package/components/modal/wms-map-modal-container.cjs +130 -0
  16. package/components/modal/wms-map-modal-container.d.cts +5 -0
  17. package/components/modal/wms-map-modal-container.d.ts +1 -1
  18. package/components/modal/wms-map-modal-container.module.scss.cjs +5 -0
  19. package/components/nodes/base-node.d.cts +12 -0
  20. package/components/nodes/base-node.d.ts +1 -1
  21. package/components/nodes/image-node.cjs +236 -0
  22. package/components/nodes/image-node.d.cts +17 -0
  23. package/components/nodes/image-node.d.ts +1 -1
  24. package/components/nodes/image-node.module.scss.cjs +5 -0
  25. package/components/nodes/path-node.cjs +553 -0
  26. package/components/nodes/path-node.d.cts +19 -0
  27. package/components/nodes/path-node.d.ts +1 -1
  28. package/components/nodes/path-node.module.scss.cjs +5 -0
  29. package/components/nodes/rectangle-node.cjs +239 -0
  30. package/components/nodes/rectangle-node.d.cts +11 -0
  31. package/components/nodes/rectangle-node.d.ts +1 -1
  32. package/components/nodes/rectangle-node.module.scss.cjs +5 -0
  33. package/components/ui/context-menu.cjs +171 -0
  34. package/components/ui/context-menu.d.cts +25 -0
  35. package/components/ui/context-menu.module.scss.cjs +5 -0
  36. package/components/ui/toolbar.cjs +286 -0
  37. package/components/ui/toolbar.d.cts +23 -0
  38. package/components/ui/toolbar.d.ts +1 -1
  39. package/components/ui/toolbar.module.scss.cjs +5 -0
  40. package/components/ui/view-mode-toolbar.cjs +44 -0
  41. package/components/ui/view-mode-toolbar.d.cts +9 -0
  42. package/components/ui/view-mode-toolbar.d.ts +1 -1
  43. package/components/ui/view-mode-toolbar.module.scss.cjs +5 -0
  44. package/constants/index.cjs +54 -0
  45. package/constants/index.d.cts +45 -0
  46. package/constants/index.d.ts +2 -2
  47. package/constants/text-mappings.cjs +46 -0
  48. package/constants/text-mappings.d.cts +181 -0
  49. package/hooks/use-context-menu.cjs +231 -0
  50. package/hooks/use-context-menu.d.cts +37 -0
  51. package/hooks/use-context-menu.d.ts +1 -1
  52. package/hooks/use-direct-state-history.cjs +217 -0
  53. package/hooks/use-direct-state-history.d.cts +58 -0
  54. package/hooks/use-direct-state-history.d.ts +2 -2
  55. package/hooks/use-pen-drawing.cjs +366 -0
  56. package/hooks/use-pen-drawing.d.cts +30 -0
  57. package/hooks/use-pen-drawing.d.ts +1 -1
  58. package/hooks/use-rectangle-drawing.cjs +139 -0
  59. package/hooks/use-rectangle-drawing.d.cts +19 -0
  60. package/hooks/use-rectangle-drawing.d.ts +1 -1
  61. package/hooks/use-text-editing.cjs +156 -0
  62. package/hooks/use-text-editing.d.cts +19 -0
  63. package/icons/index.cjs +233 -0
  64. package/icons/index.d.cts +16 -0
  65. package/index.cjs +26 -0
  66. package/index.d.cts +5 -0
  67. package/index.d.ts +5 -5
  68. package/package.json +68 -3
  69. package/types/callback.types.d.cts +7 -0
  70. package/types/callback.types.d.ts +1 -1
  71. package/types/canvas.types.d.cts +35 -0
  72. package/types/canvas.types.d.ts +1 -1
  73. package/types/component-props.types.d.cts +45 -0
  74. package/types/component-props.types.d.ts +2 -2
  75. package/types/history.types.d.cts +24 -0
  76. package/types/history.types.d.ts +2 -2
  77. package/types/index.d.cts +5 -0
  78. package/types/index.d.ts +5 -5
  79. package/types/react-flow.types.d.cts +30 -0
  80. package/typings.cjs +44 -0
  81. package/typings.d.cts +136 -0
  82. package/utils/api-data-transform.cjs +221 -0
  83. package/utils/api-data-transform.d.cts +33 -0
  84. package/utils/api-data-transform.d.ts +1 -1
  85. package/utils/color-utils.cjs +58 -0
  86. package/utils/color-utils.d.cts +17 -0
  87. package/utils/debug-logger.cjs +45 -0
  88. package/utils/debug-logger.d.cts +33 -0
  89. package/utils/map-data-transform.cjs +360 -0
  90. package/utils/map-data-transform.d.cts +18 -0
  91. package/utils/map-data-transform.d.ts +1 -1
  92. package/utils/node-operations.cjs +88 -0
  93. package/utils/node-operations.d.cts +26 -0
  94. package/utils/node-utils.cjs +40 -0
  95. package/utils/node-utils.d.cts +10 -0
  96. package/index.cjs.css +0 -1
  97. package/index.cjs.js +0 -5128
@@ -0,0 +1,24 @@
1
+ import { EditMode } from '../typings.cjs';
2
+ import { FlowNode, FlowEdge } from './react-flow.types.cjs';
3
+ export interface HistoryState {
4
+ nodes: FlowNode[];
5
+ edges: FlowEdge[];
6
+ editMode: EditMode;
7
+ operation: string;
8
+ timestamp: number;
9
+ }
10
+ export interface HistoryOperation {
11
+ index: number;
12
+ operation: string;
13
+ nodes: number;
14
+ edges: number;
15
+ isCurrent: boolean;
16
+ }
17
+ export interface HistorySummary {
18
+ canUndo: boolean;
19
+ canRedo: boolean;
20
+ historyLength: number;
21
+ currentIndex: number;
22
+ currentOperation?: string;
23
+ operations?: HistoryOperation[];
24
+ }
@@ -1,5 +1,5 @@
1
- import { EditMode } from '../typings';
2
- import { FlowNode, FlowEdge } from './react-flow.types';
1
+ import { EditMode } from '../typings.js';
2
+ import { FlowNode, FlowEdge } from './react-flow.types.js';
3
3
  export interface HistoryState {
4
4
  nodes: FlowNode[];
5
5
  edges: FlowEdge[];
@@ -0,0 +1,5 @@
1
+ export * from './react-flow.types.cjs';
2
+ export * from './canvas.types.cjs';
3
+ export * from './history.types.cjs';
4
+ export * from './component-props.types.cjs';
5
+ export * from './callback.types.cjs';
package/types/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
- export * from './react-flow.types';
2
- export * from './canvas.types';
3
- export * from './history.types';
4
- export * from './component-props.types';
5
- export * from './callback.types';
1
+ export * from './react-flow.types.js';
2
+ export * from './canvas.types.js';
3
+ export * from './history.types.js';
4
+ export * from './component-props.types.js';
5
+ export * from './callback.types.js';
@@ -0,0 +1,30 @@
1
+ import { Node, Edge, NodeChange, EdgeChange } from '@xyflow/react';
2
+ export interface NodeDataBase {
3
+ [key: string]: unknown;
4
+ }
5
+ export interface FlowNode extends Node {
6
+ id: string;
7
+ type: string;
8
+ position: {
9
+ x: number;
10
+ y: number;
11
+ };
12
+ zIndex?: number;
13
+ selectable?: boolean;
14
+ draggable?: boolean;
15
+ deletable?: boolean;
16
+ data: NodeDataBase;
17
+ }
18
+ export interface FlowEdge extends Edge {
19
+ id: string;
20
+ source: string;
21
+ target: string;
22
+ }
23
+ export interface FlowNodesChangeHandler {
24
+ (changes: NodeChange<FlowNode>[]): void;
25
+ }
26
+ export interface FlowEdgesChangeHandler {
27
+ (changes: EdgeChange[]): void;
28
+ }
29
+ export type FlowNodeChange = NodeChange<FlowNode>;
30
+ export type FlowEdgeChange = EdgeChange;
package/typings.cjs ADDED
@@ -0,0 +1,44 @@
1
+ 'use strict';
2
+
3
+ var MapRangeColor = /*#__PURE__*/ function(MapRangeColor) {
4
+ MapRangeColor["RED"] = "RED";
5
+ MapRangeColor["YELLOW"] = "YELLOW";
6
+ MapRangeColor["GREEN"] = "GREEN";
7
+ MapRangeColor["BLUE"] = "BLUE";
8
+ MapRangeColor["BLACK"] = "BLACK";
9
+ return MapRangeColor;
10
+ }({});
11
+ var MapRangeType = /*#__PURE__*/ function(MapRangeType) {
12
+ MapRangeType["RECTANGLE"] = "RECTANGLE";
13
+ MapRangeType["POLYGON"] = "POLYGON";
14
+ return MapRangeType;
15
+ }({});
16
+ var EditMode = /*#__PURE__*/ function(EditMode) {
17
+ EditMode["BACKGROUND"] = "BACKGROUND";
18
+ EditMode["LAYER"] = "LAYER";
19
+ return EditMode;
20
+ }({});
21
+ var DrawingMode = /*#__PURE__*/ function(DrawingMode) {
22
+ DrawingMode["NONE"] = "NONE";
23
+ DrawingMode["RECTANGLE"] = "RECTANGLE";
24
+ DrawingMode["PEN"] = "PEN";
25
+ return DrawingMode;
26
+ }({});
27
+ var LayerDrawingTool = /*#__PURE__*/ function(LayerDrawingTool) {
28
+ LayerDrawingTool["SELECT"] = "SELECT";
29
+ LayerDrawingTool["RECTANGLE"] = "RECTANGLE";
30
+ LayerDrawingTool["PEN"] = "PEN";
31
+ return LayerDrawingTool;
32
+ }({});
33
+ var ViewMode = /*#__PURE__*/ function(ViewMode) {
34
+ ViewMode["EDIT"] = "EDIT";
35
+ ViewMode["VIEW"] = "VIEW";
36
+ return ViewMode;
37
+ }({});
38
+
39
+ exports.DrawingMode = DrawingMode;
40
+ exports.EditMode = EditMode;
41
+ exports.LayerDrawingTool = LayerDrawingTool;
42
+ exports.MapRangeColor = MapRangeColor;
43
+ exports.MapRangeType = MapRangeType;
44
+ exports.ViewMode = ViewMode;
package/typings.d.cts ADDED
@@ -0,0 +1,136 @@
1
+ export type ID = string;
2
+ export declare enum MapRangeColor {
3
+ RED = "RED",
4
+ YELLOW = "YELLOW",
5
+ GREEN = "GREEN",
6
+ BLUE = "BLUE",
7
+ BLACK = "BLACK"
8
+ }
9
+ export declare enum MapRangeType {
10
+ RECTANGLE = "RECTANGLE",
11
+ POLYGON = "POLYGON"
12
+ }
13
+ interface MapRange {
14
+ id: ID;
15
+ type: MapRangeType;
16
+ color: string;
17
+ }
18
+ export interface MapBackground {
19
+ id: ID;
20
+ filename: string;
21
+ x: number;
22
+ y: number;
23
+ width: number;
24
+ height: number;
25
+ }
26
+ export interface Map {
27
+ id: ID;
28
+ backgrounds: MapBackground[];
29
+ ranges: MapRange[];
30
+ }
31
+ export interface MapRectangleRange extends MapRange {
32
+ type: MapRangeType.RECTANGLE;
33
+ x: number;
34
+ y: number;
35
+ width: number;
36
+ height: number;
37
+ }
38
+ export interface MapPolygonRangePoint {
39
+ x: number;
40
+ y: number;
41
+ }
42
+ export interface MapPolygonRange extends MapRange {
43
+ type: MapRangeType.POLYGON;
44
+ points: MapPolygonRangePoint[];
45
+ }
46
+ export declare enum EditMode {
47
+ BACKGROUND = "BACKGROUND",
48
+ LAYER = "LAYER"
49
+ }
50
+ export declare enum DrawingMode {
51
+ NONE = "NONE",
52
+ RECTANGLE = "RECTANGLE",
53
+ PEN = "PEN"
54
+ }
55
+ export declare enum LayerDrawingTool {
56
+ SELECT = "SELECT",
57
+ RECTANGLE = "RECTANGLE",
58
+ PEN = "PEN"
59
+ }
60
+ export declare enum ViewMode {
61
+ EDIT = "EDIT",
62
+ VIEW = "VIEW"
63
+ }
64
+ /**
65
+ * 圖形點擊資訊基礎介面
66
+ */
67
+ export interface NodeClickInfo {
68
+ id: ID;
69
+ type: string;
70
+ position: {
71
+ x: number;
72
+ y: number;
73
+ };
74
+ zIndex?: number;
75
+ selected?: boolean;
76
+ }
77
+ /**
78
+ * 背景圖片點擊資訊
79
+ */
80
+ export interface ImageNodeClickInfo extends NodeClickInfo {
81
+ type: 'imageNode';
82
+ imageData: {
83
+ filename: string;
84
+ size: {
85
+ width: number;
86
+ height: number;
87
+ };
88
+ originalSize: {
89
+ width: number;
90
+ height: number;
91
+ };
92
+ imageUrl: string;
93
+ };
94
+ mapBackground: MapBackground;
95
+ }
96
+ /**
97
+ * 矩形圖形點擊資訊
98
+ */
99
+ export interface RectangleNodeClickInfo extends NodeClickInfo {
100
+ type: 'rectangleNode';
101
+ rectangleData: {
102
+ color: string;
103
+ size: {
104
+ width: number;
105
+ height: number;
106
+ };
107
+ };
108
+ mapRectangleRange: MapRectangleRange;
109
+ }
110
+ /**
111
+ * 路徑圖形點擊資訊
112
+ */
113
+ export interface PathNodeClickInfo extends NodeClickInfo {
114
+ type: 'pathNode';
115
+ pathData: {
116
+ color: string;
117
+ strokeWidth: number;
118
+ pointCount: number;
119
+ points: {
120
+ x: number;
121
+ y: number;
122
+ }[];
123
+ bounds: {
124
+ minX: number;
125
+ minY: number;
126
+ maxX: number;
127
+ maxY: number;
128
+ } | null;
129
+ };
130
+ mapPolygonRange: MapPolygonRange;
131
+ }
132
+ /**
133
+ * 所有圖形點擊資訊的聯合類型
134
+ */
135
+ export type WMSNodeClickInfo = ImageNodeClickInfo | RectangleNodeClickInfo | PathNodeClickInfo;
136
+ export {};
@@ -0,0 +1,221 @@
1
+ 'use strict';
2
+
3
+ var typings = require('../typings.cjs');
4
+
5
+ /**
6
+ * 將 API 資料轉換為 React Flow 節點格式
7
+ * 這個函數是 transformNodesToMapData 的反向操作
8
+ */ const transformApiDataToNodes = (mapData, imageUrlGenerator)=>{
9
+ // 轉換背景圖片為 ImageNode
10
+ const backgroundNodes = mapData.backgrounds.map((background, index)=>{
11
+ const imageUrl = imageUrlGenerator ? imageUrlGenerator(background.filename) : background.filename;
12
+ return {
13
+ id: background.id,
14
+ type: 'imageNode',
15
+ position: {
16
+ x: background.x,
17
+ y: background.y
18
+ },
19
+ data: {
20
+ imageUrl,
21
+ fileName: background.filename,
22
+ width: background.width,
23
+ height: background.height,
24
+ originalWidth: background.width,
25
+ originalHeight: background.height
26
+ },
27
+ zIndex: index + 1,
28
+ draggable: true,
29
+ selectable: true
30
+ };
31
+ });
32
+ // 轉換範圍為對應的節點,使用 functional 方式處理
33
+ const rangeNodes = mapData.ranges.map((range, index)=>{
34
+ const baseZIndex = backgroundNodes.length + index + 1;
35
+ if (range.type === typings.MapRangeType.RECTANGLE) {
36
+ const rectRange = range;
37
+ return {
38
+ id: rectRange.id,
39
+ type: 'rectangleNode',
40
+ position: {
41
+ x: rectRange.x,
42
+ y: rectRange.y
43
+ },
44
+ data: {
45
+ width: rectRange.width,
46
+ height: rectRange.height,
47
+ color: rectRange.color,
48
+ label: rectRange.id
49
+ },
50
+ zIndex: baseZIndex,
51
+ draggable: true,
52
+ selectable: true
53
+ };
54
+ } else if (range.type === typings.MapRangeType.POLYGON) {
55
+ const polyRange = range;
56
+ // 將絕對座標轉換為相對於中心點的座標
57
+ const relativePoints = polyRange.points.map((point)=>({
58
+ x: point.x,
59
+ y: point.y
60
+ }));
61
+ return {
62
+ id: polyRange.id,
63
+ type: 'pathNode',
64
+ position: {
65
+ x: Math.min(...polyRange.points.map((p)=>p.x)),
66
+ y: Math.min(...polyRange.points.map((p)=>p.y))
67
+ },
68
+ data: {
69
+ points: relativePoints,
70
+ color: polyRange.color,
71
+ label: polyRange.id,
72
+ strokeWidth: 2
73
+ },
74
+ zIndex: baseZIndex,
75
+ draggable: true,
76
+ selectable: true
77
+ };
78
+ }
79
+ return null;
80
+ }).filter((node)=>node !== null);
81
+ return [
82
+ ...backgroundNodes,
83
+ ...rangeNodes
84
+ ];
85
+ };
86
+ /**
87
+ * 驗證 API 資料格式是否正確
88
+ */ const validateMapData = (data)=>{
89
+ if (!data || typeof data !== 'object') {
90
+ return false;
91
+ }
92
+ const obj = data;
93
+ // 檢查必要欄位
94
+ if (!obj.id || typeof obj.id !== 'string') {
95
+ console.error('Map data validation failed: missing or invalid id');
96
+ return false;
97
+ }
98
+ if (!Array.isArray(obj.backgrounds)) {
99
+ console.error('Map data validation failed: backgrounds must be an array');
100
+ return false;
101
+ }
102
+ if (!Array.isArray(obj.ranges)) {
103
+ console.error('Map data validation failed: ranges must be an array');
104
+ return false;
105
+ }
106
+ // 驗證背景資料
107
+ for (const bg of obj.backgrounds){
108
+ if (!bg.id || !bg.filename || typeof bg.x !== 'number' || typeof bg.y !== 'number') {
109
+ console.error('Map data validation failed: invalid background data', bg);
110
+ return false;
111
+ }
112
+ }
113
+ // 驗證範圍資料
114
+ for (const range of obj.ranges){
115
+ if (!range.id || !range.type || !range.color) {
116
+ console.error('Map data validation failed: invalid range data', range);
117
+ return false;
118
+ }
119
+ if (range.type === typings.MapRangeType.RECTANGLE) {
120
+ if (typeof range.x !== 'number' || typeof range.y !== 'number' || typeof range.width !== 'number' || typeof range.height !== 'number') {
121
+ console.error('Map data validation failed: invalid rectangle range data', range);
122
+ return false;
123
+ }
124
+ } else if (range.type === typings.MapRangeType.POLYGON) {
125
+ if (!Array.isArray(range.points) || range.points.length < 3) {
126
+ console.error('Map data validation failed: invalid polygon range data', range);
127
+ return false;
128
+ }
129
+ for (const point of range.points){
130
+ if (typeof point.x !== 'number' || typeof point.y !== 'number') {
131
+ console.error('Map data validation failed: invalid polygon point', point);
132
+ return false;
133
+ }
134
+ }
135
+ }
136
+ }
137
+ return true;
138
+ };
139
+ /**
140
+ * 使用範例:模擬從 API 載入資料
141
+ */ const loadMapDataFromApi = async (mapId)=>{
142
+ try {
143
+ // 模擬 API 呼叫
144
+ console.log(`🌐 模擬載入地圖資料: ${mapId}`);
145
+ // 在實際應用中,這裡會是真實的 API 呼叫
146
+ // const response = await fetch(`/api/maps/${mapId}`);
147
+ // const mapData = await response.json();
148
+ // TODO: 實際應用中需要替換為真實的 API 呼叫
149
+ // 這裡暫時提供示例數據結構
150
+ const mockMapData = {
151
+ id: mapId,
152
+ images: [],
153
+ ranges: []
154
+ };
155
+ // 驗證資料格式
156
+ if (!validateMapData(mockMapData)) {
157
+ throw new Error('Invalid map data format');
158
+ }
159
+ // 轉換為 React Flow 節點
160
+ const generateMockImageUrl = (filename)=>{
161
+ return `data:image/svg+xml,${encodeURIComponent(`<svg xmlns="http://www.w3.org/2000/svg" width="100" height="100"><rect width="100" height="100" fill="#f0f0f0"/><text x="50" y="50" text-anchor="middle" dy=".3em" font-family="Arial" font-size="12">${filename}</text></svg>`)}`;
162
+ };
163
+ const nodes = transformApiDataToNodes(mockMapData, generateMockImageUrl);
164
+ console.log(`✅ 成功載入 ${nodes.length} 個節點`);
165
+ console.log('📊 節點統計:', {
166
+ imageNodes: nodes.filter((n)=>n.type === 'imageNode').length,
167
+ rectangleNodes: nodes.filter((n)=>n.type === 'rectangleNode').length,
168
+ pathNodes: nodes.filter((n)=>n.type === 'pathNode').length
169
+ });
170
+ return nodes;
171
+ } catch (error) {
172
+ console.error('❌ 載入地圖資料失敗:', error);
173
+ throw error;
174
+ }
175
+ };
176
+ /**
177
+ * 輔助函數:計算多邊形的邊界框
178
+ */ const calculatePolygonBounds = (points)=>{
179
+ if (points.length === 0) {
180
+ return {
181
+ minX: 0,
182
+ minY: 0,
183
+ maxX: 0,
184
+ maxY: 0,
185
+ width: 0,
186
+ height: 0
187
+ };
188
+ }
189
+ const xs = points.map((p)=>p.x);
190
+ const ys = points.map((p)=>p.y);
191
+ const minX = Math.min(...xs);
192
+ const maxX = Math.max(...xs);
193
+ const minY = Math.min(...ys);
194
+ const maxY = Math.max(...ys);
195
+ return {
196
+ minX,
197
+ maxX,
198
+ minY,
199
+ maxY,
200
+ width: maxX - minX,
201
+ height: maxY - minY
202
+ };
203
+ };
204
+ /**
205
+ * 輔助函數:為節點計算合適的 zIndex
206
+ */ const calculateNodeZIndex = (nodes, nodeType)=>{
207
+ const maxZIndex = Math.max(...nodes.map((n)=>n.zIndex || 0), 0);
208
+ // 背景圖片應該在最底層
209
+ if (nodeType === 'imageNode') {
210
+ const imageNodes = nodes.filter((n)=>n.type === 'imageNode');
211
+ return imageNodes.length;
212
+ }
213
+ // 其他節點在圖片之上
214
+ return maxZIndex + 1;
215
+ };
216
+
217
+ exports.calculateNodeZIndex = calculateNodeZIndex;
218
+ exports.calculatePolygonBounds = calculatePolygonBounds;
219
+ exports.loadMapDataFromApi = loadMapDataFromApi;
220
+ exports.transformApiDataToNodes = transformApiDataToNodes;
221
+ exports.validateMapData = validateMapData;
@@ -0,0 +1,33 @@
1
+ import { Node } from '@xyflow/react';
2
+ import { Map } from '../typings.cjs';
3
+ /**
4
+ * 將 API 資料轉換為 React Flow 節點格式
5
+ * 這個函數是 transformNodesToMapData 的反向操作
6
+ */
7
+ export declare const transformApiDataToNodes: (mapData: Map, imageUrlGenerator?: (filename: string) => string) => Node[];
8
+ /**
9
+ * 驗證 API 資料格式是否正確
10
+ */
11
+ export declare const validateMapData: (data: unknown) => data is Map;
12
+ /**
13
+ * 使用範例:模擬從 API 載入資料
14
+ */
15
+ export declare const loadMapDataFromApi: (mapId: string) => Promise<Node[]>;
16
+ /**
17
+ * 輔助函數:計算多邊形的邊界框
18
+ */
19
+ export declare const calculatePolygonBounds: (points: {
20
+ x: number;
21
+ y: number;
22
+ }[]) => {
23
+ minX: number;
24
+ maxX: number;
25
+ minY: number;
26
+ maxY: number;
27
+ width: number;
28
+ height: number;
29
+ };
30
+ /**
31
+ * 輔助函數:為節點計算合適的 zIndex
32
+ */
33
+ export declare const calculateNodeZIndex: (nodes: Node[], nodeType: string) => number;
@@ -1,5 +1,5 @@
1
1
  import { Node } from '@xyflow/react';
2
- import { Map } from '../typings';
2
+ import { Map } from '../typings.js';
3
3
  /**
4
4
  * 將 API 資料轉換為 React Flow 節點格式
5
5
  * 這個函數是 transformNodesToMapData 的反向操作
@@ -0,0 +1,58 @@
1
+ 'use strict';
2
+
3
+ /**
4
+ * 顏色亮度計算工具函數
5
+ * 用於在檢視模式下創建 hover 效果
6
+ */ /**
7
+ * 將十六進制顏色轉換為 RGB
8
+ */ function hexToRgb(hex) {
9
+ // 移除 # 符號
10
+ const cleanHex = hex.replace('#', '');
11
+ // 支援 3 位元和 6 位元的十六進制顏色
12
+ const shorthandRegex = /^([a-f\d])([a-f\d])([a-f\d])$/i;
13
+ const fullHex = cleanHex.replace(shorthandRegex, (_m, r, g, b)=>r + r + g + g + b + b);
14
+ const result = /^([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(fullHex);
15
+ return result ? {
16
+ r: parseInt(result[1], 16),
17
+ g: parseInt(result[2], 16),
18
+ b: parseInt(result[3], 16)
19
+ } : null;
20
+ }
21
+ /**
22
+ * 將 RGB 轉換為十六進制顏色
23
+ */ function rgbToHex(r, g, b) {
24
+ const toHex = (n)=>{
25
+ const hex = Math.round(Math.max(0, Math.min(255, n))).toString(16);
26
+ return hex.length === 1 ? '0' + hex : hex;
27
+ };
28
+ return `#${toHex(r)}${toHex(g)}${toHex(b)}`;
29
+ }
30
+ /**
31
+ * 提高顏色亮度
32
+ * @param color - 十六進制顏色字串 (例如: #ff0000)
33
+ * @param percentage - 亮度提高的百分比 (例如: 15 表示提高 15%)
34
+ * @returns 提高亮度後的十六進制顏色字串
35
+ */ function increaseBrightness(color, percentage) {
36
+ const rgb = hexToRgb(color);
37
+ if (!rgb) {
38
+ console.warn(`Invalid color format: ${color}`);
39
+ return color;
40
+ }
41
+ // 計算亮度增加的因子
42
+ const factor = 1 + percentage / 100;
43
+ // 應用亮度增加,但不能超過 255
44
+ const newR = Math.min(255, rgb.r * factor);
45
+ const newG = Math.min(255, rgb.g * factor);
46
+ const newB = Math.min(255, rgb.b * factor);
47
+ return rgbToHex(newR, newG, newB);
48
+ }
49
+ /**
50
+ * 創建 hover 效果顏色(亮度提高 15%)
51
+ * @param color - 原始顏色
52
+ * @returns hover 效果的顏色
53
+ */ function createHoverColor(color) {
54
+ return increaseBrightness(color, 25);
55
+ }
56
+
57
+ exports.createHoverColor = createHoverColor;
58
+ exports.increaseBrightness = increaseBrightness;
@@ -0,0 +1,17 @@
1
+ /**
2
+ * 顏色亮度計算工具函數
3
+ * 用於在檢視模式下創建 hover 效果
4
+ */
5
+ /**
6
+ * 提高顏色亮度
7
+ * @param color - 十六進制顏色字串 (例如: #ff0000)
8
+ * @param percentage - 亮度提高的百分比 (例如: 15 表示提高 15%)
9
+ * @returns 提高亮度後的十六進制顏色字串
10
+ */
11
+ export declare function increaseBrightness(color: string, percentage: number): string;
12
+ /**
13
+ * 創建 hover 效果顏色(亮度提高 15%)
14
+ * @param color - 原始顏色
15
+ * @returns hover 效果的顏色
16
+ */
17
+ export declare function createHoverColor(color: string): string;
@@ -0,0 +1,45 @@
1
+ 'use strict';
2
+
3
+ /**
4
+ * 簡化的 Debug Console 管理系統
5
+ * 只有開啟/關閉功能,可透過 WmsMapModal props 控制
6
+ * 使用命名空間避免污染全域範圍
7
+ */ // WmsMapModal 專用的 debug 命名空間
8
+ const WMS_DEBUG_NAMESPACE = '__WMS_MAP_DEBUG__';
9
+ // 取得 WmsMapModal 專用的 debug 狀態
10
+ const getWmsDebugState = ()=>{
11
+ return Boolean(window[WMS_DEBUG_NAMESPACE]);
12
+ };
13
+ // 設定 WmsMapModal 專用的 debug 狀態
14
+ const setWmsDebugState = (enabled)=>{
15
+ window[WMS_DEBUG_NAMESPACE] = enabled;
16
+ };
17
+ /**
18
+ * 設定 debug 模式 (僅限 WmsMapModal 範圍)
19
+ */ const setDebugMode = (enabled)=>{
20
+ setWmsDebugState(enabled);
21
+ };
22
+ /**
23
+ * 主要的 debug logger 函數
24
+ */ const debugLog = (message, ...args)=>{
25
+ if (!getWmsDebugState()) {
26
+ return;
27
+ }
28
+ const timestamp = new Date().toLocaleTimeString();
29
+ const prefix = `🔧 ${timestamp} [WMS]`;
30
+ console.log(prefix, message, ...args);
31
+ };
32
+ /**
33
+ * 成功 debug log
34
+ */ const debugSuccess = (message, ...args)=>{
35
+ if (!getWmsDebugState()) {
36
+ return;
37
+ }
38
+ const timestamp = new Date().toLocaleTimeString();
39
+ const prefix = `✅ ${timestamp} [WMS]`;
40
+ console.log(prefix, message, ...args);
41
+ };
42
+
43
+ exports.debugLog = debugLog;
44
+ exports.debugSuccess = debugSuccess;
45
+ exports.setDebugMode = setDebugMode;
@@ -0,0 +1,33 @@
1
+ /**
2
+ * 簡化的 Debug Console 管理系統
3
+ * 只有開啟/關閉功能,可透過 WmsMapModal props 控制
4
+ * 使用命名空間避免污染全域範圍
5
+ */
6
+ /**
7
+ * 設定 debug 模式 (僅限 WmsMapModal 範圍)
8
+ */
9
+ export declare const setDebugMode: (enabled: boolean) => void;
10
+ /**
11
+ * 取得 debug 模式狀態 (僅限 WmsMapModal 範圍)
12
+ */
13
+ export declare const getDebugMode: () => boolean;
14
+ /**
15
+ * 主要的 debug logger 函數
16
+ */
17
+ export declare const debugLog: (message: string, ...args: (string | number | object)[]) => void;
18
+ /**
19
+ * 成功 debug log
20
+ */
21
+ export declare const debugSuccess: (message: string, ...args: (string | number | object)[]) => void;
22
+ /**
23
+ * 錯誤 debug log
24
+ */
25
+ export declare const debugError: (message: string, error?: unknown) => void;
26
+ /**
27
+ * 警告 debug log
28
+ */
29
+ export declare const debugWarn: (message: string, ...args: (string | number | object)[]) => void;
30
+ /**
31
+ * 群組化的 debug log
32
+ */
33
+ export declare const debugGroup: (groupName: string, callback: () => void) => void;