@holoscript/core 6.0.4 → 6.1.2

package/dist/chunk-DMXC24WV.js

@@ -0,0 +1,404 @@
+import { z } from 'zod';
+
+// src/compiler/BusinessQuestTools.ts
+var vrrQuestEntrySchema = z.object({
+  id: z.string().min(1),
+  title: z.string().min(1),
+  steps: z.array(z.string()).min(1)
+});
+var businessVRRDraftSchema = z.object({
+  compositionName: z.string().min(1).regex(/^[A-Za-z_][A-Za-z0-9_]*$/, "compositionName must be a valid HoloScript identifier"),
+  twin: z.object({
+    mirrorId: z.string().min(1),
+    realitySync: z.array(z.string()).min(1),
+    geoSync: z.object({
+      center: z.string().min(1),
+      radius: z.number().nonnegative().optional()
+    }).optional()
+  }),
+  weather: z.object({
+    provider: z.enum(["weather.gov", "openweathermap"]),
+    refresh: z.string().optional()
+  }).optional(),
+  events: z.object({
+    provider: z.enum(["eventbrite", "ticketmaster"]),
+    refresh: z.string().optional()
+  }).optional(),
+  businesses: z.array(
+    z.object({
+      id: z.string().min(1),
+      displayName: z.string().optional(),
+      geo: z.object({
+        lat: z.number().gte(-90).lte(90),
+        lng: z.number().gte(-180).lte(180)
+      }),
+      inventory: z.object({
+        provider: z.enum(["square_pos", "shopify", "woocommerce"]),
+        refresh: z.string().optional(),
+        websocket: z.boolean().optional()
+      }).optional(),
+      quests: z.array(vrrQuestEntrySchema).min(1)
+    })
+  ).min(1),
+  layerShift: z.object({
+    from: z.enum(["ar", "vrr", "vr"]),
+    to: z.enum(["ar", "vrr", "vr"]),
+    price: z.number().nonnegative().optional(),
+    persistState: z.boolean().optional()
+  }).optional()
+});
+function vrrTrait(name, params) {
+  return {
+    type: "ObjectTrait",
+    name,
+    config: params,
+    params
+  };
+}
+function emptyCompositionShell(name) {
+  return {
+    type: "Composition",
+    name,
+    templates: [],
+    objects: [],
+    spatialGroups: [],
+    lights: [],
+    imports: [],
+    timelines: [],
+    audio: [],
+    zones: [],
+    transitions: [],
+    conditionals: [],
+    iterators: [],
+    npcs: [],
+    quests: [],
+    abilities: [],
+    dialogues: [],
+    stateMachines: [],
+    achievements: [],
+    talentTrees: [],
+    shapes: [],
+    metadata: {
+      source: "business-quest-tools",
+      draftKind: "hololand-vrr"
+    }
+  };
+}
+function buildVRRCompositionFromDraft(draft) {
+  const composition = emptyCompositionShell(draft.compositionName);
+  const twinTraits = [
+    vrrTrait("vrr_twin", { mirror: draft.twin.mirrorId }),
+    vrrTrait("reality_mirror", { sync: draft.twin.realitySync })
+  ];
+  if (draft.twin.geoSync) {
+    twinTraits.push(
+      vrrTrait("geo_sync", {
+        center: draft.twin.geoSync.center,
+        radius: draft.twin.geoSync.radius ?? 0
+      })
+    );
+  }
+  const twinObject = {
+    type: "Object",
+    name: `${draft.compositionName}_twin_root`,
+    properties: [],
+    traits: twinTraits
+  };
+  const objects = [twinObject];
+  if (draft.weather) {
+    objects.push({
+      type: "Object",
+      name: `${draft.compositionName}_weather`,
+      properties: [],
+      traits: [
+        vrrTrait("weather_sync", {
+          provider: draft.weather.provider,
+          refresh: draft.weather.refresh ?? "5_minutes"
+        })
+      ]
+    });
+  }
+  if (draft.events) {
+    objects.push({
+      type: "Object",
+      name: `${draft.compositionName}_events`,
+      properties: [],
+      traits: [
+        vrrTrait("event_sync", {
+          provider: draft.events.provider,
+          refresh: draft.events.refresh ?? "5_minutes"
+        })
+      ]
+    });
+  }
+  for (const biz of draft.businesses) {
+    const questPayload = biz.quests.map((q) => ({
+      id: q.id,
+      title: q.title,
+      steps: q.steps
+    }));
+    const bizTraits = [
+      vrrTrait("geo_anchor", { lat: biz.geo.lat, lng: biz.geo.lng }),
+      vrrTrait("quest_hub", { quests: questPayload })
+    ];
+    if (biz.inventory) {
+      bizTraits.push(
+        vrrTrait("inventory_sync", {
+          provider: biz.inventory.provider,
+          refresh: biz.inventory.refresh ?? "1_minute",
+          websocket: biz.inventory.websocket ?? false
+        })
+      );
+    }
+    objects.push({
+      type: "Object",
+      name: biz.displayName ?? biz.id,
+      properties: [],
+      traits: bizTraits
+    });
+  }
+  if (draft.layerShift) {
+    objects.push({
+      type: "Object",
+      name: `${draft.compositionName}_layer_shift`,
+      properties: [],
+      traits: [
+        vrrTrait("layer_shift", {
+          from: draft.layerShift.from,
+          to: draft.layerShift.to,
+          price: draft.layerShift.price ?? 0,
+          persist_state: draft.layerShift.persistState !== false
+        })
+      ]
+    });
+  }
+  composition.objects = objects;
+  return composition;
+}
+function validateBusinessVRRDraft(draft, options) {
+  const issues = [];
+  const parsed = businessVRRDraftSchema.safeParse(draft);
+  if (!parsed.success) {
+    for (const err of parsed.error.issues) {
+      issues.push({
+        path: err.path.join("."),
+        message: err.message,
+        severity: "error"
+      });
+    }
+    return Promise.resolve({ ok: false, issues });
+  }
+  if (options?.parseWithVrrCompiler) {
+    return import('./compiler/vrr.js').then(({ VRRCompiler }) => {
+      const composition = buildVRRCompositionFromDraft(parsed.data);
+      const compiler = new VRRCompiler({
+        target: "threejs",
+        minify: false,
+        source_maps: false,
+        api_integrations: {},
+        performance: { target_fps: 60, max_players: 1e3, lazy_loading: true }
+      });
+      const data = compiler.parseVRRComposition(composition);
+      if (data.questNodes.length === 0) {
+        issues.push({
+          path: "businesses",
+          message: "VRR parse found no @quest_hub nodes \u2014 check draft.quests",
+          severity: "warning"
+        });
+      }
+      if (data.twinNodes.length === 0) {
+        issues.push({
+          path: "twin",
+          message: "VRR parse found no @vrr_twin nodes",
+          severity: "warning"
+        });
+      }
+      return { ok: issues.every((i) => i.severity !== "error"), issues };
+    }).catch((err) => {
+      issues.push({
+        path: "",
+        message: err instanceof Error ? err.message : String(err),
+        severity: "error"
+      });
+      return { ok: false, issues };
+    });
+  }
+  return Promise.resolve({ ok: true, issues });
+}
+function draftToHoloPreview(draft) {
+  const lines = [];
+  lines.push(`// Preview \u2014 generated by BusinessQuestTools (no-code VRR draft)`);
+  lines.push(`composition "${draft.compositionName}" {`);
+  lines.push(
+    `  // twin: mirror=${draft.twin.mirrorId} sync=[${draft.twin.realitySync.join(", ")}]`
+  );
+  if (draft.weather) {
+    lines.push(`  // weather: ${draft.weather.provider}`);
+  }
+  if (draft.events) {
+    lines.push(`  // events: ${draft.events.provider}`);
+  }
+  for (const biz of draft.businesses) {
+    lines.push(`  // business "${biz.id}" @ geo ${biz.geo.lat},${biz.geo.lng}`);
+    for (const q of biz.quests) {
+      lines.push(`  //   quest "${q.title}" (${q.steps.length} steps)`);
+    }
+  }
+  lines.push(`}`);
+  return lines.join("\n");
+}
+var BUSINESS_QUEST_TOOLS = [
+  {
+    name: "holoscript_business_quest_scaffold_vrr",
+    description: "Build a HoloComposition JSON for Hololand VRR from a structured draft (no .holo source). Includes @vrr_twin, @reality_mirror, optional @geo_sync, @weather_sync, @event_sync, per-business @geo_anchor + @quest_hub + optional @inventory_sync, and optional @layer_shift.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        draft: {
+          type: "object",
+          description: "BusinessVRRDraft \u2014 see businessVRRDraftSchema in @holoscript/core"
+        },
+        runVrrParse: {
+          type: "boolean",
+          description: "If true, run VRRCompiler.parseVRRComposition and return trait counts",
+          default: false
+        },
+        agentToken: {
+          type: "string",
+          description: "Optional agent token for future RBAC (reserved)"
+        }
+      },
+      required: ["draft"]
+    }
+  },
+  {
+    name: "holoscript_business_quest_validate_vrr_draft",
+    description: "Validate a BusinessVRRDraft (Zod). Optionally run VRRCompiler parse smoke check.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        draft: { type: "object", description: "Candidate BusinessVRRDraft JSON" },
+        parseWithVrrCompiler: {
+          type: "boolean",
+          description: "When true, dynamically loads VRRCompiler for wiring verification",
+          default: false
+        }
+      },
+      required: ["draft"]
+    }
+  },
+  {
+    name: "holoscript_business_quest_preview_holo",
+    description: "Return a commented HoloScript-style preview string for founder review (not a full parser round-trip).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        draft: { type: "object" }
+      },
+      required: ["draft"]
+    }
+  }
+];
+async function handleBusinessQuestToolCall(request) {
+  try {
+    switch (request.name) {
+      case "holoscript_business_quest_scaffold_vrr":
+        return await handleScaffold(request.arguments);
+      case "holoscript_business_quest_validate_vrr_draft":
+        return await handleValidate(request.arguments);
+      case "holoscript_business_quest_preview_holo":
+        return await handlePreview(request.arguments);
+      default:
+        return {
+          isError: true,
+          content: [{ type: "text", text: `Unknown tool: ${request.name}` }]
+        };
+    }
+  } catch (error) {
+    return {
+      isError: true,
+      content: [
+        {
+          type: "text",
+          text: `Error: ${error instanceof Error ? error.message : String(error)}`
+        }
+      ]
+    };
+  }
+}
+async function handleScaffold(args) {
+  const parsed = businessVRRDraftSchema.safeParse(args.draft);
+  if (!parsed.success) {
+    return {
+      isError: true,
+      content: [{ type: "text", text: JSON.stringify(parsed.error.flatten(), null, 2) }]
+    };
+  }
+  const composition = buildVRRCompositionFromDraft(parsed.data);
+  const runParse = Boolean(args.runVrrParse);
+  let vrrSummary;
+  if (runParse) {
+    const { VRRCompiler } = await import('./compiler/vrr.js');
+    const compiler = new VRRCompiler({
+      target: "threejs",
+      minify: false,
+      source_maps: false,
+      api_integrations: {},
+      performance: { target_fps: 60, max_players: 1e3, lazy_loading: true }
+    });
+    const data = compiler.parseVRRComposition(composition);
+    vrrSummary = {
+      twinNodes: data.twinNodes.length,
+      weatherNodes: data.weatherNodes.length,
+      eventNodes: data.eventNodes.length,
+      inventoryNodes: data.inventoryNodes.length,
+      questNodes: data.questNodes.length,
+      layerShiftNodes: data.layerShiftNodes.length,
+      paywallNodes: data.paywallNodes.length,
+      geoAnchorNodes: data.geoAnchorNodes.length
+    };
+  }
+  const payload = {
+    success: true,
+    compositionName: composition.name,
+    objectCount: composition.objects.length,
+    composition,
+    vrrTraitCounts: vrrSummary
+  };
+  return {
+    isError: false,
+    content: [{ type: "text", text: JSON.stringify(payload, null, 2) }]
+  };
+}
+async function handleValidate(args) {
+  const parseWithVrrCompiler = Boolean(args.parseWithVrrCompiler);
+  const result = await validateBusinessVRRDraft(args.draft, { parseWithVrrCompiler });
+  return {
+    isError: !result.ok,
+    content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+  };
+}
+async function handlePreview(args) {
+  const parsed = businessVRRDraftSchema.safeParse(args.draft);
+  if (!parsed.success) {
+    return {
+      isError: true,
+      content: [{ type: "text", text: JSON.stringify(parsed.error.flatten(), null, 2) }]
+    };
+  }
+  const text = draftToHoloPreview(parsed.data);
+  return {
+    isError: false,
+    content: [{ type: "text", text }]
+  };
+}
+function registerBusinessQuestTools(server) {
+  for (const tool of BUSINESS_QUEST_TOOLS) {
+    server.registerTool(tool, handleBusinessQuestToolCall);
+  }
+}
+var BusinessQuestTools_default = handleBusinessQuestToolCall;
+
+export { BUSINESS_QUEST_TOOLS, BusinessQuestTools_default, buildVRRCompositionFromDraft, businessVRRDraftSchema, draftToHoloPreview, handleBusinessQuestToolCall, registerBusinessQuestTools, validateBusinessVRRDraft };
+//# sourceMappingURL=chunk-DMXC24WV.js.map
+//# sourceMappingURL=chunk-DMXC24WV.js.map

