@interopio/io-assist-ng 0.1.1-beta.0

package/README.md

@@ -0,0 +1,218 @@
+# @interopio/io-assist-ng
+
+Angular library for integrating io.Intelligence AI assistance capabilities into Angular applications (Angular 20.3+).
+
+## Installation
+
+```bash
+npm install @interopio/io-assist-ng
+```
+
+## Prerequisites
+
+- Angular 20.3 or higher
+- Node.js 20.19+ (< 22)
+- npm 10.0.0 or higher
+
+## Setup
+
+### 1. Import Styles
+
+Add the library styles to your Angular application:
+
+**Option A: In `angular.json`**
+```json
+{
+  "projects": {
+    "your-app": {
+      "architect": {
+        "build": {
+          "options": {
+            "styles": [
+              "node_modules/@interopio/io-assist-ng/styles.css",
+              "src/styles.css"
+            ]
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+**Option B: In `styles.css`/`styles.scss`**
+```css
+@import '@interopio/io-assist-ng/styles.css';
+```
+
+### 2. Import Components
+
+Import the components you need in your Angular component:
+
+```typescript
+import { Component } from '@angular/core';
+import { IoAssist } from '@interopio/io-assist-ng';
+
+@Component({
+  selector: 'app-root',
+  standalone: true,
+  imports: [IoAssist],
+  template: `
+    <io-assist [config]="assistConfig"></io-assist>
+  `
+})
+export class AppComponent {
+  assistConfig = {
+    // Your configuration here
+  };
+}
+```
+
+## Configuration
+
+The `IoAssist` component accepts a configuration object via the `[config]` input:
+
+```typescript
+import { IoAssistTempConfig } from '@interopio/io-assist-ng';
+
+const assistConfig: IoAssistTempConfig = {
+  // Configuration options
+  apiEndpoint: 'https://your-api-endpoint.com',
+  theme: 'light', // or 'dark'
+  // Add other configuration options as needed
+};
+```
+
+## Components
+
+### IoAssist
+
+Main component for AI assistance functionality.
+
+**Usage:**
+```html
+<io-assist 
+  [config]="assistConfig"
+></io-assist>
+```
+
+**Inputs:**
+- `config: IoAssistTempConfig` - Configuration object for the assistant
+
+## Styling
+
+The library uses TailwindCSS for styling. The styles are pre-compiled and included in the distribution.
+
+### Custom Theming
+
+To customize the appearance, override CSS variables in your application:
+
+```css
+:root {
+  --io-assist-primary-color: #your-color;
+  --io-assist-background: #your-background;
+  /* Add other custom variables */
+}
+```
+
+## Examples
+
+### Basic Integration
+
+```typescript
+import { Component } from '@angular/core';
+import { IoAssist, IoAssistTempConfig } from '@interopio/io-assist-ng';
+
+@Component({
+  selector: 'app-dashboard',
+  standalone: true,
+  imports: [IoAssist],
+  template: `
+    <div class="dashboard">
+      <h1>My Dashboard</h1>
+      <io-assist [config]="config"></io-assist>
+    </div>
+  `
+})
+export class DashboardComponent {
+  config: IoAssistTempConfig = {
+    apiEndpoint: 'https://api.example.com/assist',
+    theme: 'light'
+  };
+}
+```
+
+## Browser Support
+
+- Chrome/Edge (latest 2 versions)
+- Firefox (latest 2 versions)
+- Safari (latest 2 versions)
+
+## Dependencies
+
+This library has peer dependencies on:
+- `@angular/core`: ^20.3.0
+- `@angular/common`: ^20.3.0
+- `@interopio/intel-web`: Latest
+
+These will be automatically installed with npm 7+.
+
+## TypeScript Support
+
+Full TypeScript support with type definitions included.
+
+```typescript
+import type { IoAssistTempConfig, IoAssistResponse } from '@interopio/io-assist-ng';
+```
+
+## Troubleshooting
+
+### Styles Not Loading
+
+Ensure you've imported the styles in `angular.json` or your main stylesheet:
+```json
+"styles": [
+  "node_modules/@interopio/io-assist-ng/styles.css"
+]
+```
+
+### Component Not Found
+
+Make sure you've imported the component in your standalone component or module:
+```typescript
+imports: [IoAssist]
+```
+
+### Type Errors
+
+Ensure your TypeScript version is 5.0 or higher and `strict` mode is enabled in `tsconfig.json`.
+
+## Development
+
+This library is built with:
+- Angular 20.3
+- TailwindCSS 4.1
+- TypeScript 5.x
+
+## Support
+
+For issues, questions, or contributions, please visit:
+- GitHub: [io.Intelligence JS Repository]
+- Documentation: [Coming Soon]
+- Issues: [GitHub Issues]
+
+## License
+
+ISC License
+
+## Changelog
+
+### 0.0.0 (Initial Release)
+- Initial release with core `IoAssist` component
+- TailwindCSS styling support
+- TypeScript type definitions
+- Angular 20.3 compatibility
+
+---
+
+**Note:** This library is currently in development. API and features may change before the stable 1.0.0 release.

package/dist/README.md

@@ -0,0 +1,218 @@
+# @interopio/io-assist-ng
+
+Angular library for integrating io.Intelligence AI assistance capabilities into Angular applications (Angular 20.3+).
+
+## Installation
+
+```bash
+npm install @interopio/io-assist-ng
+```
+
+## Prerequisites
+
+- Angular 20.3 or higher
+- Node.js 20.19+ (< 22)
+- npm 10.0.0 or higher
+
+## Setup
+
+### 1. Import Styles
+
+Add the library styles to your Angular application:
+
+**Option A: In `angular.json`**
+```json
+{
+  "projects": {
+    "your-app": {
+      "architect": {
+        "build": {
+          "options": {
+            "styles": [
+              "node_modules/@interopio/io-assist-ng/styles.css",
+              "src/styles.css"
+            ]
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+**Option B: In `styles.css`/`styles.scss`**
+```css
+@import '@interopio/io-assist-ng/styles.css';
+```
+
+### 2. Import Components
+
+Import the components you need in your Angular component:
+
+```typescript
+import { Component } from '@angular/core';
+import { IoAssist } from '@interopio/io-assist-ng';
+
+@Component({
+  selector: 'app-root',
+  standalone: true,
+  imports: [IoAssist],
+  template: `
+    <io-assist [config]="assistConfig"></io-assist>
+  `
+})
+export class AppComponent {
+  assistConfig = {
+    // Your configuration here
+  };
+}
+```
+
+## Configuration
+
+The `IoAssist` component accepts a configuration object via the `[config]` input:
+
+```typescript
+import { IoAssistTempConfig } from '@interopio/io-assist-ng';
+
+const assistConfig: IoAssistTempConfig = {
+  // Configuration options
+  apiEndpoint: 'https://your-api-endpoint.com',
+  theme: 'light', // or 'dark'
+  // Add other configuration options as needed
+};
+```
+
+## Components
+
+### IoAssist
+
+Main component for AI assistance functionality.
+
+**Usage:**
+```html
+<io-assist 
+  [config]="assistConfig"
+></io-assist>
+```
+
+**Inputs:**
+- `config: IoAssistTempConfig` - Configuration object for the assistant
+
+## Styling
+
+The library uses TailwindCSS for styling. The styles are pre-compiled and included in the distribution.
+
+### Custom Theming
+
+To customize the appearance, override CSS variables in your application:
+
+```css
+:root {
+  --io-assist-primary-color: #your-color;
+  --io-assist-background: #your-background;
+  /* Add other custom variables */
+}
+```
+
+## Examples
+
+### Basic Integration
+
+```typescript
+import { Component } from '@angular/core';
+import { IoAssist, IoAssistTempConfig } from '@interopio/io-assist-ng';
+
+@Component({
+  selector: 'app-dashboard',
+  standalone: true,
+  imports: [IoAssist],
+  template: `
+    <div class="dashboard">
+      <h1>My Dashboard</h1>
+      <io-assist [config]="config"></io-assist>
+    </div>
+  `
+})
+export class DashboardComponent {
+  config: IoAssistTempConfig = {
+    apiEndpoint: 'https://api.example.com/assist',
+    theme: 'light'
+  };
+}
+```
+
+## Browser Support
+
+- Chrome/Edge (latest 2 versions)
+- Firefox (latest 2 versions)
+- Safari (latest 2 versions)
+
+## Dependencies
+
+This library has peer dependencies on:
+- `@angular/core`: ^20.3.0
+- `@angular/common`: ^20.3.0
+- `@interopio/intel-web`: Latest
+
+These will be automatically installed with npm 7+.
+
+## TypeScript Support
+
+Full TypeScript support with type definitions included.
+
+```typescript
+import type { IoAssistTempConfig, IoAssistResponse } from '@interopio/io-assist-ng';
+```
+
+## Troubleshooting
+
+### Styles Not Loading
+
+Ensure you've imported the styles in `angular.json` or your main stylesheet:
+```json
+"styles": [
+  "node_modules/@interopio/io-assist-ng/styles.css"
+]
+```
+
+### Component Not Found
+
+Make sure you've imported the component in your standalone component or module:
+```typescript
+imports: [IoAssist]
+```
+
+### Type Errors
+
+Ensure your TypeScript version is 5.0 or higher and `strict` mode is enabled in `tsconfig.json`.
+
+## Development
+
+This library is built with:
+- Angular 20.3
+- TailwindCSS 4.1
+- TypeScript 5.x
+
+## Support
+
+For issues, questions, or contributions, please visit:
+- GitHub: [io.Intelligence JS Repository]
+- Documentation: [Coming Soon]
+- Issues: [GitHub Issues]
+
+## License
+
+ISC License
+
+## Changelog
+
+### 0.0.0 (Initial Release)
+- Initial release with core `IoAssist` component
+- TailwindCSS styling support
+- TypeScript type definitions
+- Angular 20.3 compatibility
+
+---
+
+**Note:** This library is currently in development. API and features may change before the stable 1.0.0 release.