@ztgkzhaohao/geo-effect-kit 0.3.0 → 0.4.0

package/dist/scan-cone-expansion.d.ts

@@ -0,0 +1,29 @@
+export interface ScanConeExpansionFrame {
+    progress: number;
+    radiusMeters: number;
+    lengthMeters: number;
+    elapsedMs: number;
+}
+export type ScanConeExpansionStatus = 'idle' | 'running' | 'paused' | 'completed' | 'cancelled';
+export interface ScanConeExpansionState extends ScanConeExpansionFrame {
+    status: ScanConeExpansionStatus;
+}
+export interface ScanConeExpansionOptions {
+    maxRadiusMeters: number;
+    durationMs?: number;
+    cameraFollow?: boolean;
+    autoStart?: boolean;
+    onFrame?: (state: ScanConeExpansionState) => void;
+    onComplete?: (state: ScanConeExpansionState) => void;
+}
+export interface NormalizedScanConeExpansionOptions {
+    maxRadiusMeters: number;
+    durationMs: number;
+    cameraFollow: boolean;
+    autoStart: boolean;
+    onFrame?: (state: ScanConeExpansionState) => void;
+    onComplete?: (state: ScanConeExpansionState) => void;
+}
+export declare function normalizeScanConeExpansionOptions(options: ScanConeExpansionOptions): NormalizedScanConeExpansionOptions;
+export declare function sampleScanConeExpansionFrame(options: NormalizedScanConeExpansionOptions, finalLengthMeters: number, elapsedMs: number): ScanConeExpansionFrame;
+//# sourceMappingURL=scan-cone-expansion.d.ts.map

package/dist/scan-cone-expansion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-cone-expansion.d.ts","sourceRoot":"","sources":["../src/scan-cone-expansion.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAA;AAE/F,MAAM,WAAW,sBAAuB,SAAQ,sBAAsB;IACpE,MAAM,EAAE,uBAAuB,CAAA;CAChC;AAED,MAAM,WAAW,wBAAwB;IACvC,eAAe,EAAE,MAAM,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAA;IACjD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAA;CACrD;AAED,MAAM,WAAW,kCAAkC;IACjD,eAAe,EAAE,MAAM,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,OAAO,CAAA;IACrB,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAA;IACjD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAA;CACrD;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,wBAAwB,GAChC,kCAAkC,CAiBpC;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,kCAAkC,EAC3C,iBAAiB,EAAE,MAAM,EACzB,SAAS,EAAE,MAAM,GAChB,sBAAsB,CAcxB"}

package/dist/scan-cone-expansion.js

@@ -0,0 +1,47 @@
+export function normalizeScanConeExpansionOptions(options) {
+    const maxRadiusMeters = Number.isFinite(options.maxRadiusMeters) && options.maxRadiusMeters > 0
+        ? Math.max(1, options.maxRadiusMeters)
+        : 1;
+    const requestedDurationMs = options.durationMs;
+    const durationMs = requestedDurationMs !== undefined && Number.isFinite(requestedDurationMs)
+        ? clamp(requestedDurationMs, 100, 120000)
+        : 4500;
+    return {
+        maxRadiusMeters,
+        durationMs,
+        cameraFollow: options.cameraFollow ?? false,
+        autoStart: options.autoStart ?? true,
+        ...(options.onFrame ? { onFrame: options.onFrame } : {}),
+        ...(options.onComplete ? { onComplete: options.onComplete } : {}),
+    };
+}
+export function sampleScanConeExpansionFrame(options, finalLengthMeters, elapsedMs) {
+    const safeElapsedMs = clampElapsedMs(elapsedMs, options.durationMs);
+    const linearProgress = safeElapsedMs / options.durationMs;
+    const progress = easeInOutCubic(linearProgress);
+    const safeLengthMeters = Number.isFinite(finalLengthMeters) && finalLengthMeters > 0
+        ? Math.max(1, finalLengthMeters)
+        : 1;
+    return {
+        progress,
+        radiusMeters: options.maxRadiusMeters * progress,
+        lengthMeters: safeLengthMeters * progress,
+        elapsedMs: safeElapsedMs,
+    };
+}
+function clamp(value, minimum, maximum) {
+    return Math.min(maximum, Math.max(minimum, value));
+}
+function clampElapsedMs(elapsedMs, durationMs) {
+    if (Number.isNaN(elapsedMs) || elapsedMs === Number.NEGATIVE_INFINITY)
+        return 0;
+    if (elapsedMs === Number.POSITIVE_INFINITY)
+        return durationMs;
+    return clamp(elapsedMs, 0, durationMs);
+}
+function easeInOutCubic(progress) {
+    return progress < 0.5
+        ? 4 * progress * progress * progress
+        : 1 - ((-2 * progress + 2) ** 3) / 2;
+}
+//# sourceMappingURL=scan-cone-expansion.js.map

package/dist/scan-cone-expansion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-cone-expansion.js","sourceRoot":"","sources":["../src/scan-cone-expansion.ts"],"names":[],"mappings":"AA+BA,MAAM,UAAU,iCAAiC,CAC/C,OAAiC;IAEjC,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,OAAO,CAAC,eAAe,GAAG,CAAC;QAC7F,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;QACtC,CAAC,CAAC,CAAC,CAAA;IACL,MAAM,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAA;IAC9C,MAAM,UAAU,GAAG,mBAAmB,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAC1F,CAAC,CAAC,KAAK,CAAC,mBAAmB,EAAE,GAAG,EAAE,MAAM,CAAC;QACzC,CAAC,CAAC,IAAI,CAAA;IAER,OAAO;QACL,eAAe;QACf,UAAU;QACV,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,KAAK;QAC3C,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;QACpC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClE,CAAA;AACH,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,OAA2C,EAC3C,iBAAyB,EACzB,SAAiB;IAEjB,MAAM,aAAa,GAAG,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,CAAA;IACnE,MAAM,cAAc,GAAG,aAAa,GAAG,OAAO,CAAC,UAAU,CAAA;IACzD,MAAM,QAAQ,GAAG,cAAc,CAAC,cAAc,CAAC,CAAA;IAC/C,MAAM,gBAAgB,GAAG,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,iBAAiB,GAAG,CAAC;QAClF,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,CAAC;QAChC,CAAC,CAAC,CAAC,CAAA;IAEL,OAAO;QACL,QAAQ;QACR,YAAY,EAAE,OAAO,CAAC,eAAe,GAAG,QAAQ;QAChD,YAAY,EAAE,gBAAgB,GAAG,QAAQ;QACzC,SAAS,EAAE,aAAa;KACzB,CAAA;AACH,CAAC;AAED,SAAS,KAAK,CAAC,KAAa,EAAE,OAAe,EAAE,OAAe;IAC5D,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA;AACpD,CAAC;AAED,SAAS,cAAc,CAAC,SAAiB,EAAE,UAAkB;IAC3D,IAAI,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,SAAS,KAAK,MAAM,CAAC,iBAAiB;QAAE,OAAO,CAAC,CAAA;IAC/E,IAAI,SAAS,KAAK,MAAM,CAAC,iBAAiB;QAAE,OAAO,UAAU,CAAA;IAC7D,OAAO,KAAK,CAAC,SAAS,EAAE,CAAC,EAAE,UAAU,CAAC,CAAA;AACxC,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB;IACtC,OAAO,QAAQ,GAAG,GAAG;QACnB,CAAC,CAAC,CAAC,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ;QACpC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;AACxC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ztgkzhaohao/geo-effect-kit",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "type": "module",
   "description": "Framework-neutral Cesium effects SDK for geospatial visualizations.",
   "license": "MIT",