package/dist/{chunk-PMGODDJA.cjs → chunk-DTGBOSEM.cjs}

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunk3SAK5KFL_cjs = require('./chunk-3SAK5KFL.cjs');
+var chunkHCCQLAA4_cjs = require('./chunk-HCCQLAA4.cjs');
 
 // src/traits/constants/mobile/geospatial.ts
 exports.GEOSPATIAL_ARCORE_TRAITS = void 0; exports.GEOSPATIAL_DEFAULTS = void 0;
-var init_geospatial = chunk3SAK5KFL_cjs.__esm({
+var init_geospatial = chunkHCCQLAA4_cjs.__esm({
   "src/traits/constants/mobile/geospatial.ts"() {
     exports.GEOSPATIAL_ARCORE_TRAITS = [
       // --- VPS Core ---
@@ -60,7 +60,7 @@ var init_geospatial = chunk3SAK5KFL_cjs.__esm({
 
 // src/traits/constants/mobile/spatial-authoring.ts
 exports.SPATIAL_AUTHORING_TRAITS = void 0; exports.SPATIAL_AUTHORING_DEFAULTS = void 0;
-var init_spatial_authoring = chunk3SAK5KFL_cjs.__esm({
+var init_spatial_authoring = chunkHCCQLAA4_cjs.__esm({
   "src/traits/constants/mobile/spatial-authoring.ts"() {
     exports.SPATIAL_AUTHORING_TRAITS = [
       // --- Gyro Placement ---
@@ -98,7 +98,7 @@ var init_spatial_authoring = chunk3SAK5KFL_cjs.__esm({
 
 // src/traits/constants/mobile/haptic-feedback.ts
 exports.HAPTIC_FEEDBACK_TRAITS = void 0;
-var init_haptic_feedback = chunk3SAK5KFL_cjs.__esm({
+var init_haptic_feedback = chunkHCCQLAA4_cjs.__esm({
   "src/traits/constants/mobile/haptic-feedback.ts"() {
     exports.HAPTIC_FEEDBACK_TRAITS = [
       // --- Interaction ---
@@ -132,7 +132,7 @@ var init_haptic_feedback = chunk3SAK5KFL_cjs.__esm({
 
 // src/traits/constants/mobile/nearby-connections.ts
 exports.NEARBY_CONNECTIONS_TRAITS = void 0;
-var init_nearby_connections = chunk3SAK5KFL_cjs.__esm({
+var init_nearby_connections = chunkHCCQLAA4_cjs.__esm({
   "src/traits/constants/mobile/nearby-connections.ts"() {
     exports.NEARBY_CONNECTIONS_TRAITS = [
       // --- Discovery ---
@@ -162,7 +162,7 @@ var init_nearby_connections = chunk3SAK5KFL_cjs.__esm({
 
 // src/traits/constants/mobile/foldable-display.ts
 exports.FOLDABLE_DISPLAY_TRAITS = void 0;
-var init_foldable_display = chunk3SAK5KFL_cjs.__esm({
+var init_foldable_display = chunkHCCQLAA4_cjs.__esm({
   "src/traits/constants/mobile/foldable-display.ts"() {
     exports.FOLDABLE_DISPLAY_TRAITS = [
       "foldable_detect",
@@ -183,7 +183,7 @@ var init_foldable_display = chunk3SAK5KFL_cjs.__esm({
 
 // src/traits/constants/mobile/samsung-dex.ts
 exports.SAMSUNG_DEX_TRAITS = void 0;
-var init_samsung_dex = chunk3SAK5KFL_cjs.__esm({
+var init_samsung_dex = chunkHCCQLAA4_cjs.__esm({
   "src/traits/constants/mobile/samsung-dex.ts"() {
     exports.SAMSUNG_DEX_TRAITS = [
       "dex_detect",
@@ -202,7 +202,7 @@ var init_samsung_dex = chunk3SAK5KFL_cjs.__esm({
 
 // src/traits/constants/mobile/webxr.ts
 exports.WEBXR_TRAITS = void 0;
-var init_webxr = chunk3SAK5KFL_cjs.__esm({
+var init_webxr = chunkHCCQLAA4_cjs.__esm({
   "src/traits/constants/mobile/webxr.ts"() {
     exports.WEBXR_TRAITS = [
       // --- Session ---
@@ -236,7 +236,7 @@ var init_webxr = chunk3SAK5KFL_cjs.__esm({
 
 // src/traits/constants/mobile/google-lens.ts
 exports.GOOGLE_LENS_TRAITS = void 0;
-var init_google_lens = chunk3SAK5KFL_cjs.__esm({
+var init_google_lens = chunkHCCQLAA4_cjs.__esm({
   "src/traits/constants/mobile/google-lens.ts"() {
     exports.GOOGLE_LENS_TRAITS = [
       "lens_recognize",
@@ -259,7 +259,7 @@ var init_google_lens = chunk3SAK5KFL_cjs.__esm({
 
 // src/traits/constants/mobile/depth-scanner.ts
 exports.DEPTH_SCANNER_TRAITS = void 0; exports.DEPTH_SCANNER_DEFAULTS = void 0;
-var init_depth_scanner = chunk3SAK5KFL_cjs.__esm({
+var init_depth_scanner = chunkHCCQLAA4_cjs.__esm({
   "src/traits/constants/mobile/depth-scanner.ts"() {
     exports.DEPTH_SCANNER_TRAITS = [
       // --- Core ---
@@ -315,5 +315,5 @@ exports.init_nearby_connections = init_nearby_connections;
 exports.init_samsung_dex = init_samsung_dex;
 exports.init_spatial_authoring = init_spatial_authoring;
 exports.init_webxr = init_webxr;
-//# sourceMappingURL=chunk-PMGODDJA.cjs.map
-//# sourceMappingURL=chunk-PMGODDJA.cjs.map
+//# sourceMappingURL=chunk-DTGBOSEM.cjs.map
+//# sourceMappingURL=chunk-DTGBOSEM.cjs.map

package/dist/chunk-E7JP3BS3.cjs

@@ -0,0 +1,61 @@
+'use strict';
+
+var chunkHCCQLAA4_cjs = require('./chunk-HCCQLAA4.cjs');
+var zod = require('zod');
+
+function safeJsonParse(s, schema) {
+  let raw;
+  try {
+    raw = JSON.parse(s);
+  } catch (e) {
+    const message = e instanceof Error ? e.message : String(e);
+    return { ok: false, error: { kind: "json-parse", message, cause: e } };
+  }
+  const parsed = schema.safeParse(raw);
+  if (parsed.success) {
+    return { ok: true, value: parsed.data };
+  }
+  return {
+    ok: false,
+    error: { kind: "schema", message: parsed.error.message, zodError: parsed.error }
+  };
+}
+function readJson(s) {
+  const r = safeJsonParse(s, zod.z.unknown());
+  if (r.ok) {
+    return r.value;
+  }
+  if (r.error.kind === "json-parse") {
+    const err = new SyntaxError(r.error.message);
+    err.cause = r.error.cause;
+    throw err;
+  }
+  throw new Error(`[readJson] schema failure on z.unknown: ${r.error.message}`);
+}
+function jsonClone(value) {
+  return readJson(JSON.stringify(value));
+}
+function tryParseJson(s, fallback) {
+  if (s === null || s === void 0) {
+    return fallback;
+  }
+  try {
+    return JSON.parse(s);
+  } catch {
+    return fallback;
+  }
+}
+exports.safeJsonParseSchema = void 0;
+var init_safeJsonParse = chunkHCCQLAA4_cjs.__esm({
+  "src/errors/safeJsonParse.ts"() {
+    exports.safeJsonParseSchema = safeJsonParse;
+  }
+});
+
+exports.init_safeJsonParse = init_safeJsonParse;
+exports.jsonClone = jsonClone;
+exports.readJson = readJson;
+exports.safeJsonParse = safeJsonParse;
+exports.tryParseJson = tryParseJson;
+//# sourceMappingURL=chunk-E7JP3BS3.cjs.map
+//# sourceMappingURL=chunk-E7JP3BS3.cjs.map

package/dist/{chunk-HJJLD366.js → chunk-EKBKLK7P.js}

@@ -1,4 +1,4 @@
-import { vec3SubArray, vec3NormalizeInPlace, vec3CrossArray, vec3ScaleArray } from './chunk-56IF4NTA.js';
+import { vec3SubArray, vec3NormalizeInPlace, vec3CrossArray, vec3ScaleArray } from './chunk-MXFUTKCO.js';
 
 // src/compiler/ProceduralGeometry.ts
 var LOD_PRESETS = {
@@ -1165,5 +1165,5 @@ function generateMembraneGeometry(anchors, subdivisions = 8, bulge = 0.15, lod)
 }
 
 export { generateHullGeometry, generateMembraneGeometry, generateSplineGeometry };
-//# sourceMappingURL=chunk-HJJLD366.js.map
-//# sourceMappingURL=chunk-HJJLD366.js.map
+//# sourceMappingURL=chunk-EKBKLK7P.js.map
+//# sourceMappingURL=chunk-EKBKLK7P.js.map