@buoy-gg/floating-tools-core 3.0.1 → 4.0.1

package/lib/commonjs/dialUsage.js

@@ -1 +1,130 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.USAGE_MIN_SCORE=exports.USAGE_HALF_LIFE_MS=void 0,exports.decayScore=decayScore,exports.pruneUsage=pruneUsage,exports.rankToolIds=rankToolIds,exports.recordUsage=recordUsage;const USAGE_HALF_LIFE_MS=exports.USAGE_HALF_LIFE_MS=2592e5,USAGE_MIN_SCORE=exports.USAGE_MIN_SCORE=.01;function decayScore(e,r){if(!e||e.score<=0)return 0;const o=r-e.lastUsed;return o<=0?e.score:e.score*Math.pow(.5,o/USAGE_HALF_LIFE_MS)}function recordUsage(e,r,o){const s=decayScore(e[r],o);return{...e,[r]:{score:s+1,lastUsed:o}}}function rankToolIds(e,r,o){const s=e.map((e,s)=>({id:e,index:s,score:decayScore(r[e],o)}));return s.sort((e,r)=>r.score!==e.score?r.score-e.score:e.index-r.index),s.map(e=>e.id)}function pruneUsage(e,r){const o={};for(const[s,c]of Object.entries(e))decayScore(c,r)>USAGE_MIN_SCORE&&(o[s]=c);return o}
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.USAGE_MIN_SCORE = exports.USAGE_HALF_LIFE_MS = void 0;
+exports.decayScore = decayScore;
+exports.pruneUsage = pruneUsage;
+exports.rankToolIds = rankToolIds;
+exports.recordUsage = recordUsage;
+/**
+ * Dial Usage - Recency-weighted usage tracking for the dial menu.
+ *
+ * Pure scoring/ranking logic. No React or platform-specific code.
+ *
+ * The dial menu ranks tools by how recently and frequently they are used.
+ * Each press adds 1 point to a tool's score; that score decays exponentially
+ * over time (half-life ~3 days) so the ordering reflects "what I'm using most
+ * lately" rather than all-time totals.
+ */
+
+// =============================
+// Constants
+// =============================
+
+/**
+ * Half-life of a usage score, in milliseconds (~3 days).
+ * After this much time, an untouched tool's score halves.
+ */
+const USAGE_HALF_LIFE_MS = exports.USAGE_HALF_LIFE_MS = 3 * 24 * 60 * 60 * 1000;
+
+/**
+ * Scores at or below this value are treated as zero. Entries that decay
+ * below it can be safely pruned from storage.
+ */
+const USAGE_MIN_SCORE = exports.USAGE_MIN_SCORE = 0.01;
+
+// =============================
+// Types
+// =============================
+
+/**
+ * A single tool's usage record.
+ */
+
+/** Map of tool id to its usage record. */
+
+// =============================
+// Scoring
+// =============================
+
+/**
+ * Decay a stored score forward to `now`.
+ *
+ * @param entry - The usage entry to evaluate
+ * @param now - Current epoch ms
+ * @returns The score decayed to `now` (never negative)
+ */
+function decayScore(entry, now) {
+  if (!entry || entry.score <= 0) return 0;
+  const elapsed = now - entry.lastUsed;
+  // Guard against clock skew producing a score boost.
+  if (elapsed <= 0) return entry.score;
+  return entry.score * Math.pow(0.5, elapsed / USAGE_HALF_LIFE_MS);
+}
+
+/**
+ * Record a single press of a tool, returning a new usage map.
+ *
+ * The existing score is decayed forward to `now` before adding 1, so a
+ * burst of presses accumulates while stale scores naturally fade.
+ *
+ * @param map - Current usage map
+ * @param id - Tool id that was pressed
+ * @param now - Current epoch ms
+ * @returns A new usage map (input is not mutated)
+ */
+function recordUsage(map, id, now) {
+  const decayed = decayScore(map[id], now);
+  return {
+    ...map,
+    [id]: {
+      score: decayed + 1,
+      lastUsed: now
+    }
+  };
+}
+
+/**
+ * Rank tool ids by decayed usage score, highest first.
+ *
+ * The sort is stable: tools with equal scores (including never-used tools,
+ * which score 0) keep their original order in `orderedIds`. This preserves
+ * registration order as the tie-breaker.
+ *
+ * @param orderedIds - Tool ids in their default/registration order
+ * @param map - Current usage map
+ * @param now - Current epoch ms
+ * @returns A new array of ids sorted by usage
+ */
+function rankToolIds(orderedIds, map, now) {
+  const scored = orderedIds.map((id, index) => ({
+    id,
+    index,
+    score: decayScore(map[id], now)
+  }));
+  scored.sort((a, b) => {
+    if (b.score !== a.score) return b.score - a.score;
+    return a.index - b.index;
+  });
+  return scored.map(entry => entry.id);
+}
+
+/**
+ * Drop entries whose decayed score has fallen below `USAGE_MIN_SCORE`,
+ * keeping the persisted map from growing unbounded.
+ *
+ * @param map - Current usage map
+ * @param now - Current epoch ms
+ * @returns A new, pruned usage map
+ */
+function pruneUsage(map, now) {
+  const pruned = {};
+  for (const [id, entry] of Object.entries(map)) {
+    if (decayScore(entry, now) > USAGE_MIN_SCORE) {
+      pruned[id] = entry;
+    }
+  }
+  return pruned;
+}

