paintcannon-react 0.0.46 → 0.0.48

package/README.md

@@ -147,8 +147,15 @@ All host components accept these event props:
 - `onTransitionEnd`
 - `onScroll`
 
-`onPaste` receives the same `PaintClipboardEvent` as core, including detected terminal image paths
-through `event.clipboardData.files`.
+`onPaste` receives the same `PaintClipboardEvent` as core, including image files through
+`event.clipboardData.files`. This also handles images copied from browsers or screenshot tools
+without a backing file on terminals supporting Kitty's rich-paste protocol. Image pastes have
+empty text data; no React-specific handling is needed.
+Use `await paintCannon.supportsRichPaste()` on the core instance to detect copied-image paste
+support before offering it in your UI.
+Inside tmux, core uses DCS passthrough only after confirming `focus-events` is on, so rich-paste
+mode can be released when switching away from the app's pane. Otherwise `supportsRichPaste()`
+returns `false`, leaving ordinary text and file-path paste available.
 
 `style` accepts the following CSS property names. Kebab-case and camelCase are
 both supported:
@@ -233,6 +240,31 @@ both supported:
 - `font-weight`/`fontWeight` (accepts `"bold"` or `"normal"`)
 - `text-decoration`/`textDecoration` (accepts `"underline"`, `"line-through"`, or `"none"`)
 
+Grid template and automatic track props accept the same strings as core: cell lengths,
+percentages, `fr`, `auto`, `min-content`, `max-content`, and `minmax(min, max)`.
+The minimum accepts any of those except `fr`; the maximum accepts all of them.
+Whitespace is allowed inside `minmax()`. For example:
+
+```tsx
+<Div
+  style={{
+    display: "grid",
+    width: "100%",
+    gridTemplateColumns: "minmax(0, max-content) minmax(0, max-content)",
+    justifyContent: "flex-start",
+  }}
+>
+  <Div style={{ minWidth: 0, overflowWrap: "anywhere" }}>#</Div>
+  <Div style={{ minWidth: 0, overflowWrap: "anywhere" }}>
+    A longer cell that can wrap in a narrow terminal.
+  </Div>
+</Div>
+```
+
+`minmax(0, 1fr)` uses a zero minimum, unlike bare `1fr`'s automatic minimum.
+Sizes must be non-negative; `repeat()` is not supported.
+See the [full grid track grammar](../paintcannon/README.md#grid-track-sizing).
+
 ### Per-component props:
 
 - `Div`: shared props, plus `scrollLeft?: number` and `scrollTop?: number`.
@@ -256,6 +288,38 @@ both supported:
 - `useAnimation()` for requestAnimationFrame-driven animations that share a
   single render cycle.
 
+## Desktop Notifications
+
+Use the core API through `useApp().paintCannon`; no notification-specific React
+wrapper is needed:
+
+```tsx
+function NotifyButton() {
+  const { paintCannon } = useApp();
+  return (
+    <Button
+      onClick={() => {
+        new paintCannon.Notification("Build complete", { body: "All tests passed." });
+      }}
+    >
+      Notify
+    </Button>
+  );
+}
+```
+
+`requestPermission()` automatically grants when a backend is available, or returns
+`"denied"` otherwise, without a prompt. Rust selects OSC 99/777/9 or a local macOS/Linux command fallback;
+it never invokes a remote desktop fallback over SSH. Notification lifecycle
+feedback varies by backend. See [the core notification API](../paintcannon/README.md#desktop-notifications)
+for options, events, replacement, and dismissal limitations.
+
+Use `await paintCannon.Notification.supportsClose()` to decide whether to render a
+dismiss button. Permission to deliver notifications does not imply dismissal
+support. OSC 99 features, including dismissal, are queried from the terminal at
+runtime. OSC 9/777 and the macOS command fallback cannot dismiss notifications
+programmatically; Otty's current acknowledgement also does not advertise dismissal.
+
 ## Core Runtime
 
 This package depends on `paintcannon`, which provides the NAPI-RS native

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paintcannon-react",
-  "version": "0.0.46",
+  "version": "0.0.48",
   "license": "ISC",
   "repository": {
     "type": "git",
@@ -37,7 +37,7 @@
     "scheduler": "^0.25.0"
   },
   "peerDependencies": {
-    "paintcannon": "^0.0.46",
+    "paintcannon": "^0.0.48",
     "react": "^19.0.0"
   },
   "devDependencies": {
@@ -46,6 +46,6 @@
     "@types/react-reconciler": "^0.33.0",
     "@types/scheduler": "^0.26.0",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.7"
+    "vitest": "^4.1.12"
   }
 }