@iyulab/chat-components 0.6.0 → 0.7.0

package/skills/iyulab-chat-components/references/utilities/intent-prompt-builder.md

@@ -1,123 +0,0 @@
-# IntentPromptBuilder
-
-```ts
-import { IntentPromptBuilder, PresetIntent } from '@iyulab/chat-components';
-```
-
-Singleton utility that registers intents, generates LLM system prompt instructions, and parses `intent-json` blocks from LLM responses.
-
----
-
-## Overview
-
-```ts
-import { IntentPromptBuilder, PresetIntent } from '@iyulab/chat-components';
-
-const builder = IntentPromptBuilder.instance;
-
-// 1. Register preset intents
-builder.use(PresetIntent.Questions);
-
-// 2. Register custom intents
-builder.add({
-  type: 'rating',
-  description: 'Prompt the user to rate something on a scale',
-  properties: {
-    label: { type: 'string', description: 'What to rate' },
-    max:   { type: 'number', description: 'Maximum score (default: 5)' }
-  },
-  required: ['label']
-});
-
-// 3. Inject into LLM system prompt
-const instruction = builder.build();
-
-// 4. Parse LLM response
-const [cleanText, intents] = builder.parse(llmResponse);
-// cleanText → markdown with intent-json blocks removed
-// intents   → parsed IntentSchema[]
-
-// 5. Render components
-for (const intent of intents) {
-  if (intent.type === 'question') {
-    const el = document.createElement('u-question-intent');
-    el.question = intent.properties?.question as string;
-    el.choices  = intent.properties?.choices as string[] ?? [];
-    container.appendChild(el);
-  }
-}
-
-markedBlock.value = cleanText;
-```
-
----
-
-## API
-
-### `IntentPromptBuilder.instance`
-
-Returns the singleton. Created on first access.
-
-### `.use(flags: PresetIntent): this`
-
-Registers preset intents by bit flag.
-
-```ts
-builder.use(PresetIntent.Questions);
-builder.use(PresetIntent.All);
-```
-
-### `.add(definition: IntentDefinition): this`
-
-Registers a custom intent. Throws if the same `type` is already registered.
-
-```ts
-interface IntentDefinition {
-  type: string;
-  description: string;
-  properties?: Record<string, JsonSchema>;
-  required?: string[];
-}
-```
-
-### `.build(): string`
-
-Returns LLM system prompt instructions for all registered intents. Returns an empty string if no intents are registered.
-
-### `.parse(value: string): [string, IntentSchema[]]`
-
-Extracts `intent-json` blocks from an LLM response string.
-
-- Index `[0]` — clean markdown text with intent-json blocks removed
-- Index `[1]` — array of parsed `IntentSchema` objects
-
-```ts
-interface IntentSchema {
-  type: string;
-  properties?: Record<string, unknown>;
-}
-```
-
----
-
-## PresetIntent Flags
-
-```ts
-enum PresetIntent {
-  Questions = 1 << 0,
-  All       = Questions
-}
-```
-
-### Questions Intent Schema
-
-```json
-{
-  "type": "question",
-  "properties": {
-    "question": { "type": "string" },
-    "choices":  { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 5 }
-  },
-  "required": ["choices"]
-}
-```

package/skills/iyulab-chat-components/references/utilities/view-prompt-builder.md

@@ -1,112 +0,0 @@
-# ViewPromptBuilder
-
-```ts
-import { ViewPromptBuilder, PresetView } from '@iyulab/chat-components';
-```
-
-Singleton utility that registers views and generates LLM system prompt instructions. No manual parsing is needed — `u-marked-block` automatically renders `view-json` code blocks via `u-view`.
-
----
-
-## Overview
-
-```ts
-import { ViewPromptBuilder, PresetView } from '@iyulab/chat-components';
-
-const builder = ViewPromptBuilder.instance;
-
-// 1. Register preset views
-builder.use(PresetView.All);
-// Or selectively
-builder.use(PresetView.Images | PresetView.Chart);
-
-// 2. Register a custom view
-builder.add({
-  element: MyCustomView,    // CustomElementConstructor
-  tag: 'my-custom-view',
-  description: 'Display a custom visualization',
-  properties: {
-    data: { type: 'array', description: 'Data array' }
-  },
-  required: ['data']
-});
-
-// 3. Inject into LLM system prompt
-const instruction = builder.build();
-```
-
-When the LLM outputs a `view-json` block, `u-marked-block` renders it automatically:
-
-````
-```view-json
-{
-  "tag": "u-chart-view",
-  "properties": {
-    "type": "pie",
-    "data": {
-      "labels": ["A", "B", "C"],
-      "datasets": [{ "data": [30, 50, 20] }]
-    }
-  }
-}
-```
-````
-
----
-
-## API
-
-### `ViewPromptBuilder.instance`
-
-Returns the singleton. Created on first access.
-
-### `.use(flags: PresetView): this`
-
-Registers preset views by bit flag.
-
-```ts
-builder.use(PresetView.Images);
-builder.use(PresetView.All);
-builder.use(PresetView.Images | PresetView.Chart);
-```
-
-### `.add(definition: ViewDefinition): this`
-
-Registers a custom view and its custom element. Throws if the same `tag` is already registered or if the tag is already defined with a different class.
-
-```ts
-interface ViewDefinition {
-  element: CustomElementConstructor;
-  tag: string;
-  description: string;
-  properties?: Record<string, JsonSchema>;
-  required?: string[];
-}
-```
-
-### `.build(): string`
-
-Returns LLM system prompt instructions for all registered views. Returns an empty string if no views are registered.
-
----
-
-## PresetView Flags
-
-```ts
-enum PresetView {
-  Images = 1 << 0,   // u-images-view
-  Video  = 1 << 1,   // u-video-view
-  Map    = 1 << 3,   // u-map-view
-  Chart  = 1 << 4,   // u-chart-view
-  All    = Images | Video | Map | Chart
-}
-```
-
-### Preset View Schema Summary
-
-| Tag | Key Properties |
-|-----|----------------|
-| `u-images-view` | `items: [{ src, alt?, caption? }]` |
-| `u-video-view`  | `src`, `poster?`, `ratio?` |
-| `u-map-view`    | `lat`, `lng`, `zoom?`, `label?`, `description?` |
-| `u-chart-view`  | `type`, `data`, `options?` |