@webskill/chatbot 0.0.2 → 0.1.0

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.4.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);
   }