@webskill/chatbot 0.0.1 → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chunhui Mo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -129,12 +129,32 @@ implementation (OPFS storage, skills, demo/model providers, console embedding).
 
 ## Stability
 
-- **`@stable`** — `Chatbot`, `ChatbotProps`, `ChatEngine` (public methods),
-  `CompositeUiBridge`, the i18n dictionary. Covered by semver from 0.1.0.
-- **`@experimental`** — A2UI/OpenUI/Vercel surface hosts and snapshot hosts,
-  `VercelPayloadPreview`, `configureA2uiMarkdown`, the `probe*` availability
-  helpers, `RendererKind` (renamed in 0.3.0), and the `RunSnapshot` format.
-  These may change between 0.0.x releases.
+Every public export carries a `@stable` or `@experimental` JSDoc tag. The tag is
+part of the checked-in API snapshot (`api-snapshots/chatbot/index.d.ts.snap`),
+so a symbol cannot be quietly downgraded — the change shows up in the diff.
+
+- **`@stable`** — covered by the semver contract from 0.1.0: bug fixes ship in a
+  patch, backwards-compatible capabilities in a minor, breaking changes only in
+  a major with release notes. This covers the surface you wire a host against:
+  `Chatbot`, `ChatEngine`, `ChatbotHostAdapter`, the message/event/session data
+  types, `CompositeUiBridge`, the layout, theme and i18n exports, and the shell
+  components (`InteractionCard`, `ResultBlocksPro`, `SettingsDrawer`, …).
+- **`@experimental`** — may change in a minor or patch release. Only three kinds
+  of symbol qualify, and each one is here for a stated reason:
+  - **Non-native renderer tiers** — the A2UI, OpenUI and Vercel surface hosts,
+    their snapshot variants, `VercelPayloadPreview`, `SpecInteraction`,
+    `configureA2uiMarkdown`, the `probe*` helpers, `RendererKind`,
+    `RendererCapability` and `DEFAULT_RENDERER_CAPABILITIES`. Their shape
+    tracks upstream ecosystems this package does not own.
+  - **Surfaces introduced in this release** — `ChatAttachmentInput` and
+    `ChatAttachmentMeta` (multimodal attachments), which no consumer has
+    exercised yet.
+  - **`RunSnapshot`** — the resume snapshot format, `@experimental` in
+    `@webskill/sdk` for the same reason.
+
+Anything a README example or the published-`.d.ts` consumer probe imports is
+`@stable` by rule: once we teach a call site, we stop calling it experimental.
+`pnpm lint` enforces that rule against this file.
 
 ## License
 

package/dist/chatbot.css

@@ -722,6 +722,9 @@
       border-color: color-mix(in oklab, var(--destructive) 25%, transparent);
     }
   }
+  .self-center {
+    align-self: center;
+  }
   .truncate {
     overflow: hidden;
     text-overflow: ellipsis;
@@ -1051,6 +1054,9 @@
   .pr-8 {
     padding-right: calc(var(--spacing) * 8);
   }
+  .pb-1 {
+    padding-bottom: var(--spacing);
+  }
   .pb-3 {
     padding-bottom: calc(var(--spacing) * 3);
   }
@@ -1210,9 +1216,6 @@
   .underline-offset-4 {
     text-underline-offset: 4px;
   }
-  .accent-primary {
-    accent-color: var(--primary);
-  }
   .opacity-0 {
     opacity: 0%;
   }
@@ -1497,6 +1500,9 @@
       opacity: 85%;
     }
   }
+  .focus\:border-ring:focus {
+    border-color: var(--ring);
+  }
   .focus-visible\:border-ring:focus-visible {
     border-color: var(--ring);
   }