@dfosco/storyboard-core 1.19.0 → 1.21.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dfosco/storyboard-core",
-  "version": "1.19.0",
+  "version": "1.21.0",
   "type": "module",
   "license": "MIT",
   "repository": {

package/src/devtools.js

@@ -17,7 +17,7 @@ import { loadScene } from './loader.js'
 import { isCommentsEnabled } from './comments/config.js'
 import { isHideMode, activateHideMode, deactivateHideMode } from './hideMode.js'
 import { getAllFlags, toggleFlag, getFlagKeys } from './featureFlags.js'
-import { isPluginEnabled } from './plugins.js'
+import { isPluginEnabled, initPlugins } from './plugins.js'
 
 const STYLES = `
 .sb-devtools-wrapper {
@@ -190,8 +190,13 @@ function getSceneName() {
  *
  * @param {object} [options]
  * @param {HTMLElement} [options.container=document.body] - Where to mount
+ * @param {Record<string, boolean>} [options.plugins] - Plugin config from storyboard.config.json
  */
 export function mountDevTools(options = {}) {
+  // Allow callers to pass plugins config directly (avoids timing issues
+  // where mountDevTools runs before the Vite virtual module calls initPlugins)
+  if (options.plugins) initPlugins(options.plugins)
+
   // Skip when devtools plugin is disabled via storyboard.config.json
   if (!isPluginEnabled('devtools')) return
 

package/src/devtools.test.js

@@ -97,4 +97,11 @@ describe('mountDevTools', () => {
     const wrapper = document.body.querySelector('.sb-devtools-wrapper')
     expect(wrapper).not.toBeNull()
   })
+
+  it('does not mount when plugins option disables devtools', () => {
+    mountDevTools({ plugins: { devtools: false } })
+
+    const wrapper = document.body.querySelector('.sb-devtools-wrapper')
+    expect(wrapper).toBeNull()
+  })
 })

package/src/index.js

@@ -8,8 +8,8 @@
 // Data index initialization
 export { init } from './loader.js'
 
-// Scene & record loading
-export { loadScene, listScenes, sceneExists, loadRecord, findRecord, deepMerge } from './loader.js'
+// Scene, object & record loading
+export { loadScene, listScenes, sceneExists, loadRecord, findRecord, loadObject, deepMerge } from './loader.js'
 
 // Dot-notation path utilities
 export { getByPath, setByPath, deepClone } from './dotPath.js'

package/src/loader.js

@@ -209,4 +209,17 @@ export function findRecord(recordName, id) {
   return records.find((entry) => entry.id === id) ?? null
 }
 
+/**
+ * Loads an object data file by name, resolves any nested $ref references,
+ * and returns a deep clone.
+ *
+ * @param {string} objectName - Name of the object file (e.g., "jane-doe")
+ * @returns {object|Array} Resolved object data
+ */
+export function loadObject(objectName) {
+  const data = loadDataFile(objectName, 'objects')
+  const resolved = resolveRefs(structuredClone(data))
+  return resolved
+}
+
 export { deepMerge }

package/src/loader.test.js

@@ -1,4 +1,4 @@
-import { init, loadScene, listScenes, sceneExists, loadRecord, findRecord, deepMerge } from './loader.js'
+import { init, loadScene, listScenes, sceneExists, loadRecord, findRecord, loadObject, deepMerge } from './loader.js'
 
 const makeIndex = () => ({
   scenes: {
@@ -36,6 +36,10 @@ const makeIndex = () => ({
     'circular-obj-b': {
       nested: { $ref: 'circular-obj-a' },
     },
+    'team-info': {
+      team: 'Engineering',
+      lead: { $ref: 'jane-doe' },
+    },
   },
   records: {
     posts: [
@@ -243,3 +247,31 @@ describe('deepMerge', () => {
     expect(result.c).toBeUndefined()
   })
 })
+
+describe('loadObject', () => {
+  it('loads object by name', () => {
+    const obj = loadObject('jane-doe')
+    expect(obj).toEqual({ name: 'Jane Doe', role: 'admin' })
+  })
+
+  it('resolves $ref within object', () => {
+    const obj = loadObject('team-info')
+    expect(obj.team).toBe('Engineering')
+    expect(obj.lead).toEqual({ name: 'Jane Doe', role: 'admin' })
+  })
+
+  it('throws for missing object', () => {
+    expect(() => loadObject('nonexistent')).toThrow()
+  })
+
+  it('returns deep clone (mutations do not affect index)', () => {
+    const obj1 = loadObject('jane-doe')
+    obj1.name = 'Modified'
+    const obj2 = loadObject('jane-doe')
+    expect(obj2.name).toBe('Jane Doe')
+  })
+
+  it('detects circular $ref and throws', () => {
+    expect(() => loadObject('circular-obj-a')).toThrow(/circular/i)
+  })
+})