package/lib/commonjs/easing.js

@@ -1 +1,69 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.easing=void 0,exports.getEasing=getEasing,exports.interpolate=interpolate,exports.interpolatePosition=interpolatePosition;const easing=exports.easing={linear:e=>e,easeOutCubic:e=>1-Math.pow(1-e,3),easeInCubic:e=>e*e*e,easeInOutCubic:e=>e<.5?4*e*e*e:1-Math.pow(-2*e+2,3)/2,easeOutQuad:e=>1-(1-e)*(1-e),easeOutExpo:e=>1===e?1:1-Math.pow(2,-10*e)};function getEasing(e){return easing[e]}function interpolate(e,t,i,n=easing.easeOutCubic){return e+(t-e)*n(Math.max(0,Math.min(1,i)))}function interpolatePosition(e,t,i,n=easing.easeOutCubic){return{x:interpolate(e.x,t.x,i,n),y:interpolate(e.y,t.y,i,n)}}
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.easing = void 0;
+exports.getEasing = getEasing;
+exports.interpolate = interpolate;
+exports.interpolatePosition = interpolatePosition;
+/**
+ * Animation easing functions.
+ * Platform-agnostic - used by both web (RAF) and mobile (Animated).
+ */
+
+/**
+ * Easing functions for animations.
+ * All functions take progress (0-1) and return eased value (0-1).
+ */
+const easing = exports.easing = {
+  /**
+   * Linear - no easing.
+   */
+  linear: t => t,
+  /**
+   * Ease out cubic - decelerates towards end.
+   * Used for hide/show animations.
+   */
+  easeOutCubic: t => 1 - Math.pow(1 - t, 3),
+  /**
+   * Ease in cubic - accelerates from start.
+   */
+  easeInCubic: t => t * t * t,
+  /**
+   * Ease in-out cubic - smooth acceleration and deceleration.
+   */
+  easeInOutCubic: t => t < 0.5 ? 4 * t * t * t : 1 - Math.pow(-2 * t + 2, 3) / 2,
+  /**
+   * Ease out quad - lighter deceleration than cubic.
+   */
+  easeOutQuad: t => 1 - (1 - t) * (1 - t),
+  /**
+   * Ease out expo - strong deceleration (snappy feel).
+   */
+  easeOutExpo: t => t === 1 ? 1 : 1 - Math.pow(2, -10 * t)
+};
+/**
+ * Get an easing function by name.
+ */
+function getEasing(name) {
+  return easing[name];
+}
+
+/**
+ * Interpolate between two values using an easing function.
+ */
+function interpolate(from, to, progress, easingFn = easing.easeOutCubic) {
+  const eased = easingFn(Math.max(0, Math.min(1, progress)));
+  return from + (to - from) * eased;
+}
+
+/**
+ * Interpolate a position (x, y) using an easing function.
+ */
+function interpolatePosition(from, to, progress, easingFn = easing.easeOutCubic) {
+  return {
+    x: interpolate(from.x, to.x, progress, easingFn),
+    y: interpolate(from.y, to.y, progress, easingFn)
+  };
+}

package/lib/commonjs/icons/benchmark-icon.js

