@devframes/hub-ui 0.9.0-beta.1 → 0.9.0-beta.3

package/dist/client/standalone/index.html

@@ -20,10 +20,9 @@
         height: 100%;
       }
     </style>
-    <script type="module" crossorigin src="./assets/index-BDzp-bCc.js"></script>
-    <link rel="modulepreload" crossorigin href="./assets/preload-helper-CyyvF4ac.js">
-    <link rel="modulepreload" crossorigin href="./assets/client-BN8PboYb.js">
-    <link rel="modulepreload" crossorigin href="./assets/color-mode-BPeeQXcs.js">
+    <script type="module" crossorigin src="./assets/index-GsUzOyW2.js"></script>
+    <link rel="modulepreload" crossorigin href="./assets/branding-1d9zClAZ.js">
+    <link rel="modulepreload" crossorigin href="./assets/client-CaZDLKXI.js">
   </head>
   <body>
     <div id="app"></div>

package/dist/index.d.mts

@@ -1,4 +1,52 @@
 import { DevframeHubUi } from "@devframes/hub/initiate";
+//#region src/client/dock-preferences.d.ts
+/**
+ * The reference UI's dock-bar rendering preferences, set via
+ * `createUi({ dockPreferences })` and published as
+ * `ConnectionMeta.configs.ui.dockPreferences`. Read by the embedded dock and
+ * the standalone viewer at boot.
+ *
+ * Like the float/edge dock mode, these seed user-overridable state — the
+ * config sets the default, the visitor's own choice wins from then on.
+ */
+interface DevframeDockPreferences {
+  /**
+   * The top-level dock-bar **category** ordering — a map of category id →
+   * ordering weight (lower sorts earlier), merged beneath
+   * `DEFAULT_CATEGORIES_ORDER`.
+   */
+  categoryOrder?: Record<string, number>;
+  /**
+   * Preferred inline-item capacity for the floating dock bar before entries
+   * overflow. Edge mode ignores it — it shows every entry with no cutoff.
+   */
+  maxVisibleItems?: number;
+  /** Seeds a first-run visitor's dock mode (float vs edge). */
+  defaultMode?: 'float' | 'edge';
+  /** Seeds a first-run visitor's dock position. */
+  defaultPosition?: 'left' | 'right' | 'top' | 'bottom';
+}
+//#endregion
+//#region src/client/embedded/visibility.d.ts
+/**
+ * How the embedded floating dock reveals itself on a fresh page — the
+ * reference UI's port of Nuxt DevTools' opt-in overlay, published as
+ * `ConnectionMeta.configs.ui.embeddedVisibility` and set via
+ * `createUi({ embeddedVisibility })`.
+ *
+ * - `normal` (default) — the dock is shown immediately.
+ * - `passive` — the dock starts hidden and a console hint offers the reveal
+ *   shortcut; revealing persists per-origin, so later sessions on this
+ *   browser start shown. The "Hide" command returns to passive.
+ * - `hidden` — the dock starts hidden and the shortcut reveals it for the
+ *   current session only; nothing is persisted.
+ *
+ * Whatever the policy, the reveal state is a user-overridable preference —
+ * the same shape as the float/edge dock mode: the config seeds it, the
+ * visitor's own reveal/hide wins from then on.
+ */
+type EmbeddedVisibility = 'normal' | 'passive' | 'hidden';
+//#endregion
 //#region ../../node_modules/.pnpm/@vue+shared@3.5.41/node_modules/@vue/shared/dist/shared.d.ts
 type Prettify<T> = { [K in keyof T]: T[K]; } & {};
 type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends ((k: infer I) => void) ? I : never;
