@blorkfield/overlay-core 0.8.8 → 0.8.9

package/README.md

@@ -22,13 +22,24 @@ pnpm add @blorkfield/overlay-core
 
 ### Tag Based Behavior
 
-Objects don't have fixed types. Instead, their behavior is determined by string tags:
+Objects don't have fixed types. Instead, their behavior is determined by string tags. Import the tag constants to avoid magic strings:
 
-| Tag | Behavior |
-|-----|----------|
-| `falling` | Object is dynamic and affected by gravity |
-| `window_follow` | Object follows mouse position when grounded |
-| `grabable` | Object can be dragged via mouse constraint |
+```typescript
+import { TAGS, TAG_FALLING, TAG_GRABABLE, TAG_FOLLOW_WINDOW } from '@blorkfield/overlay-core';
+
+// Use individual constants
+scene.spawnObject({ tags: [TAG_FALLING, TAG_GRABABLE], ... });
+
+// Or destructure from TAGS object
+const { FALLING, GRABABLE } = TAGS;
+scene.spawnObject({ tags: [FALLING, GRABABLE], ... });
+```
+
+| Constant | Value | Behavior |
+|----------|-------|----------|
+| `TAG_FALLING` / `TAGS.FALLING` | `'falling'` | Object is dynamic and affected by gravity |
+| `TAG_FOLLOW_WINDOW` / `TAGS.FOLLOW_WINDOW` | `'follow_window'` | Object follows mouse position when grounded |
+| `TAG_GRABABLE` / `TAGS.GRABABLE` | `'grabable'` | Object can be grabbed and moved with mouse |
 
 Without the `falling` tag, objects are static and won't move.
 
@@ -712,6 +723,12 @@ import type {
   UpdateCallbackData,
 
   // Logging
-  LogLevel
+  LogLevel,
+
+  // Tags
+  Tag
 } from '@blorkfield/overlay-core';
+
+// Tag constants (values, not types)
+import { TAGS, TAG_FALLING, TAG_GRABABLE, TAG_FOLLOW_WINDOW } from '@blorkfield/overlay-core';
 ```

package/dist/index.cjs

@@ -32,6 +32,10 @@ var index_exports = {};
 __export(index_exports, {
   BackgroundManager: () => BackgroundManager,
   OverlayScene: () => OverlayScene,
+  TAGS: () => TAGS,
+  TAG_FALLING: () => TAG_FALLING,
+  TAG_FOLLOW_WINDOW: () => TAG_FOLLOW_WINDOW,
+  TAG_GRABABLE: () => TAG_GRABABLE,
   clearFontCache: () => clearFontCache,
   getGlyphData: () => getGlyphData,
   getKerning: () => getKerning,
@@ -1547,7 +1551,7 @@ var OverlayScene = class {
         const isDragging = this.grabbedObjectId === entry.id;
         if (!isDragging) {
           for (const tag of entry.tags) {
-            const key = tag === "window_follow" ? "mouse" : tag.startsWith("follow-") ? tag.slice(7) : null;
+            const key = tag === "follow_window" ? "mouse" : tag.startsWith("follow-") ? tag.slice(7) : null;
             if (key) {
               const target = this.followTargets.get(key);
               if (target) {
@@ -2082,7 +2086,7 @@ var OverlayScene = class {
    * Spawn an object synchronously.
    * Object behavior is determined by tags:
    * - 'falling': Object is dynamic (affected by gravity)
-   * - 'window_follow': Object follows mouse when grounded (walks toward mouse)
+   * - 'follow_window': Object follows mouse when grounded (walks toward mouse)
    * - 'grabable': Object can be grabbed and moved with mouse
    * Without 'falling' tag, object is static.
    */
@@ -3394,10 +3398,24 @@ var OverlayScene = class {
     this.updateCallbacks.forEach((cb) => cb(data));
   }
 };
+
+// src/tags.ts
+var TAG_FALLING = "falling";
+var TAG_FOLLOW_WINDOW = "follow_window";
+var TAG_GRABABLE = "grabable";
+var TAGS = {
+  FALLING: TAG_FALLING,
+  FOLLOW_WINDOW: TAG_FOLLOW_WINDOW,
+  GRABABLE: TAG_GRABABLE
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BackgroundManager,
   OverlayScene,
+  TAGS,
+  TAG_FALLING,
+  TAG_FOLLOW_WINDOW,
+  TAG_GRABABLE,
   clearFontCache,
   getGlyphData,
   getKerning,