@woodsportal/hubspot-kit 1.0.4 → 1.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@woodsportal/hubspot-kit",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "WoodsCLI — HubSpot CMS dev kit by WoodsPortal. wp CLI, Vite presets, module-config overlay, and theme/module build pipelines.",
   "type": "module",
   "main": "./dist/index.js",
@@ -14,6 +14,9 @@
     "vite",
     "templates",
     "examples",
+    "src/dev",
+    "src/dev-module-config",
+    "src/routing",
     "README.md",
     "CHANGELOG.md",
     "SECURITY.md",

package/src/dev/bootstrap-greenfield.tsx

@@ -0,0 +1,51 @@
+/**
+ * Greenfield / wp init dev shell — module-config overlay only (no full portal app).
+ * Use after `wp init`; adopt `dev/bootstrap` when wiring a real WoodsPortal consumer app.
+ */
+import { createRoot } from 'react-dom/client'
+
+import {
+  bindModuleConfigToHubSpotData,
+  setModuleConfigAdapter,
+  syncHubSpotDataFromModuleState,
+} from '@/dev/module-config/runtime/module-config-bridge'
+import { initModuleConfigRuntime } from '@/dev/module-config/runtime/module-config-runtime'
+import {
+  ModuleConfigOverlay,
+  registerModuleConfigShortcutHint,
+} from '@/dev/module-config/ui/ModuleConfigOverlay'
+import wphsAdapter from '@wphs/adapter'
+
+export async function mountGreenfieldDev(): Promise<void> {
+  const rootElement = document.getElementById('app')
+
+  try {
+    setModuleConfigAdapter(wphsAdapter)
+    bindModuleConfigToHubSpotData()
+    const moduleState = await initModuleConfigRuntime()
+    syncHubSpotDataFromModuleState(moduleState)
+    registerModuleConfigShortcutHint()
+
+    if (!rootElement) {
+      throw new Error('Missing #app element — add index.html with <div id="app">')
+    }
+
+    createRoot(rootElement).render(
+      <>
+        <ModuleConfigOverlay />
+        <main style={{ padding: '1.5rem', fontFamily: 'system-ui, sans-serif' }}>
+          <h1>WoodsCLI dev</h1>
+          <p>
+            Edit HubSpot module fields with <kbd>Ctrl+Shift+Z</kbd> (Mac: <kbd>⌃⇧Z</kbd>).
+          </p>
+        </main>
+      </>
+    )
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error)
+    if (rootElement) {
+      rootElement.innerHTML = `<pre style="padding:1rem;font-family:system-ui;color:#b91c1c;white-space:pre-wrap">WoodsCLI dev failed to start:\n${message}</pre>`
+    }
+    console.error('[woodscli] mountGreenfieldDev failed', error)
+  }
+}

package/src/dev/bootstrap.tsx

@@ -0,0 +1,46 @@
+/**
+ * Kit-owned local dev bootstrap — module-config overlay + live export provider.
+ * Never imported in production CDN/HubSpot builds.
+ */
+import { createRoot } from 'react-dom/client'
+
+import { mountPortal, router } from '@/portal/mount-portal'
+import {
+  bindModuleConfigToHubSpotData,
+  setModuleConfigAdapter,
+  syncHubSpotDataFromModuleState,
+} from '@/dev/module-config/runtime/module-config-bridge'
+import { initModuleConfigRuntime } from '@/dev/module-config/runtime/module-config-runtime'
+import {
+  ModuleConfigOverlay,
+  registerModuleConfigShortcutHint,
+} from '@/dev/module-config/ui/ModuleConfigOverlay'
+import { useDevModuleConfigLiveRevision } from '@/dev/module-config/ui/use-dev-module-config-live-revision'
+import { DevHubSpotLiveProvider } from '@/integrations/dev-hubspot-live-provider'
+import { App } from '@/app'
+import wphsAdapter from '@wphs/adapter'
+
+export async function mountDevPortal(): Promise<void> {
+  setModuleConfigAdapter(wphsAdapter)
+  bindModuleConfigToHubSpotData()
+  const moduleState = await initModuleConfigRuntime()
+  syncHubSpotDataFromModuleState(moduleState)
+  registerModuleConfigShortcutHint()
+
+  await mountPortal({ includeGlobalStyles: true, skipAppRender: true })
+
+  const rootElement = document.getElementById('app')
+  if (!rootElement) return
+
+  function DevRoot() {
+    const revision = useDevModuleConfigLiveRevision()
+    return (
+      <DevHubSpotLiveProvider revision={revision}>
+        <ModuleConfigOverlay />
+        <App router={router} />
+      </DevHubSpotLiveProvider>
+    )
+  }
+
+  createRoot(rootElement).render(<DevRoot />)
+}