@cheezmil/aek-base 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,60 @@
-# Temporary Holding Version
+---
+description: "AEK base identity layer — rebrands the dsh web UI sidebar and startup announcement for AEK deployments."
+kind: "package-reference"
+---
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @cheezmil/aek-base
+
+The AEK base identity layer. It rebrands two user-visible surfaces of a dsh web
+profile so they read as AEK instead of DeepSeek Harness:
+
+- the **sidebar brand** — fills the `sidebar.brand.mark` and `sidebar.brand.name`
+  slots with the AEK orange-slice mark and the `AEK` name, replacing the shell's
+  fish-mark and `brand.localBuild` fallback;
+- the **startup announcement** — prints the `aek web: <url>` readiness line,
+  replacing the dsh web-app bundle's own `dsh web:` line (which the web profile
+  suppresses with `printUrl: false`).
+
+The document title is rebranded separately through the `DSH_CLIENT_TITLE` build
+environment value, which `AppFrame` already reads. This package has no runtime
+state and does not affect model requests.
+
+## Use this package
+
+Install it into a dsh web profile and register it in the profile's cordis patch:
+
+```yaml
+- id: aek-base
+  name: '@cheezmil/aek-base'
+```
+
+Suppress the dsh bundle's own URL line so only the AEK line prints:
+
+```yaml
+- id: web-app
+  name: '@deepseek-ai/dsh-web-app'
+  config:
+    printUrl: false
+```
+
+## Understand the implementation
+
+The host half (`src/index.ts`) injects the `connection` service and prints
+`aek web: <authenticatedUrl>` once, mirroring the web-app bundle's readiness
+line. The client half (`src/client/index.ts`) injects the `slots` service and
+registers the AEK mark and name into the sidebar brand slots as one
+declaration-aware set, the same pattern as `@deepseek-ai/dsh-client-ui-brand-official`.
+
+## Model Experience
+
+No effect on model requests, token usage, or KV-cache behavior. The package
+changes only browser presentation and process stdout.
+
+## Known Limitations and Deferred Work
+
+- The AEK name is plain localized text, not an SVG wordmark; a designed
+  wordmark can replace `AekBrandName` later.
+- The host half prints as soon as the `connection` service mounts; it does not
+  wait for the full Loader tree to settle (sufficient for a human-readable
+  readiness line; a supervisor that RPCs on seeing the line should wait for
+  the dsh bundle's own loader-gated signal).

package/lib/client.js

@@ -0,0 +1,19 @@
+window.__ModuleLoader__.load({
+	id: "@cheezmil/aek-base",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		//#region src/client/index.ts
+		/** aek-home owns the surface; aek-base contributes no client UI. */
+		const inject = [];
+		/** Identity no-op: the AEK brand now lives in aek-home's own surface. */
+		function apply(_ctx) {}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/index.js

@@ -0,0 +1,28 @@
+//#region lib/types/index.js
+/**
+* AEK base identity layer, host half. Prints the `aek web:` readiness line.
+* The dsh web-app bundle's own `dsh web:` line is suppressed via
+* `printUrl: false` in the web profile's cordis patch, so AEK surfaces the
+* AEK-prefixed URL instead. Set `DSH_CLIENT_TITLE` at build time to rebrand
+* the document title; this host half owns the process-stdout announcement.
+* @module @cheezmil/aek-base
+*/
+/** Stable Cordis plugin name. */
+const name = "aek-base";
+/** Services required before the AEK URL line can print. */
+const inject = ["webServer"];
+const ANNOUNCED_ROOTS = /* @__PURE__ */ new WeakSet();
+/**
+* Print the `aek web:` readiness line once the connection service mounts.
+* @param ctx - plugin context carrying the webServer service.
+*/
+function apply(ctx) {
+	ctx.inject(["connection"], (connectionCtx) => {
+		if (ANNOUNCED_ROOTS.has(connectionCtx.root)) return;
+		const url = connectionCtx.connection.authenticatedUrl(ctx.webServer.getOrigin());
+		ANNOUNCED_ROOTS.add(connectionCtx.root);
+		console.log(`aek web: ${url}`);
+	});
+}
+//#endregion
+export { apply, inject, name };

package/lib/types/client/Brand.d.ts

@@ -0,0 +1,13 @@
+import type { SidebarBrandMarkOwnerProps } from '@deepseek-ai/dsh-client-ui-sidebar/client';
+/**
+ * The AEK brand mark — an orange slice, at the requested square edge.
+ * @param props.size - square edge in pixels.
+ * @returns the orange-slice svg (aria-hidden; pair with the name for accessibility).
+ */
+export declare function AekBrandMark({ size }: SidebarBrandMarkOwnerProps): import("react").JSX.Element;
+/**
+ * The AEK brand name wordmark.
+ * @returns the AEK name as localized text.
+ */
+export declare function AekBrandName(): import("react").JSX.Element;
+//# sourceMappingURL=Brand.d.ts.map

package/lib/types/client/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * AEK base identity layer, client half. With aek-home as the direct-render
+ * application root and the dsh sidebar/shell disabled, there are no sidebar
+ * brand slots to fill; the client half is an identity no-op. The host half
+ * still prints `aek web:` and pins the AEK home dir.
+ * @module @cheezmil/aek-base/src/client/index
+ */
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
+/** aek-home owns the surface; aek-base contributes no client UI. */
+export declare const inject: readonly string[];
+/** Identity no-op: the AEK brand now lives in aek-home's own surface. */
+export declare function apply(_ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * AEK base identity layer, host half. Prints the `aek web:` readiness line.
+ * The dsh web-app bundle's own `dsh web:` line is suppressed via
+ * `printUrl: false` in the web profile's cordis patch, so AEK surfaces the
+ * AEK-prefixed URL instead. Set `DSH_CLIENT_TITLE` at build time to rebrand
+ * the document title; this host half owns the process-stdout announcement.
+ * @module @cheezmil/aek-base
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Stable Cordis plugin name. */
+export declare const name = "aek-base";
+/** Services required before the AEK URL line can print. */
+export declare const inject: string[];
+/**
+ * Print the `aek web:` readiness line once the connection service mounts.
+ * @param ctx - plugin context carrying the webServer service.
+ */
+export declare function apply(ctx: Context): void;
+//# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,6 +1,62 @@
 {
   "name": "@cheezmil/aek-base",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "description": "AEK base identity layer: pins the AEK home dir and prints the `aek web:` startup line; the client half is an identity no-op (aek-home owns the surface)",
+  "version": "1.0.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./types": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "client": {
+      "inject": [],
+      "platform": "web"
+    }
+  },
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=4.0.0",
+    "@deepseek-ai/cosmokit": ">=1.8.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.5",
+    "@deepseek-ai/cosmokit": "^1.8.6",
+    "@deepseek-ai/dsh-client-connection": "workspace:*",
+    "@deepseek-ai/dsh-client-ui-primitives": "workspace:*",
+    "@deepseek-ai/dsh-client-ui-renderer": "workspace:*",
+    "@deepseek-ai/dsh-client-ui-sidebar": "workspace:*",
+    "@deepseek-ai/dsh-host-webserver": "workspace:*",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "aek": {
+    "type": "dsh-bundle",
+    "description": "AEK identity layer: re-exports Context/Volatile/ClientContext types and prints the aek web: readiness line"
+  }
+}