altitude-design 0.2.0 → 0.3.0

package/dist/types-cjs/tree.d.cts

@@ -0,0 +1,71 @@
+import * as React from 'react';
+export type TreeResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+export type TreeCreateResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: string;
+};
+/** Where a node goes: under `parentId` (null for the top level), at `index` among the children once it has left its old place. */
+export interface TreeTarget {
+    parentId: string | null;
+    index: number;
+}
+export interface TreeMove {
+    id: string;
+    from: TreeTarget;
+    to: TreeTarget;
+}
+export interface TreeHandle {
+    /** Open a naming well for a new node under `parentId` (null: the top level) at `index` (default: the end). */
+    startCreate: (parentId: string | null, index?: number) => void;
+    /** Rename a node, as F2 does. */
+    startRename: (id: string) => void;
+}
+export interface TreeProps<T> {
+    'aria-label'?: string;
+    'aria-labelledby'?: string;
+    items: T[];
+    getKey: (item: T) => string;
+    getLabel: (item: T) => string;
+    /** Children, or undefined when there are none or they aren't loaded yet. */
+    getChildren?: (item: T) => T[] | undefined;
+    /** Whether a node can have children (and so shows a chevron) before they're loaded. Default: it has children. */
+    hasChildren?: (item: T) => boolean;
+    /** Called the first time a node with no loaded children is expanded; an imprint shows until `items` includes them. */
+    loadChildren?: (item: T) => void | Promise<void>;
+    expanded?: string[];
+    defaultExpanded?: string[];
+    onExpandedChange?: (expanded: string[]) => void;
+    /** Default 'single'. */
+    selectionMode?: 'single' | 'none';
+    selected?: string | null;
+    defaultSelected?: string | null;
+    onSelectedChange?: (id: string | null) => void;
+    /** Enter's default action (open the page). */
+    onAction?: (item: T) => void;
+    /** Draw a node's label. Default: getLabel. */
+    renderItem?: (item: T) => React.ReactNode;
+    /** F2. Resolve after `items` carries the new name. */
+    onRename?: (item: T, draft: string) => TreeResult | Promise<TreeResult>;
+    /** Space to carry, or drag. Resolve after `items` reflects the move. */
+    onMove?: (move: TreeMove) => TreeResult | Promise<TreeResult>;
+    /** Refuse a target: a node can never go into its own subtree, whatever this says. */
+    canDrop?: (move: TreeMove) => boolean;
+    /** Ctrl/Cmd+Enter (sibling after) and Ctrl/Cmd+Shift+Enter (child). Resolve after `items` includes the new node. */
+    onCreate?: (request: TreeTarget & {
+        name: string;
+    }) => TreeCreateResult<T> | Promise<TreeCreateResult<T>>;
+    /** Delete. Your removal policy (recovery or confirmation) applies; the tree only asks. */
+    onRemove?: (item: T) => void;
+    className?: string;
+}
+export declare const Tree: <T>(props: TreeProps<T> & {
+    ref?: React.Ref<TreeHandle>;
+}) => React.ReactElement;

package/package.json

@@ -1,13 +1,16 @@
 {
   "name": "altitude-design",
-  "version": "0.2.0",
-  "description": "A React component library where height is the interface: the ground is the record.",
+  "version": "0.3.0",
+  "description": "A design and HCI framework for agent-built React web applications, where height is the interface.",
   "keywords": [
     "react",
     "design-system",
     "components",
     "elevation",
-    "ui"
+    "ui",
+    "hci",
+    "workflow",
+    "agents"
   ],
   "license": "MIT",
   "homepage": "https://richlaconte.github.io/altitude/",
@@ -24,17 +27,46 @@
   "types": "./dist/types/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/types/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "import": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/types-cjs/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
     },
