@quietloudlab/ai-interaction-atlas 1.0.0

package/dist/types.d.mts

@@ -0,0 +1,294 @@
+/**
+ * Copyright 2025 quietloudlab
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+interface Meta {
+    title: string;
+    description: string;
+    version: string;
+    schema_version: string;
+}
+interface LayerGuidance {
+    when_to_use: string;
+    typical_position: string;
+    red_flags: string[];
+}
+interface Layer {
+    id: string;
+    name: string;
+    slug: string;
+    role: string;
+    description: string;
+    color: string;
+    guidance?: LayerGuidance;
+}
+type IOItem = string | {
+    id: string;
+    label: string;
+    isArray?: boolean;
+};
+interface IOSpec {
+    inputs: {
+        required: IOItem[];
+        optional: IOItem[];
+    };
+    constraints?: {
+        optional: IOItem[];
+    };
+    outputs: {
+        primary: IOItem;
+        metadata: IOItem[];
+    };
+}
+interface ImplementationNotes {
+    maturity: 'emerging' | 'established' | 'commoditized';
+    typical_latency: 'realtime' | 'interactive' | 'batch';
+    data_requirements: 'none' | 'small' | 'medium' | 'large' | 'continuous';
+    human_oversight: 'none' | 'optional' | 'recommended' | 'required';
+}
+interface UxNotes {
+    risk: string;
+    tip: string;
+    anti_patterns: string[];
+}
+interface Capability {
+    name: string;
+    tag: string;
+    example: string;
+}
+interface Relation {
+    target_id: string;
+    type: string;
+    strength: string;
+    reason: string;
+}
+interface BaseTask {
+    id: string;
+    layer_id: string;
+    name: string;
+    slug: string;
+    elevator_pitch: string;
+    example_usage: string;
+    io_spec: IOSpec;
+}
+interface AiTask extends BaseTask {
+    task_type: 'ai';
+    implementation_notes: ImplementationNotes;
+    ux_notes: UxNotes;
+    capabilities: Capability[];
+    relations: Relation[];
+}
+interface HumanTask extends BaseTask {
+    task_type: 'human';
+    common_variants: string[];
+    relations: Relation[];
+}
+interface SystemTask extends BaseTask {
+    task_type: 'system';
+    common_variants: string[];
+    relations: Relation[];
+}
+type Task = AiTask | HumanTask | SystemTask;
+type DataCategory = 'text' | 'visual' | 'audio' | 'structured' | 'compound' | 'user_input' | 'system' | 'generic';
+interface DataArtifactDefinition {
+    id: string;
+    name: string;
+    category: DataCategory;
+    icon: string;
+    description?: string;
+    examples?: string[];
+    compatible_with?: string[];
+    format_notes?: string;
+}
+type ConstraintCategory = 'quality_safety' | 'performance_resource' | 'model_technical' | 'ux_interaction' | 'data_context' | 'execution_behavior' | 'code_philosophy' | 'attribution';
+interface ConstraintDefinition {
+    id: string;
+    name: string;
+    category: ConstraintCategory;
+    icon: string;
+    description?: string;
+    type?: string;
+    applies_to?: string[];
+    ux_note?: string;
+    example_values?: string;
+}
+type TouchpointCategory = 'screen_interface' | 'conversational' | 'voice_audio' | 'spatial_computing' | 'technical' | 'physical_devices';
+interface TouchpointDefinition {
+    id: string;
+    name: string;
+    category: TouchpointCategory;
+    icon: string;
+    description: string;
+    examples: string[];
+}
+interface TemplateAttachment {
+    id: string;
+    referenceId: string;
+    type: 'data' | 'constraint';
+    direction?: 'input' | 'output';
+    notes?: string;
+}
+interface WorkflowTaskStep {
+    task_id: string;
+    position: number;
+    label: string;
+    optional?: boolean;
+    conditional?: string;
+    notes?: string;
+    id?: string;
+    node_type?: 'task' | 'data' | 'constraint' | 'annotation' | 'touchpoint' | 'actor';
+    row?: number;
+    col?: number;
+    width?: number;
+    height?: number;
+    attachments?: TemplateAttachment[];
+    personaId?: string;
+    subType?: 'note' | 'zone';
+    customLabel?: string;
+    capability?: string;
+    color?: string;
+    customDefinition?: {
+        name: string;
+        description?: string;
+        icon?: string;
+        task_type?: 'ai' | 'human' | 'system';
+        layer_id?: string;
+    };
+}
+interface WorkflowTemplateEdge {
+    source: string;
+    target: string;
+    label?: string;
+    attachments?: TemplateAttachment[];
+    customX?: number;
+    customY?: number;
+    sourceX?: number;
+    targetX?: number;
+    sourceHandle?: 'left' | 'right' | 'top' | 'bottom';
+    targetHandle?: 'left' | 'right' | 'top' | 'bottom';
+}
+interface WorkflowTemplate {
+    id: string;
+    name: string;
+    description: string;
+    primary_use_case: string;
+    nodes: BuilderNode[];
+    edges: BuilderEdge[];
+    common_variations: string[];
+    complexity?: string;
+    tags?: string[];
+    personas?: Persona[];
+}
+interface Node {
+    task_id: string;
+    x: number;
+    y: number;
+    label: string;
+}
+interface Example {
+    id: string;
+    primary_task_id: string;
+    title: string;
+    description: string;
+    industry: string;
+    complexity: 'Low' | 'Medium' | 'High';
+    tags: string[];
+    image_url: string;
+    nodes: Node[];
+}
+interface AtlasData {
+    meta: Meta;
+    layers: Layer[];
+    ai_tasks: AiTask[];
+    human_tasks: HumanTask[];
+    system_tasks: SystemTask[];
+    data_artifacts: DataArtifactDefinition[];
+    constraints: ConstraintDefinition[];
+    touchpoints: TouchpointDefinition[];
+    workflow_templates: WorkflowTemplate[];
+    examples: Example[];
+}
+type NodeType = 'task' | 'data' | 'constraint' | 'annotation' | 'touchpoint' | 'actor';
+type ActorCategory = 'human' | 'ai' | 'system' | 'other';
+interface Persona {
+    id: string;
+    name: string;
+    role?: string;
+    color: string;
+    initials: string;
+    category: ActorCategory;
+}
+interface NodeAttachment {
+    id: string;
+    referenceId: string;
+    type: 'data' | 'constraint';
+    direction?: 'input' | 'output';
+    notes?: string;
+    examples?: string;
+}
+interface BuilderNode {
+    id: string;
+    type: NodeType;
+    referenceId: string;
+    x: number;
+    y: number;
+    width?: number;
+    height?: number;
+    measuredW?: number;
+    measuredH?: number;
+    color?: string;
+    subType?: 'note' | 'zone';
+    semanticType?: 'data' | 'constraint' | 'touchpoint' | 'task';
+    customLabel?: string;
+    notes?: string;
+    designerDescription?: string;
+    personaId?: string;
+    capability?: string;
+    attachments?: NodeAttachment[];
+    customDefinition?: {
+        name: string;
+        description?: string;
+        icon?: string;
+        task_type?: 'ai' | 'human' | 'system';
+        layer_id?: string;
+    };
+}
+interface BuilderEdge {
+    id: string;
+    source: string;
+    target: string;
+    label?: string;
+    attachments?: NodeAttachment[];
+    sourceHandle?: 'left' | 'right' | 'top' | 'bottom';
+    targetHandle?: 'left' | 'right' | 'top' | 'bottom';
+    customX?: number;
+    customY?: number;
+    sourceX?: number;
+    targetX?: number;
+}
+interface BuilderState {
+    nodes: BuilderNode[];
+    edges: BuilderEdge[];
+    personas: Persona[];
+}
+interface Project {
+    id: string;
+    name: string;
+    description: string;
+    lastModified: number;
+    data: BuilderState;
+    tags?: string[];
+}
+
+export type { ActorCategory, AiTask, AtlasData, BaseTask, BuilderEdge, BuilderNode, BuilderState, Capability, ConstraintCategory, ConstraintDefinition, DataArtifactDefinition, DataCategory, Example, HumanTask, IOItem, IOSpec, ImplementationNotes, Layer, LayerGuidance, Meta, Node, NodeAttachment, NodeType, Persona, Project, Relation, SystemTask, Task, TemplateAttachment, TouchpointCategory, TouchpointDefinition, UxNotes, WorkflowTaskStep, WorkflowTemplate, WorkflowTemplateEdge };

package/dist/types.d.ts

@@ -0,0 +1,294 @@
+/**
+ * Copyright 2025 quietloudlab
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+interface Meta {
+    title: string;
+    description: string;
+    version: string;
+    schema_version: string;
+}
+interface LayerGuidance {
+    when_to_use: string;
+    typical_position: string;
+    red_flags: string[];
+}
+interface Layer {
+    id: string;
+    name: string;
+    slug: string;
+    role: string;
+    description: string;
+    color: string;
+    guidance?: LayerGuidance;
+}
+type IOItem = string | {
+    id: string;
+    label: string;
+    isArray?: boolean;
+};
+interface IOSpec {
+    inputs: {
+        required: IOItem[];
+        optional: IOItem[];
+    };
+    constraints?: {
+        optional: IOItem[];
+    };
+    outputs: {
+        primary: IOItem;
+        metadata: IOItem[];
+    };
+}
+interface ImplementationNotes {
+    maturity: 'emerging' | 'established' | 'commoditized';
+    typical_latency: 'realtime' | 'interactive' | 'batch';
+    data_requirements: 'none' | 'small' | 'medium' | 'large' | 'continuous';
+    human_oversight: 'none' | 'optional' | 'recommended' | 'required';
+}
+interface UxNotes {
+    risk: string;
+    tip: string;
+    anti_patterns: string[];
+}
+interface Capability {
+    name: string;
+    tag: string;
+    example: string;
+}
+interface Relation {
+    target_id: string;
+    type: string;
+    strength: string;
+    reason: string;
+}
+interface BaseTask {
+    id: string;
+    layer_id: string;
+    name: string;
+    slug: string;
+    elevator_pitch: string;
+    example_usage: string;
+    io_spec: IOSpec;
+}
+interface AiTask extends BaseTask {
+    task_type: 'ai';
+    implementation_notes: ImplementationNotes;
+    ux_notes: UxNotes;
+    capabilities: Capability[];
+    relations: Relation[];
+}
+interface HumanTask extends BaseTask {
+    task_type: 'human';
+    common_variants: string[];
+    relations: Relation[];
+}
+interface SystemTask extends BaseTask {
+    task_type: 'system';
+    common_variants: string[];
+    relations: Relation[];
+}
+type Task = AiTask | HumanTask | SystemTask;
+type DataCategory = 'text' | 'visual' | 'audio' | 'structured' | 'compound' | 'user_input' | 'system' | 'generic';
+interface DataArtifactDefinition {
+    id: string;
+    name: string;
+    category: DataCategory;
+    icon: string;
+    description?: string;
+    examples?: string[];
+    compatible_with?: string[];
+    format_notes?: string;
+}
+type ConstraintCategory = 'quality_safety' | 'performance_resource' | 'model_technical' | 'ux_interaction' | 'data_context' | 'execution_behavior' | 'code_philosophy' | 'attribution';
+interface ConstraintDefinition {
+    id: string;
+    name: string;
+    category: ConstraintCategory;
+    icon: string;
+    description?: string;
+    type?: string;
+    applies_to?: string[];
+    ux_note?: string;
+    example_values?: string;
+}
+type TouchpointCategory = 'screen_interface' | 'conversational' | 'voice_audio' | 'spatial_computing' | 'technical' | 'physical_devices';
+interface TouchpointDefinition {
+    id: string;
+    name: string;
+    category: TouchpointCategory;
+    icon: string;
+    description: string;
+    examples: string[];
+}
+interface TemplateAttachment {
+    id: string;
+    referenceId: string;
+    type: 'data' | 'constraint';
+    direction?: 'input' | 'output';
+    notes?: string;
+}
+interface WorkflowTaskStep {
+    task_id: string;
+    position: number;
+    label: string;
+    optional?: boolean;
+    conditional?: string;
+    notes?: string;
+    id?: string;
+    node_type?: 'task' | 'data' | 'constraint' | 'annotation' | 'touchpoint' | 'actor';
+    row?: number;
+    col?: number;
+    width?: number;
+    height?: number;
+    attachments?: TemplateAttachment[];
+    personaId?: string;
+    subType?: 'note' | 'zone';
+    customLabel?: string;
+    capability?: string;
+    color?: string;
+    customDefinition?: {
+        name: string;
+        description?: string;
+        icon?: string;
+        task_type?: 'ai' | 'human' | 'system';
+        layer_id?: string;
+    };
+}
+interface WorkflowTemplateEdge {
+    source: string;
+    target: string;
+    label?: string;
+    attachments?: TemplateAttachment[];
+    customX?: number;
+    customY?: number;
+    sourceX?: number;
+    targetX?: number;
+    sourceHandle?: 'left' | 'right' | 'top' | 'bottom';
+    targetHandle?: 'left' | 'right' | 'top' | 'bottom';
+}
+interface WorkflowTemplate {
+    id: string;
+    name: string;
+    description: string;
+    primary_use_case: string;
+    nodes: BuilderNode[];
+    edges: BuilderEdge[];
+    common_variations: string[];
+    complexity?: string;
+    tags?: string[];
+    personas?: Persona[];
+}
+interface Node {
+    task_id: string;
+    x: number;
+    y: number;
+    label: string;
+}
+interface Example {
+    id: string;
+    primary_task_id: string;
+    title: string;
+    description: string;
+    industry: string;
+    complexity: 'Low' | 'Medium' | 'High';
+    tags: string[];
+    image_url: string;
+    nodes: Node[];
+}
+interface AtlasData {
+    meta: Meta;
+    layers: Layer[];
+    ai_tasks: AiTask[];
+    human_tasks: HumanTask[];
+    system_tasks: SystemTask[];
+    data_artifacts: DataArtifactDefinition[];
+    constraints: ConstraintDefinition[];
+    touchpoints: TouchpointDefinition[];
+    workflow_templates: WorkflowTemplate[];
+    examples: Example[];
+}
+type NodeType = 'task' | 'data' | 'constraint' | 'annotation' | 'touchpoint' | 'actor';
+type ActorCategory = 'human' | 'ai' | 'system' | 'other';
+interface Persona {
+    id: string;
+    name: string;
+    role?: string;
+    color: string;
+    initials: string;
+    category: ActorCategory;
+}
+interface NodeAttachment {
+    id: string;
+    referenceId: string;
+    type: 'data' | 'constraint';
+    direction?: 'input' | 'output';
+    notes?: string;
+    examples?: string;
+}
+interface BuilderNode {
+    id: string;
+    type: NodeType;
+    referenceId: string;
+    x: number;
+    y: number;
+    width?: number;
+    height?: number;
+    measuredW?: number;
+    measuredH?: number;
+    color?: string;
+    subType?: 'note' | 'zone';
+    semanticType?: 'data' | 'constraint' | 'touchpoint' | 'task';
+    customLabel?: string;
+    notes?: string;
+    designerDescription?: string;
+    personaId?: string;
+    capability?: string;
+    attachments?: NodeAttachment[];
+    customDefinition?: {
+        name: string;
+        description?: string;
+        icon?: string;
+        task_type?: 'ai' | 'human' | 'system';
+        layer_id?: string;
+    };
+}
+interface BuilderEdge {
+    id: string;
+    source: string;
+    target: string;
+    label?: string;
+    attachments?: NodeAttachment[];
+    sourceHandle?: 'left' | 'right' | 'top' | 'bottom';
+    targetHandle?: 'left' | 'right' | 'top' | 'bottom';
+    customX?: number;
+    customY?: number;
+    sourceX?: number;
+    targetX?: number;
+}
+interface BuilderState {
+    nodes: BuilderNode[];
+    edges: BuilderEdge[];
+    personas: Persona[];
+}
+interface Project {
+    id: string;
+    name: string;
+    description: string;
+    lastModified: number;
+    data: BuilderState;
+    tags?: string[];
+}
+
+export type { ActorCategory, AiTask, AtlasData, BaseTask, BuilderEdge, BuilderNode, BuilderState, Capability, ConstraintCategory, ConstraintDefinition, DataArtifactDefinition, DataCategory, Example, HumanTask, IOItem, IOSpec, ImplementationNotes, Layer, LayerGuidance, Meta, Node, NodeAttachment, NodeType, Persona, Project, Relation, SystemTask, Task, TemplateAttachment, TouchpointCategory, TouchpointDefinition, UxNotes, WorkflowTaskStep, WorkflowTemplate, WorkflowTemplateEdge };

package/dist/types.js

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=types.js.map
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"types.js"}

package/dist/types.mjs

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=types.mjs.map
+//# sourceMappingURL=types.mjs.map

package/dist/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"types.mjs"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@quietloudlab/ai-interaction-atlas",
+  "version": "1.0.0",
+  "description": "A shared language for designing AI experiences - 100+ interaction patterns across human actions, AI tasks, system operations, data, constraints, and touchpoints",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js",
+      "require": "./dist/types.cjs"
+    },
+    "./data": {
+      "types": "./dist/data.d.ts",
+      "import": "./dist/data.js",
+      "require": "./dist/data.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ai",
+    "interaction-design",
+    "taxonomy",
+    "patterns",
+    "llm",
+    "ai-ux",
+    "design-system",
+    "workflow",
+    "ai-design",
+    "human-ai-interaction",
+    "ai-product",
+    "ai-systems",
+    "atlas"
+  ],
+  "author": "Brandon Harwood <brandon@quietloudlab.com>",
+  "homepage": "https://ai-interaction.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/quietloudlab/ai-interaction-atlas.git",
+    "directory": "atlas-package"
+  },
+  "bugs": {
+    "url": "https://github.com/quietloudlab/ai-interaction-atlas/issues"
+  },
+  "license": "Apache-2.0",
+  "sideEffects": false,
+  "devDependencies": {
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}