@hollis-labs/kit-admin 0.0.0-stage → 0.2.0

package/dist/src/types.d.ts

@@ -0,0 +1,93 @@
+import { ReactNode } from 'react';
+import { SettingsGroup, SettingsProvenanceRendererProps, SettingsProvenanceState, SettingsWizardProps } from '@hollis-labs/kit-settings';
+import { HealthSummaryProps, StatObservation, DiagnosticPanelProps, ObservationUnit, ObservationKind } from '@hollis-labs/kit-observe';
+import { SampleSeriesViewProps } from '@hollis-labs/kit-observe/charts';
+/** View projections only. The host validates wire schemas, endpoints, auth and bounds. */
+export interface AdminDeclaration {
+    readonly id: string;
+    readonly label: string;
+    readonly section: string;
+}
+export interface AdminObservationDeclaration extends AdminDeclaration {
+    readonly stale_after_ms: number;
+}
+export interface AdminSettingsDeclaration extends SettingsGroup {
+    readonly section: string;
+    readonly scope?: {
+        readonly kind: string;
+        readonly id?: string;
+    };
+}
+export interface AdminStatDeclaration extends AdminObservationDeclaration {
+    readonly unit: ObservationUnit;
+    readonly kind: ObservationKind;
+}
+export interface AdminSeriesDeclaration extends AdminStatDeclaration {
+    readonly max_points: number;
+    readonly max_window_seconds: number;
+}
+export interface AdminDiagnosticDeclaration extends AdminObservationDeclaration {
+    readonly schema: DiagnosticPanelProps['schema'];
+}
+export interface AdminManifest {
+    readonly contract_version: number;
+    readonly app: {
+        readonly id: string;
+        readonly label: string;
+    };
+    readonly revision: string;
+    readonly settings: readonly AdminSettingsDeclaration[];
+    readonly health: readonly AdminObservationDeclaration[];
+    readonly stats: readonly AdminStatDeclaration[];
+    readonly series: readonly AdminSeriesDeclaration[];
+    readonly diagnostics: readonly AdminDiagnosticDeclaration[];
+}
+export type AdminPage = 'dashboard' | 'settings' | 'status' | 'diagnostics';
+export interface AdminTarget {
+    readonly page: AdminPage;
+    readonly groupId?: string;
+}
+export type AdminDestination = {
+    readonly href: string;
+    readonly onSelect?: never;
+} | {
+    readonly onSelect: () => void;
+    readonly href?: never;
+};
+export interface AdminSelection extends AdminTarget {
+    readonly mode?: 'edit' | 'setup';
+}
+export interface AdminDiscovery {
+    readonly phase: 'loading' | 'ready' | 'error';
+    /** Must match the active authorized host context; never retain a prior principal. */
+    readonly contextKey: string;
+    readonly manifest?: AdminManifest;
+    readonly error?: string;
+}
+export interface AdminSettingsRead {
+    readonly phase: 'loading' | 'ready' | 'error';
+    readonly state?: SettingsProvenanceState;
+    readonly error?: string;
+}
+export interface AdminObservations {
+    readonly health?: Readonly<Record<string, Omit<HealthSummaryProps, 'label'> | undefined>>;
+    readonly stats?: Readonly<Record<string, Pick<StatObservation, 'value' | 'observation'> | undefined>>;
+    readonly series?: Readonly<Record<string, Omit<SampleSeriesViewProps, 'label' | 'unit' | 'kind' | 'bounds'> | undefined>>;
+    readonly diagnostics?: Readonly<Record<string, Omit<DiagnosticPanelProps, 'label' | 'schema'> | undefined>>;
+}
+export interface AdminContentProps {
+    readonly contextKey: string;
+    readonly discovery: AdminDiscovery;
+    readonly selection: AdminSelection;
+    /** Host maps canonical targets to its routes or controlled navigation callbacks. */
+    readonly destination: (target: AdminTarget) => AdminDestination;
+    readonly settings?: Readonly<Record<string, AdminSettingsRead | undefined>>;
+    readonly settingsActions?: Pick<SettingsProvenanceRendererProps, 'onDraftChange' | 'onSave' | 'onReset' | 'onValidate' | 'onApply'>;
+    readonly setup?: Omit<SettingsWizardProps, 'contractVersion' | 'groups' | 'states' | 'onDraftChange'>;
+    /** Context/metadata beside the Wizard; never a second editable form. */
+    readonly setupContext?: ReactNode;
+    readonly observations?: AdminObservations;
+    readonly nowMs: number;
+    /** Explicit opt-in: root imports no chart implementation. See /charts. */
+    readonly renderSeries?: (props: SampleSeriesViewProps) => ReactNode;
+}

package/package.json

@@ -1,6 +1,96 @@
 {
   "name": "@hollis-labs/kit-admin",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "description": "Controlled manifest-driven admin navigation and page composition; host-owned data, routes and commands.",
+  "keywords": [
+    "react",
+    "admin",
+    "design-system"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hollis-labs/frontend-support.git",
+    "directory": "ts/design-kit/packages/kit-admin"
+  },
+  "homepage": "https://github.com/hollis-labs/frontend-support/tree/main/ts/design-kit/packages/kit-admin#readme",
+  "bugs": {
+    "url": "https://github.com/hollis-labs/frontend-support/issues"
+  },
+  "type": "module",
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "files": [
+    "dist",
+    "src/styles",
+    "CHANGELOG.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./source.css": "./src/styles/source.css",
+    "./charts": {
+      "types": "./dist/src/charts.d.ts",
+      "import": "./dist/charts.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/src/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && vite build",
+    "prepack": "npm run build",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "lint": "eslint .",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "demo": "vite --config demo/vite.config.ts",
+    "demo:build": "vite build --config demo/vite.config.ts",
+    "prebuild": "node scripts/build-dependencies.mjs"
+  },
+  "peerDependencies": {
+    "tailwindcss": "^4.0.0",
+    "@base-ui/react": "^1.3.0",
+    "lucide-react": "^1.7.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "dependencies": {
+    "@hollis-labs/design-components": "^0.5.0",
+    "@hollis-labs/design-tokens": "^0.5.0",
+    "@hollis-labs/kit-dashboard": "^0.6.0",
+    "@hollis-labs/kit-settings": "^0.2.0",
+    "@hollis-labs/kit-observe": "^0.1.1"
+  },
+  "devDependencies": {
+    "@base-ui/react": "^1.3.0",
+    "@eslint/js": "^9.39.4",
+    "@hollis-labs/eslint-config-design": "^0.5.0",
+    "@testing-library/react": "^16.3.2",
+    "@types/node": "^24.12.2",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "4.7.0",
+    "eslint": "^9.39.4",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-react-refresh": "^0.5.2",
+    "globals": "^17.4.0",
+    "jsdom": "^25.0.1",
+    "lucide-react": "^1.7.0",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "typescript": "~6.0.2",
+    "vite": "5.4.21",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^2.1.9",
+    "@tailwindcss/vite": "^4.0.0",
+    "typescript-eslint": "^8.58.0"
+  }
+}

package/src/styles/source.css

@@ -0,0 +1 @@
+@source "../../dist";