@@ -1 +1,24 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),Object.defineProperty(exports,"BENCHMARK_ICON_COLOR",{enumerable:!0,get:function(){return _iconData.BENCHMARK_ICON_COLOR}}),exports.BenchmarkIcon=void 0;var _iconRenderer=require("./icon-renderer.js"),_iconData=require("./icon-data.js");const BenchmarkIcon=exports.BenchmarkIcon=(0,_iconRenderer.createIcon)(_iconData.benchmarkIconData);
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "BENCHMARK_ICON_COLOR", {
+  enumerable: true,
+  get: function () {
+    return _iconData.BENCHMARK_ICON_COLOR;
+  }
+});
+exports.BenchmarkIcon = void 0;
+var _iconRenderer = require("./icon-renderer.js");
+var _iconData = require("./icon-data.js");
+/**
+ * BenchmarkIcon - Data-driven icon
+ *
+ * The icon is defined as pure data in icon-data.ts
+ * The renderer transforms it to components.
+ *
+ * To change: edit benchmarkIconData in icon-data.ts
+ */
+
+const BenchmarkIcon = exports.BenchmarkIcon = (0, _iconRenderer.createIcon)(_iconData.benchmarkIconData);

package/lib/commonjs/icons/env-icon.js

@@ -1 +1,24 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),Object.defineProperty(exports,"ENV_ICON_COLOR",{enumerable:!0,get:function(){return _iconData.ENV_ICON_COLOR}}),exports.EnvIcon=void 0;var _iconRenderer=require("./icon-renderer.js"),_iconData=require("./icon-data.js");const EnvIcon=exports.EnvIcon=(0,_iconRenderer.createIcon)(_iconData.envIconData);
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "ENV_ICON_COLOR", {
+  enumerable: true,
+  get: function () {
+    return _iconData.ENV_ICON_COLOR;
+  }
+});
+exports.EnvIcon = void 0;
+var _iconRenderer = require("./icon-renderer.js");
+var _iconData = require("./icon-data.js");
+/**
+ * EnvIcon - Data-driven icon
+ *
+ * The icon is defined as pure data in icon-data.ts
+ * The renderer transforms it to components.
+ *
+ * To change: edit envIconData in icon-data.ts
+ */
+
+const EnvIcon = exports.EnvIcon = (0, _iconRenderer.createIcon)(_iconData.envIconData);

package/lib/commonjs/icons/events-icon.js

@@ -1 +1,24 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),Object.defineProperty(exports,"EVENTS_ICON_COLOR",{enumerable:!0,get:function(){return _iconData.EVENTS_ICON_COLOR}}),exports.EventsIcon=void 0;var _iconRenderer=require("./icon-renderer.js"),_iconData=require("./icon-data.js");const EventsIcon=exports.EventsIcon=(0,_iconRenderer.createIcon)(_iconData.eventsIconData);
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "EVENTS_ICON_COLOR", {
+  enumerable: true,
+  get: function () {
+    return _iconData.EVENTS_ICON_COLOR;
+  }
+});
+exports.EventsIcon = void 0;
+var _iconRenderer = require("./icon-renderer.js");
+var _iconData = require("./icon-data.js");
+/**
+ * EventsIcon - Data-driven icon
+ *
+ * The icon is defined as pure data in icon-data.ts
+ * The renderer transforms it to components.
+ *
+ * To change: edit eventsIconData in icon-data.ts
+ */
+
+const EventsIcon = exports.EventsIcon = (0, _iconRenderer.createIcon)(_iconData.eventsIconData);

package/lib/commonjs/icons/highlight-icon.js

@@ -1 +1,24 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),Object.defineProperty(exports,"HIGHLIGHT_ICON_COLOR",{enumerable:!0,get:function(){return _iconData.HIGHLIGHT_ICON_COLOR}}),exports.HighlightIcon=void 0;var _iconRenderer=require("./icon-renderer.js"),_iconData=require("./icon-data.js");const HighlightIcon=exports.HighlightIcon=(0,_iconRenderer.createIcon)(_iconData.highlightIconData);
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "HIGHLIGHT_ICON_COLOR", {
+  enumerable: true,
+  get: function () {
+    return _iconData.HIGHLIGHT_ICON_COLOR;
+  }
+});
+exports.HighlightIcon = void 0;
+var _iconRenderer = require("./icon-renderer.js");
+var _iconData = require("./icon-data.js");
+/**
+ * HighlightIcon - Data-driven icon (also known as StackPulseIcon/RenderPulseIcon)
+ *
+ * The icon is defined as pure data in icon-data.ts
+ * The renderer transforms it to components.
+ *
+ * To change: edit highlightIconData in icon-data.ts
+ */
+
+const HighlightIcon = exports.HighlightIcon = (0, _iconRenderer.createIcon)(_iconData.highlightIconData);