+    "./chart-themes": {
+      "import": {
+        "types": "./dist/types/chart-themes.d.ts",
+        "default": "./dist/chart-themes.js"
+      },
+      "require": {
+        "types": "./dist/types-cjs/chart-themes.d.cts",
+        "default": "./dist/chart-themes.cjs"
+      }
+    },
+    "./adapters/tiptap.css": "./dist/adapters/tiptap.css",
+    "./adapters/codemirror": {
+      "import": {
+        "types": "./dist/types/adapter-codemirror.d.ts",
+        "default": "./dist/adapters/codemirror.js"
+      },
+      "require": {
+        "types": "./dist/types-cjs/adapter-codemirror.d.cts",
+        "default": "./dist/adapters/codemirror.cjs"
+      }
+    },
+    "./adapters/react-flow.css": "./dist/adapters/react-flow.css",
     "./altitude.css": "./dist/altitude.css",
     "./altitude.no-fonts.css": "./dist/altitude.no-fonts.css",
     "./fonts.css": "./dist/fonts.css",
     "./tokens.css": "./dist/tokens.css",
     "./tokens.json": "./dist/tokens.json",
     "./altitude.iife.js": "./dist/altitude.iife.js",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./guidance": "./dist/guidance/index.json",
+    "./guidance/*": "./dist/guidance/*"
   },
   "files": [
     "dist"
@@ -46,26 +78,75 @@
     "node": ">=20"
   },
   "peerDependencies": {
+    "@codemirror/language": ">=6.0.0",
+    "@codemirror/state": ">=6.0.0",
+    "@codemirror/view": ">=6.0.0",
+    "@lezer/highlight": ">=1.0.0",
+    "@tiptap/core": ">=2.0.0",
+    "@xyflow/react": ">=12.0.0",
     "react": "^18.2.0 || ^19.0.0",
     "react-dom": "^18.2.0 || ^19.0.0"
   },
+  "peerDependenciesMeta": {
+    "@tiptap/core": {
+      "optional": true
+    },
+    "@codemirror/language": {
+      "optional": true
+    },
+    "@codemirror/state": {
+      "optional": true
+    },
+    "@codemirror/view": {
+      "optional": true
+    },
+    "@lezer/highlight": {
+      "optional": true
+    },
+    "@xyflow/react": {
+      "optional": true
+    }
+  },
   "scripts": {
     "build": "node scripts/build-package.mjs",
-    "typecheck": "tsc -p tsconfig.json --noEmit --declaration false --emitDeclarationOnly false",
+    "typecheck": "tsc -p tsconfig.json --noEmit --declaration false --emitDeclarationOnly false && tsc -p examples/apps/tsconfig.json",
     "storybook": "node scripts/stories.mjs && storybook dev -p 6006",
-    "build-storybook": "node scripts/stories.mjs && storybook build -o storybook-static --quiet"
+    "build-storybook": "node scripts/stories.mjs && storybook build -o storybook-static --quiet",
+    "build-site": "node scripts/build-site.mjs",
+    "check:guidance": "node build/checks/guidance.mjs",
+    "check:tells": "node build/checks/tells-freshness.mjs",
+    "check:tells-lint": "node build/checks/tells-lint.mjs",
+    "check:agent-setup": "node build/checks/agent-setup.mjs",
+    "check:framework": "node scripts/check-framework.mjs"
   },
   "devDependencies": {
+    "@codemirror/commands": "6.11.1",
+    "@codemirror/lang-json": "6.0.2",
+    "@codemirror/language": "6.13.1",
+    "@codemirror/lint": "6.9.7",
+    "@codemirror/state": "6.7.6",
+    "@codemirror/view": "6.43.15",
+    "@lezer/highlight": "1.2.5",
     "@storybook/addon-docs": "10.6.1",
     "@storybook/react-vite": "10.6.1",
+    "@tiptap/extension-mention": "3.32.1",
+    "@tiptap/pm": "3.32.1",
+    "@tiptap/react": "3.32.1",
+    "@tiptap/starter-kit": "3.32.1",
+    "@tiptap/suggestion": "3.32.1",
     "@types/react": "19.3.0",
     "@types/react-dom": "19.3.0",
     "@vitejs/plugin-react": "6.1.2",
+    "@xyflow/react": "12.12.0",
+    "axe-core": "4.14.0",
     "esbuild": "0.28.2",
     "react": "19.3.0",
     "react-dom": "19.3.0",
     "storybook": "10.6.1",
     "typescript": "5.6.3",
     "vite": "8.3.3"
+  },
+  "bin": {
+    "altitude": "./dist/cli/altitude.mjs"
   }
 }