@textcortex/slidewise 1.0.0

package/LICENSE

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

@@ -0,0 +1,112 @@
+# Slidewise
+
+Embeddable React PPTX editor. PPTX import + canvas editor + PPTX export, in
+one component.
+
+```bash
+pnpm add @textcortex/slidewise
+```
+
+Peer dependencies: `react >=19`, `react-dom >=19`.
+
+## Quick start
+
+`SlidewiseFileEditor` wraps the editor with PPTX load/save plumbing — give it
+async `loadBlob` and `saveBlob` callbacks and it handles parsing, dirty
+tracking, and serialisation.
+
+```tsx
+import {
+  SlidewiseFileEditor,
+  type SlidewiseFileEditorApi,
+} from "@textcortex/slidewise";
+import "@textcortex/slidewise/style.css";
+import { useRef } from "react";
+
+export function PresentationsRoute({ fileId }: { fileId: string }) {
+  const apiRef = useRef<SlidewiseFileEditorApi | null>(null);
+
+  return (
+    <SlidewiseFileEditor
+      onEditorApiChange={(api) => (apiRef.current = api)}
+      loadBlob={async () => {
+        const res = await fetch(`/api/files/${fileId}`);
+        return res.blob();
+      }}
+      saveBlob={async (pptx) => {
+        await fetch(`/api/files/${fileId}`, { method: "PUT", body: pptx });
+      }}
+    />
+  );
+}
+```
+
+The host owns transport and conflict detection; Slidewise owns parsing,
+editing, and serialisation. Call `apiRef.current.save()` to trigger a save
+from outside the editor's top bar; call `apiRef.current.isDirty()` to gate
+"unsaved changes" UI.
+
+## Lower-level entry point
+
+If your host already has a `Deck` in memory (e.g. you're storing the JSON
+shape in your own database rather than `.pptx` blobs), mount
+`SlidewiseEditor` directly:
+
+```tsx
+import { SlidewiseEditor, type Deck } from "@textcortex/slidewise";
+import "@textcortex/slidewise/style.css";
+
+<SlidewiseEditor
+  deck={deck}
+  onChange={(next) => setDeck(next)}
+  onSave={(next) => persist(next)}
+/>;
+```
+
+## Working with decks programmatically
+
+Slidewise persists slides as a versioned JSON `Deck`. The schema is the
+canonical contract — undo/redo, exports, AI features, and persistence all
+key off it.
+
+```ts
+import {
+  parsePptx,
+  serializeDeck,
+  migrate,
+  CURRENT_DECK_VERSION,
+  type Deck,
+} from "@textcortex/slidewise";
+
+const deck: Deck = await parsePptx(blob); // import
+const pptx: Blob = await serializeDeck(deck); // export
+const safe: Deck = migrate(unknownDeckJson); // normalise an external deck
+```
+
+`migrate()` runs every external deck (PPTX import, JSON import, localStorage
+hydration, host props) through the schema migration chain so the rest of the
+editor only sees current-shape decks. It throws if the input was written by a
+newer Slidewise than the host has installed — pin the version range you can
+support.
+
+## Releasing
+
+Versioning and publishing run through
+[changesets](https://github.com/changesets/changesets).
+
+```bash
+pnpm changeset            # describe the impact of your change
+pnpm version-packages     # bump versions + update CHANGELOG (CI usually does this)
+pnpm release              # build + publish (CI does this on merge)
+```
+
+CI (`.github/workflows/release.yml`) opens a "Version Packages" PR whenever
+there are pending changesets and publishes to npm when that PR merges.
+
+## Repo layout
+
+- `src/SlidewiseEditor.tsx` / `src/SlidewiseFileEditor.tsx` — public entry components
+- `src/components/editor/` — top bar, slide rail, canvas, panels
+- `src/lib/pptx/` — PPTX import (`pptxToDeck`) and export (`deckToPptx`)
+- `src/lib/schema/` — `Deck` schema versioning + migrator
+- `src/lib/types.ts` — `Deck` / `Slide` / `SlideElement` shapes (the contract)

package/dist/__vite-browser-external-DYxpcVy9.js

@@ -0,0 +1,5 @@
+const e = {};
+export {
+  e as default
+};
+//# sourceMappingURL=__vite-browser-external-DYxpcVy9.js.map

package/dist/__vite-browser-external-DYxpcVy9.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"__vite-browser-external-DYxpcVy9.js","sources":["../__vite-browser-external"],"sourcesContent":["export default {}"],"names":["__viteBrowserExternal"],"mappings":"AAAA,MAAAA,IAAe,CAAA;"}

package/dist/file.svg

@@ -0,0 +1 @@
+<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>

package/dist/globe.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>