@q9labsai/chalk-react 4.1.15 → 4.1.17

package/README.md

@@ -23,7 +23,13 @@ export function SpacePage() {
   return (
     <Chalk
       space="design-review"
-      getAccess={({ space, reason }) => fetch(`/api/chalk/spaces/${space}/access?reason=${reason}`)}
+      getAccess={(request) =>
+        fetch("/api/chalk/access", {
+          method: "POST",
+          headers: { "content-type": "application/json" },
+          body: JSON.stringify(request),
+        })
+      }
       defaults={{ microphone: true, camera: true }}
       features={{ chat: true, screenShare: true, reactions: true }}
       spaceName="Design review"
@@ -33,6 +39,11 @@ export function SpacePage() {
 }
 ```
 
+Forward the `getAccess` request unchanged to your authenticated backend. Pass it
+as the final `participants.issueAccess` argument with the server-only state from
+`getAccessRefreshState`; Chalk selects replacement only when recovery needs it.
+See the [web quickstart](../../../docs/sdk-web-quickstart.md) for the endpoint call.
+
 Pass an existing client when its lifecycle belongs to the embedding
 application. Chalk will use it without disposing it.
 
@@ -40,6 +51,17 @@ application. Chalk will use it without disposing it.
 <Chalk client={spaceClient} entrance={false} />
 ```
 
+### Feedback
+
+The live surface includes a Feedback action. Opening it captures the Chalk
+surface, bounded Journey and trace context, recent safe diagnostics, and only
+the documented Chalk local-state and cookie fields. The Participant can review,
+refresh, or remove the screenshot before sending a bug, feature request, or
+other feedback directly to Chalk. Screenshot failure never blocks the message.
+
+Embedded products should keep the default `feedbackSource="embedded"`. Chalk's
+first-party web surface sets `feedbackSource="chalk_web"`.
+
 `theme` is the only styling door. `skin` defaults to `"classic"`; choose
 `"chalk"` when you want the hand-drawn Chalk skin. Palette and texture are
 independent from the skin, so the same palette and texture can compose with
@@ -132,9 +154,20 @@ export function SpacePanel({ client }: { readonly client: SpaceClient }) {
 ```
 
 The public hook set is closed: `useSpaceClient`, `useConnection`, `useSelf`,
-`useParticipants`, `useMedia`, `useChat`, `useReactions`, `useWhiteboard`, and
+`useParticipants`, `useMedia`, `useChat`, `useOffline`, `useReactions`, `useWhiteboard`, and
 `useCan`. Each snapshot hook returns its stable `SpaceSnapshot` slice; use the
 client hook for commands.
 
 `AccessGrant` remains opaque. The application backend creates it, `getAccess`
 returns it unchanged, and `SpaceClient` handles refresh and recovery.
+
+## Component maintenance
+
+`transcript-panel-behavior.ts`, `settings-dialog-behavior.ts`, and
+`control-bar-behavior.ts` own the shared contracts, state, and commands for their
+components. Their `Classic*.tsx` and Chalk-skin `*.tsx` counterparts own
+skin-specific rendering; keep behavior out of those paired renderers.
+
+The SDK-owned `@q9labsai/chalk-react/preview` dev-tool entrypoint exposes the
+preview contract used by the first-party gallery. Application previews should
+consume that entrypoint instead of reaching into this package's `src` tree.

package/THIRD_PARTY_NOTICES.md

@@ -25,3 +25,32 @@ 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.
+
+## Hugeicons Animated
+
+The animated icon components under `src/utils/animated-icons` are adapted from
+enesgules/hugeicons-animated at commit
+`169b11f23bc63f727b9c644aca92e8b2fab0c5e1`. The source project and its icon
+shapes are MIT licensed.
+
+MIT License
+
+Copyright (c) 2026 enesgules
+
+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/dist/bindings/hooks.d.ts

@@ -1,11 +1,14 @@
-import type { Capability, ChatSlice, ConnectionSlice, MediaSlice, ParticipantsSlice, ReactionsSlice, SelfSlice, SpaceClient, WhiteboardSlice } from "@q9labsai/chalk-client";
+import type { Capability, ChatSlice, ConnectionSlice, MediaSlice, OfflineSlice, ParticipantsSlice, ReactionsSlice, RecordingSlice, SelfSlice, SpaceClient, WhiteboardSlice } from "@q9labsai/chalk-client";
 export declare function useSpaceClient(): SpaceClient;
 export declare function useConnection(): ConnectionSlice;
 export declare function useSelf(): SelfSlice;
 export declare function useParticipants(): ParticipantsSlice;
 export declare function useMedia(): MediaSlice;
 export declare function useChat(): ChatSlice;
+/** Actions held while the connection recovers, and whether the user still has to decide about them. */
+export declare function useOffline(): OfflineSlice;
 export declare function useReactions(): ReactionsSlice;
+export declare function useRecording(): RecordingSlice;
 export declare function useWhiteboard(): WhiteboardSlice;
 export declare function useCan(capability: Capability): boolean;
 //# sourceMappingURL=hooks.d.ts.map

package/dist/bindings/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/bindings/hooks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAiB,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAqB5L,wBAAgB,cAAc,IAAI,WAAW,CAQ5C;AAED,wBAAgB,aAAa,IAAI,eAAe,CAE/C;AAED,wBAAgB,OAAO,IAAI,SAAS,CAEnC;AAED,wBAAgB,eAAe,IAAI,iBAAiB,CAEnD;AAED,wBAAgB,QAAQ,IAAI,UAAU,CAErC;AAED,wBAAgB,OAAO,IAAI,SAAS,CAEnC;AAED,wBAAgB,YAAY,IAAI,cAAc,CAE7C;AAED,wBAAgB,aAAa,IAAI,eAAe,CAE/C;AAED,wBAAgB,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAEtD"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/bindings/hooks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAiB,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAuB1N,wBAAgB,cAAc,IAAI,WAAW,CAQ5C;AAED,wBAAgB,aAAa,IAAI,eAAe,CAE/C;AAED,wBAAgB,OAAO,IAAI,SAAS,CAEnC;AAED,wBAAgB,eAAe,IAAI,iBAAiB,CAEnD;AAED,wBAAgB,QAAQ,IAAI,UAAU,CAErC;AAED,wBAAgB,OAAO,IAAI,SAAS,CAEnC;AAED,uGAAuG;AACvG,wBAAgB,UAAU,IAAI,YAAY,CAEzC;AAED,wBAAgB,YAAY,IAAI,cAAc,CAE7C;AAED,wBAAgB,YAAY,IAAI,cAAc,CAE7C;AAED,wBAAgB,aAAa,IAAI,eAAe,CAE/C;AAED,wBAAgB,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAEtD"}