@open-aippt/core 1.13.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 aibabelx
+
+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,98 @@
+# @open-aippt/core
+
+Runtime and CLI for [open-aippt](https://github.com/aibabelx/open-aippt) — a React-based slide framework where you write slides and the framework handles the Vite/React stack, layout, navigation, hot reload, and fullscreen play mode.
+
+## Install
+
+```bash
+pnpm add @open-aippt/core
+```
+
+Most users get this installed automatically by running `npx @open-aippt/cli init`. Use this package directly only if you're wiring up an existing workspace by hand.
+
+## What's inside
+
+- **Runtime** — home page, slide viewer, thumbnail rail, keyboard navigation, and fullscreen presenter mode. Every slide renders into a fixed **1920×1080** canvas; the framework scales it.
+- **Vite plugin** — discovers `slides/<id>/index.{tsx,jsx,ts,js}`, exposes them via virtual modules, and reloads when slides are added or removed.
+- **CLI** — `open-aippt dev | build | preview` so workspaces never need to touch Vite, React, or tsconfig directly.
+
+## CLI
+
+Once installed, the `open-aippt` bin is available in the workspace:
+
+| Command | Description |
+| --- | --- |
+| `open-aippt dev` | Start the dev server. Flags: `-p, --port <port>`, `--host [host]`, `--open`. |
+| `open-aippt build` | Build a static site. Flags: `--out-dir <dir>` (defaults to `dist`). |
+| `open-aippt preview` | Preview the production build. Flags: `-p, --port <port>`, `--host [host]`, `--open`. |
+
+## Config
+
+Create `open-aippt.config.ts` in the workspace root (all fields optional):
+
+```ts
+import type { OpenAipptConfig } from '@open-aippt/core';
+
+const openAipptConfig: OpenAipptConfig = {
+  slidesDir: 'slides',
+  port: 5173,
+};
+
+export default openAipptConfig;
+```
+
+### Hosting under a subpath
+
+Set `base` to deploy the built site under a sub-directory (intranet folders, GitHub Pages project sites, reverse proxies). Use a leading and trailing slash:
+
+```ts
+const openAipptConfig: OpenAipptConfig = {
+  base: '/my-slides/',
+};
+```
+
+The value is passed straight to Vite's `base` and to React Router's `basename`, so client-side navigation matches the deployed path.
+
+## Authoring slides
+
+Slides live under `slides/<kebab-case-id>/index.tsx` and default-export an array of `Page` components:
+
+```tsx
+import type { Page } from '@open-aippt/core';
+
+const Cover: Page = () => (
+  <div className="flex h-full w-full items-center justify-center">
+    <h1 className="text-[120px] font-bold">Hello, open-aippt</h1>
+  </div>
+);
+
+const pages: Page[] = [Cover];
+export default pages;
+
+export const meta = { title: 'Hello' };
+```
+
+## Exports
+
+```ts
+import {
+  CANVAS_WIDTH,   // 1920
+  CANVAS_HEIGHT,  // 1080
+  unstable_SharedElement, // match or fade objects across pages for shared element transitions
+  type Page,
+  type SlideMeta,
+  type SlideModule,
+  type SlideTransition,
+  type OpenAipptConfig,
+} from '@open-aippt/core';
+```
+
+The Vite plugin is exposed under a subpath for advanced setups:
+
+```ts
+import { createViteConfig } from '@open-aippt/core/vite';
+```
+
+## License
+
+MIT

package/bin.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import './dist/cli/bin.js';

package/dist/build-DxTqmvsO.js

@@ -0,0 +1,17 @@
+import "./design-cpzS8aud.js";
+import { createViteConfig } from "./config-CjzqjrEA.js";
+import path from "node:path";
+import { build as build$1, mergeConfig } from "vite";
+
+//#region src/cli/build.ts
+async function build(opts = {}) {
+	const base = await createViteConfig({
+		userCwd: process.cwd(),
+		mode: "build"
+	});
+	const config = mergeConfig(base, { build: { ...opts.outDir !== void 0 ? { outDir: path.resolve(process.cwd(), opts.outDir) } : {} } });
+	await build$1(config);
+}
+
+//#endregion
+export { build };

package/dist/cli/bin.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/cli/bin.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+import { detectSkillsDrift, syncSkills } from "../sync-BPZ0m27m.js";
+import chalk from "chalk";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import * as readline from "node:readline/promises";
+import { fileURLToPath } from "node:url";
+import { Command, Option } from "commander";
+
+//#region src/cli/run.ts
+async function readVersion() {
+	const here = path.dirname(fileURLToPath(import.meta.url));
+	const pkgPath = path.resolve(here, "..", "..", "package.json");
+	const raw = await readFile(pkgPath, "utf8");
+	return JSON.parse(raw).version;
+}
+function parsePort(value) {
+	const n = Number(value);
+	if (!Number.isInteger(n) || n < 0 || n > 65535) throw new Error(`Invalid port: ${value}`);
+	return n;
+}
+async function runSkillsDriftCheck(skillsDir) {
+	if (process.env.OPEN_AIPPT_SKIP_SKILLS_CHECK === "1") return;
+	let drift;
+	try {
+		drift = await detectSkillsDrift(skillsDir);
+	} catch {
+		return;
+	}
+	const stale = drift.filter((d) => d.status !== "unchanged");
+	if (stale.length === 0) return;
+	const names = stale.map((d) => d.name).join(", ");
+	const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY);
+	if (!interactive) {
+		process.stderr.write(`${chalk.yellow("!")} Skills out of date (${names}). Run \`open-aippt sync:skills\` to update.\n`);
+		return;
+	}
+	const rl = readline.createInterface({
+		input: process.stdin,
+		output: process.stdout
+	});
+	try {
+		const answer = (await rl.question(`${chalk.yellow("!")} Skills out of date: ${chalk.bold(names)}. Sync now? ${chalk.dim("(Y/n) ")}`)).trim().toLowerCase();
+		if (answer === "" || answer === "y" || answer === "yes") await syncSkills(skillsDir);
+		else process.stdout.write(chalk.dim("Skipped. Run `open-aippt sync:skills` later to update.\n"));
+	} finally {
+		rl.close();
+	}
+}
+function resolveBuiltinSkillsDir() {
+	const here = path.dirname(fileURLToPath(import.meta.url));
+	return path.resolve(here, "..", "..", "skills");
+}
+async function run(argv) {
+	const version = await readVersion();
+	const program = new Command();
+	program.name("open-aippt").description("Author slides — we handle the Vite/React stack.").version(version, "-v, --version", "print version").helpOption("-h, --help", "show help").showHelpAfterError(chalk.dim("(run `open-aippt --help` for usage)"));
+	program.command("dev").description("Start the dev server").addOption(new Option("-p, --port <port>", "port to listen on").argParser(parsePort)).addOption(new Option("--host [host]", "expose on the network (optional host)")).option("--open", "open the browser on start").option("--no-skills-check", "skip the built-in skills drift check").action(async (flags) => {
+		if (flags.skillsCheck !== false) await runSkillsDriftCheck(resolveBuiltinSkillsDir());
+		const { dev } = await import("../dev-BYuTeJbA.js");
+		await dev(flags);
+	});
+	program.command("build").description("Build a static site").option("--out-dir <dir>", "output directory (defaults to `dist`)").action(async (flags) => {
+		const { build } = await import("../build-DxTqmvsO.js");
+		await build(flags);
+	});
+	program.command("preview").description("Preview the production build").addOption(new Option("-p, --port <port>", "port to listen on").argParser(parsePort)).addOption(new Option("--host [host]", "expose on the network (optional host)")).option("--open", "open the browser on start").action(async (flags) => {
+		const { preview } = await import("../preview-DlQvnJPq.js");
+		await preview(flags);
+	});
+	program.command("sync:skills").description("Sync built-in skills from @open-aippt/core into this workspace").option("--dry-run", "show what would change without writing").action(async (flags) => {
+		const { syncSkills: syncSkills$1 } = await import("../sync-EsYusbbL.js");
+		await syncSkills$1(resolveBuiltinSkillsDir(), flags);
+	});
+	await program.parseAsync(argv, { from: "user" });
+}
+
+//#endregion
+//#region src/cli/bin.ts
+run(process.argv.slice(2)).catch((err) => {
+	const message = err instanceof Error ? err.message : String(err);
+	process.stderr.write(`${chalk.red("error:")} ${message}\n`);
+	process.exit(1);
+});
+
+//#endregion