@@ -21544,11 +21592,12 @@ type BrandingLogo = string | {
 };
 /**
  * Consumer-facing branding for the reference hub-ui. Every field is optional
- * and falls back to devframe's own identity. Delivered three ways, merged
- * field-by-field (later wins): the `branding.json` `createUi({ branding })`
- * publishes, then the host page (a `window.__DEVFRAME_BRANDING__` global or
- * `data-*` attrs on the embedding `<script>`, or `?query` params on the
- * standalone viewer).
+ * and falls back to devframe's own identity. Published as
+ * `ConnectionMeta.configs.ui.branding` via `createUi({ branding })`, and
+ * read from the one connection handshake the dock already performs —
+ * `ConnectionMeta` has its own cross-realm propagation (see
+ * `DEVFRAME_CONNECTION_KEY`), so branding needs no globals or query params
+ * of its own.
  */
 interface DevframeBranding {
   /** Product name — the wordmark, window titles, and all user-visible copy. */
@@ -21568,6 +21617,15 @@ interface DevframeBranding {
 }
 //#endregion
 //#region src/index.d.ts
+declare module 'devframe/types' {
+  interface DevframeConnectionConfigsRegistry {
+    ui: {
+      branding?: DevframeBranding;
+      embeddedVisibility?: EmbeddedVisibility;
+      dockPreferences?: DevframeDockPreferences;
+    };
+  }
+}
 interface CreateUiOptions {
   /** Serve the standalone viewer SPA at the hub base. Default: `true`. */
   viewer?: boolean;
@@ -21575,12 +21633,33 @@ interface CreateUiOptions {
   embedded?: boolean;
   /**
    * Rebrand the reference UI — logo, product name, primary color, and more.
-   * Published as `<base>branding.json` (via the hub's generic `assets` seam)
-   * and fetched by the dock at boot. Reaches both the embedded dock and the
-   * standalone viewer. A host page can still override any field at runtime via
-   * `window.__DEVFRAME_BRANDING__` / `<script data-*>` / `?query` params.
+   * Published as `ConnectionMeta.configs.ui.branding`, read by the dock at
+   * boot from the one connection handshake it already performs. Reaches
+   * both the embedded dock and the standalone viewer.
    */
   branding?: DevframeBranding;
+  /**
+   * How the embedded floating dock reveals itself on a fresh page:
+   *
+   * - `'normal'` (default) — shown immediately.
+   * - `'passive'` — starts hidden with a console hint; `Shift+Alt+D` reveals
+   *   it, and the reveal persists per-origin so later sessions start shown.
+   * - `'hidden'` — starts hidden; `Shift+Alt+D` reveals it for the current
+   *   session only.
+   *
+   * Published as `ConnectionMeta.configs.ui.embeddedVisibility`. Like the
+   * float/edge dock mode, it seeds a user-overridable preference — the
+   * visitor's own reveal/hide wins from then on. Applies to the embedded
+   * dock only; the standalone viewer is an explicit visit and always shows.
+   */
+  embeddedVisibility?: EmbeddedVisibility;
+  /**
+   * Dock-bar rendering preferences — category ordering, floating-dock
+   * inline-item capacity, and the first-run float/edge mode and position.
+   * Published as `ConnectionMeta.configs.ui.dockPreferences`; each seeds a
+   * user-overridable preference the visitor's own choice then wins.
+   */
+  dockPreferences?: DevframeDockPreferences;
 }
 /**
  * The reference implementation of the hub's {@link DevframeHubUi} slot —
@@ -21601,4 +21680,4 @@ interface CreateUiOptions {
  */
 declare function createUi(options?: CreateUiOptions): DevframeHubUi;
 //#endregion
-export { CreateUiOptions, type DevframeBranding, createUi };
+export { CreateUiOptions, type DevframeBranding, type DevframeDockPreferences, type EmbeddedVisibility, createUi };

package/dist/index.mjs

@@ -36,7 +36,13 @@ function createUi(options = {}) {
 	return {
 		...options.viewer !== false ? { viewer: { distDir: join(client, "standalone") } } : {},
 		...options.embedded !== false ? { embedded: { entry: join(client, "embedded.js") } } : {},
-		...options.branding ? { assets: { "branding.json": () => JSON.stringify(options.branding) } } : {}
+		setup(ctx) {
+			ctx.staticConfig.ui = {
+				branding: options.branding || {},
+				...options.embeddedVisibility ? { embeddedVisibility: options.embeddedVisibility } : {},
+				...options.dockPreferences ? { dockPreferences: options.dockPreferences } : {}
+			};
+		}
 	};
 }
 //#endregion

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devframes/hub-ui",
   "type": "module",
-  "version": "0.9.0-beta.1",
+  "version": "0.9.0-beta.3",
   "description": "Reference UI for the devframe hub, providing the floating dock and standalone viewer.",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -29,9 +29,9 @@
     "dist"
   ],
   "peerDependencies": {
-    "@devframes/json-render": "0.9.0-beta.1",
-    "@devframes/hub": "0.9.0-beta.1",
-    "devframe": "0.9.0-beta.1"
+    "@devframes/json-render": "0.9.0-beta.3",
+    "devframe": "0.9.0-beta.3",
+    "@devframes/hub": "0.9.0-beta.3"
   },
   "devDependencies": {
     "@antfu/design": "^0.3.4",
@@ -53,9 +53,10 @@
     "unocss": "^66.7.5",
     "vite": "^8.2.1",
     "vue": "^3.5.41",
-    "devframe": "0.9.0-beta.1",
-    "@devframes/hub": "0.9.0-beta.1",
-    "@devframes/json-render": "0.9.0-beta.1"
+    "@devframes/hub": "0.9.0-beta.3",
+    "@devframes/json-render": "0.9.0-beta.3",
+    "@devframes/plugin-git": "0.9.0-beta.3",
+    "devframe": "0.9.0-beta.3"
   },
   "scripts": {
     "build": "pnpm run build:css && pnpm run build:node && pnpm run build:embedded && pnpm run build:standalone",
@@ -63,6 +64,7 @@
     "build:node": "tsdown",
     "build:embedded": "vite build --config vite.embedded.config.ts",
     "build:standalone": "vite build --config src/client/standalone/vite.config.ts",
+    "dev": "pnpm -C ../.. exec turbo run build --filter=@devframes/hub... --filter=@devframes/plugin-git... && vite --config playground/vite.config.ts",
     "typecheck": "tsc --noEmit",
     "storybook": "storybook dev -p 6014",
     "build-storybook": "storybook build"