@toonstrip/next 0.1.0 → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Daniel Kim
+
+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

@@ -1,5 +1,12 @@
 # @toonstrip/next
 
+**Deprecated.** `@toonstrip/react`'s `<ComicStrip>` now carries its own `'use client'`
+directive, and `@toonstrip/cli` exports `renderPlaceholder` directly — this package no
+longer adds anything on top of either. It's kept as a working re-export for existing
+installs; new code should import from `@toonstrip/react` and `@toonstrip/cli` instead.
+See [`docs/next.md`](https://github.com/dkdev24/toonstrip/blob/main/docs/next.md) for the
+two-line migration.
+
 `@toonstrip/react`'s `<ComicStrip>` behind an App-Router-safe `'use client'` boundary,
 plus `@toonstrip/next/server`'s `renderPlaceholder` for a real SSR PNG placeholder — no
 layout shift on hydration, and content visible with JavaScript disabled.

package/dist/index.d.ts

@@ -1,2 +1,8 @@
+/**
+ * @deprecated `@toonstrip/react`'s `<ComicStrip>` now carries its own
+ * `"use client"` directive — import it directly from `@toonstrip/react`
+ * instead of through this package, which no longer adds anything on top of
+ * it. Kept for existing installs; see `docs/next.md` for the migration.
+ */
 export { ComicStrip } from "@toonstrip/react";
 export type { ComicStripProps, ComicStripPlaceholder } from "@toonstrip/react";

package/dist/index.js

@@ -1,8 +1,7 @@
-"use client";
-// The client-side, App-Router-safe boundary (dev plan §13.4): `@toonstrip/react`'s
-// `<ComicStrip>` uses `useRef`/`useEffect`, so it must be marked a Client
-// Component wherever a Server Component imports it. `packages/element`'s own
-// SSR guards (customElements/HTMLElement) are what keep the *module* safe to
-// import during the server render pass that still happens for a "use client"
-// tree; this directive is the separate, RSC-protocol half of that story.
+/**
+ * @deprecated `@toonstrip/react`'s `<ComicStrip>` now carries its own
+ * `"use client"` directive — import it directly from `@toonstrip/react`
+ * instead of through this package, which no longer adds anything on top of
+ * it. Kept for existing installs; see `docs/next.md` for the migration.
+ */
 export { ComicStrip } from "@toonstrip/react";

package/dist/server.d.ts

@@ -1,29 +1,6 @@
 /**
- * Server-only SSR placeholder helper (dev plan §13.4). Reuses §8's existing
- * headless-canvas render path (`packages/cli`, already published) to produce
- * a real PNG of the strip at request/build time, ready to hand to
- * `<ComicStrip placeholder>` as the light-DOM image it shows until client JS
- * hydrates and paints the live canvas.
- *
- * A separate entry point ("@toonstrip/next/server", not the package root):
- * `@toonstrip/cli` pulls in `@napi-rs/canvas`, a native Node addon that must
- * never end up in a client bundle. Only import this from a Server Component
- * or other server-only code.
- *
- * `@toonstrip/cli` is imported dynamically with `webpackIgnore` rather than
- * statically: Next's `serverExternalPackages` opt-out is meant to stop it
- * being bundled, but a workspace package reached through a symlinked,
- * non-`node_modules` local package (`@toonstrip/cli`, here) doesn't reliably
- * hit that path, and webpack then tries to statically bundle
- * `@napi-rs/canvas`'s platform-detection `require()`s for every OS/arch and
- * fails on the binary `.node` files. `webpackIgnore` leaves this import
- * completely alone, so Node resolves and loads it normally at request time —
- * from the *bundled output file's* location, though, so the consuming app
- * must list `@toonstrip/cli` as its own direct dependency (not only reachable
- * transitively through `@toonstrip/next`) for that resolution to succeed
- * under pnpm's default strict `node_modules` layout.
+ * @deprecated `@toonstrip/cli` now exports `renderPlaceholder` directly, with
+ * the same signature — this re-export is kept for existing installs. Import
+ * from `@toonstrip/cli` instead; see `docs/next.md` for the migration.
  */
-import type { ComicStripPlaceholder } from "@toonstrip/react";
-import type { ComicStripDocument } from "@toonstrip/schema";
-import type { RenderOptions } from "@toonstrip/cli";
-export declare function renderPlaceholder(doc: ComicStripDocument, options?: RenderOptions): Promise<ComicStripPlaceholder>;
+export { renderPlaceholder } from "@toonstrip/cli";

package/dist/server.js

@@ -1,10 +1,6 @@
-export async function renderPlaceholder(doc, options = {}) {
-    const { renderDocument } = await import(/* webpackIgnore: true */ "@toonstrip/cli");
-    const { png, cssWidth, cssHeight } = await renderDocument(doc, options);
-    // The <img>'s width/height are CSS pixels (RenderResult.cssWidth/cssHeight),
-    // not the (possibly `scale`d-up) PNG's own pixel size — an `<img>` displays
-    // at its width/height attributes regardless of the file's actual pixel
-    // density, so using the PNG's raw pixel size here would render it 2x too
-    // large (the default `scale`) and shift layout on hydration.
-    return { src: `data:image/png;base64,${png.toString("base64")}`, width: cssWidth, height: cssHeight };
-}
+/**
+ * @deprecated `@toonstrip/cli` now exports `renderPlaceholder` directly, with
+ * the same signature — this re-export is kept for existing installs. Import
+ * from `@toonstrip/cli` instead; see `docs/next.md` for the migration.
+ */
+export { renderPlaceholder } from "@toonstrip/cli";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@toonstrip/next",
-  "version": "0.1.0",
-  "description": "@toonstrip/react behind an App-Router-safe 'use client' boundary, plus a server-only SSR placeholder helper.",
+  "version": "0.1.1",
+  "description": "[DEPRECATED] @toonstrip/react's <ComicStrip> now carries its own 'use client' directive and @toonstrip/cli exports renderPlaceholder directly — import from those instead. See docs/next.md for the migration.",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
@@ -19,19 +19,13 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "test": "vitest run",
-    "lint": "tsc -p tsconfig.json --noEmit"
-  },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "dependencies": {
-    "@toonstrip/cli": "workspace:*",
-    "@toonstrip/react": "workspace:*",
-    "@toonstrip/schema": "workspace:*"
+    "@toonstrip/cli": "0.2.3",
+    "@toonstrip/react": "0.1.2"
   },
   "devDependencies": {
     "@types/react": "^18.3.12",
@@ -39,7 +33,8 @@
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "typescript": "^5.6.3",
-    "vitest": "^2.1.4"
+    "vitest": "^2.1.4",
+    "@toonstrip/schema": "0.1.3"
   },
   "publishConfig": {
     "access": "public"
@@ -57,5 +52,10 @@
     "directory": "packages/next"
   },
   "homepage": "https://github.com/dkdev24/toonstrip#readme",
-  "bugs": "https://github.com/dkdev24/toonstrip/issues"
-}
+  "bugs": "https://github.com/dkdev24/toonstrip/issues",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "lint": "tsc -p tsconfig.json --noEmit"
+  }
+}