@holoscript/std 2.1.0 → 3.1.1

package/src/time.ts

@@ -121,14 +121,11 @@ export function throttle<T extends (...args: unknown[]) => unknown>(fn: T, ms: n
       lastCall = now();
       fn(...args);
     } else if (!timeoutId) {
-      timeoutId = setTimeout(
-        () => {
-          lastCall = now();
-          timeoutId = null;
-          fn(...args);
-        },
-        ms - elapsed
-      );
+      timeoutId = setTimeout(() => {
+        lastCall = now();
+        timeoutId = null;
+        fn(...args);
+      }, ms - elapsed);
     }
   }) as T;
 }
@@ -136,7 +133,9 @@ export function throttle<T extends (...args: unknown[]) => unknown>(fn: T, ms: n
 /**
  * Measure execution time of a function
  */
-export async function measure<T>(fn: () => T | Promise<T>): Promise<{ result: T; duration: number }> {
+export async function measure<T>(
+  fn: () => T | Promise<T>
+): Promise<{ result: T; duration: number }> {
   const start = hrTime();
   const result = await fn();
   const duration = hrTime() - start;
@@ -585,7 +584,7 @@ export const DateTime = {
    * Add time to a date
    */
   add(date: Date, amount: number, unit: 'ms' | 's' | 'm' | 'h' | 'd'): Date {
-    const ms = DateTime.diff(new Date(amount), new Date(0), 'ms');
+    const _ms = DateTime.diff(new Date(amount), new Date(0), 'ms');
     const multipliers = { ms: 1, s: 1000, m: 60000, h: 3600000, d: 86400000 };
     return new Date(date.getTime() + amount * multipliers[unit]);
   },

package/src/traits/ARTraits.ts

@@ -0,0 +1,103 @@
+/**
+ * @fileoverview AR Traits (Augmented Reality)
+ * @module @holoscript/std/traits
+ *
+ * Defines the AST traits required for augmented reality overlays
+ * and real-world physical anchoring.
+ */
+
+import type { TraitDefinition } from '../types.js';
+
+/**
+ * Standard AR traits included in HoloScript's base functionality
+ */
+export const ARTraits: TraitDefinition[] = [
+  {
+    name: '@ar_beacon',
+    type: 'marker',
+    description:
+      'Binds a UI or 3D overlay to a physical reality marker (QR code, NFC, BLE beacon, or visual image).',
+    parameters: [
+      {
+        name: 'type',
+        type: 'string',
+        required: true,
+        validation: (val: any) => ['qr', 'image', 'nfc', 'ble', 'gps'].includes(val),
+        description: 'The type of physical beacon (qr, image, nfc, ble, gps)',
+      },
+      {
+        name: 'id',
+        type: 'string',
+        required: true,
+        description: 'The unique identifier data the beacon broadcasts or visually represents',
+      },
+      {
+        name: 'physical_size',
+        type: 'number',
+        required: false,
+        description:
+          'The expected physical size of the image/marker in meters (for image/qr types)',
+      },
+    ],
+    validation: (node: any) => {
+      return { valid: true }; // Allowed on any Node (Zones, Objects, UI)
+    },
+  },
+  {
+    name: '@overlay',
+    type: 'behavior',
+    description:
+      'Marks a HoloUI panel or 3D object to act as a pass-through overlay locked to the viewport or surface.',
+    parameters: [
+      {
+        name: 'anchor',
+        type: 'string',
+        required: false,
+        defaultValue: 'viewport',
+        validation: (val: any) => ['viewport', 'surface', 'plane', 'face', 'hand'].includes(val),
+        description: 'How the overlay anchors to the AR pass-through feed.',
+      },
+      {
+        name: 'occlusion',
+        type: 'boolean',
+        required: false,
+        defaultValue: true,
+        description: 'Whether physical real-world objects occlude this virtual overlay.',
+      },
+    ],
+    validation: (node: any) => {
+      // Typically used on UI or SpatialGroups
+      if (node.type !== 'HoloUI' && node.type !== 'SpatialGroup') {
+        return { valid: false, message: '@overlay must be attached to HoloUI or SpatialGroup.' };
+      }
+      return { valid: true };
+    },
+  },
+  {
+    name: '@layer_shift',
+    type: 'behavior',
+    description:
+      'Controls the automatic transition between physical reality (AR) and digital twin reality (VR/VRR) boundaries.',
+    parameters: [
+      {
+        name: 'trigger',
+        type: 'string',
+        required: true,
+        validation: (val: any) => ['proximity', 'scan', 'payment', 'quest_step'].includes(val),
+        description: 'What triggers the reality shift.',
+      },
+      {
+        name: 'to_layer',
+        type: 'string',
+        required: true,
+        validation: (val: any) => ['vr', 'vrr', 'ar'].includes(val),
+        description: 'Which layer the user shifts into.',
+      },
+    ],
+    validation: (node: any) => {
+      return { valid: true };
+    },
+  },
+];
+
+export default ARTraits;