@pantoken/jekyll 0.1.0

package/README.md

@@ -0,0 +1,57 @@
+# @pantoken/jekyll
+
+Emit the Instructure token stylesheet for a Jekyll site. Jekyll has no standard theming-variable
+contract, so this delivers the tokens as drop-in assets: a Sass partial for `_sass/` and a plain CSS
+file for `assets/css/`.
+
+## Install
+
+```sh
+npm i @pantoken/jekyll
+```
+
+## Usage
+
+```ts
+import { toJekyllAssets } from "@pantoken/jekyll";
+
+for (const { path, content } of toJekyllAssets()) {
+  /* write `path` under your site root */
+}
+```
+
+Or via the CLI, straight into a site:
+
+```sh
+pantoken generate jekyll --out ./my-site
+```
+
+## Output
+
+Three files under the site root:
+
+- `_sass/pantoken.scss` — a Sass partial (Instructure tokens as `$instui-*` variables). Import it
+  from your main stylesheet: `@import "pantoken";`.
+- `assets/css/pantoken.css` — a plain stylesheet (`--instui-*` custom properties) for sites that
+  don't use Sass. Reference it from your layout.
+- `assets/css/pantoken-prose.css` — an InstUI-look stylesheet for rendered content (tables,
+  headings, links, code) in a `.pantoken-prose` region. From `@pantoken/components`.
+
+Use the Sass partial if your site compiles SCSS; use the plain CSS otherwise. Add the prose sheet
+and wrap your content in `.pantoken-prose` for the InstUI content look.
+
+## API
+
+- **`toJekyllAssets(): JekyllFile[]`** — build the token asset files (paths relative to the site
+  root).
+- **`JekyllFile`** — a generated file: `path` (site-relative) and `content`.
+
+## Related
+
+- Wraps `@pantoken/scss` (the Sass partial), `@pantoken/css` (the plain stylesheet), and
+  `@pantoken/components` (the content look).
+- Mirrors `@pantoken/hugo`, the same idea for Hugo sites.
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,28 @@
+//#region src/index.d.ts
+/** A generated file: a site-relative path and its contents. */
+interface JekyllFile {
+  path: string;
+  content: string;
+}
+/**
+ * Build the token asset files for a Jekyll site (paths relative to the site root).
+ *
+ * @returns The Sass partial (`_sass/pantoken.scss`), the plain stylesheet
+ * (`assets/css/pantoken.css`), and the prose stylesheet (`assets/css/pantoken-prose.css`).
+ *
+ * @example Write the assets under a site root
+ * ```ts
+ * import { writeFileSync, mkdirSync } from "node:fs";
+ * import { dirname, join } from "node:path";
+ * import { toJekyllAssets } from "@pantoken/jekyll";
+ *
+ * for (const { path, content } of toJekyllAssets()) {
+ *   const dest = join("./my-site", path);
+ *   mkdirSync(dirname(dest), { recursive: true });
+ *   writeFileSync(dest, content);
+ * }
+ * ```
+ */
+declare function toJekyllAssets(): JekyllFile[];
+//#endregion
+export { JekyllFile, toJekyllAssets };

package/dist/index.mjs

@@ -0,0 +1,52 @@
+import { css } from "@pantoken/css";
+import { proseCss } from "@pantoken/components";
+import { scss } from "@pantoken/scss";
+//#region src/index.ts
+/**
+* `@pantoken/jekyll` — emit the Instructure token stylesheet for a Jekyll site.
+*
+* Jekyll has no standard theming-variable contract, so this delivers the tokens as drop-in assets:
+* a Sass partial for `_sass/` (import it from your main stylesheet) and a plain CSS file for
+* `assets/css/` (from `@pantoken/scss` and `@pantoken/css`), plus an InstUI-look prose stylesheet
+* (from `@pantoken/components`) that styles content in a `.pantoken-prose` region.
+*
+* @module
+* @experimental
+*/
+/**
+* Build the token asset files for a Jekyll site (paths relative to the site root).
+*
+* @returns The Sass partial (`_sass/pantoken.scss`), the plain stylesheet
+* (`assets/css/pantoken.css`), and the prose stylesheet (`assets/css/pantoken-prose.css`).
+*
+* @example Write the assets under a site root
+* ```ts
+* import { writeFileSync, mkdirSync } from "node:fs";
+* import { dirname, join } from "node:path";
+* import { toJekyllAssets } from "@pantoken/jekyll";
+*
+* for (const { path, content } of toJekyllAssets()) {
+*   const dest = join("./my-site", path);
+*   mkdirSync(dirname(dest), { recursive: true });
+*   writeFileSync(dest, content);
+* }
+* ```
+*/
+function toJekyllAssets() {
+	return [
+		{
+			path: "_sass/pantoken.scss",
+			content: scss
+		},
+		{
+			path: "assets/css/pantoken.css",
+			content: css
+		},
+		{
+			path: "assets/css/pantoken-prose.css",
+			content: proseCss({ scope: ".pantoken-prose" })
+		}
+	];
+}
+//#endregion
+export { toJekyllAssets };

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@pantoken/jekyll",
+  "version": "0.1.0",
+  "description": "Emit the Instructure token stylesheet for a Jekyll site (a _sass partial + a plain CSS asset).",
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@pantoken/components": "0.1.0",
+    "@pantoken/scss": "0.1.0",
+    "@pantoken/css": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.3",
+    "typescript": "^6.0.3",
+    "vite": "npm:@voidzero-dev/vite-plus-core@0.2.4",
+    "vite-plus": "0.2.4"
+  },
+  "scripts": {
+    "build": "vp pack",
+    "dev": "vp pack --watch",
+    "test": "vp test",
+    "check": "vp check"
+  }
+}