@pantoken/hugo 0.1.0

package/README.md

@@ -0,0 +1,56 @@
+# @pantoken/hugo
+
+Emit the Instructure token stylesheet for a Hugo site. Hugo has no standard theming-variable
+contract, so this delivers the tokens as drop-in assets under `assets/`, where Hugo Pipes (and Dart
+Sass) pick them up.
+
+## Install
+
+```sh
+npm i @pantoken/hugo
+```
+
+## Usage
+
+```ts
+import { toHugoAssets } from "@pantoken/hugo";
+
+for (const { path, content } of toHugoAssets()) {
+  /* write `path` under your site root */
+}
+```
+
+Or via the CLI, straight into a site:
+
+```sh
+pantoken generate hugo --out ./my-site
+```
+
+## Output
+
+Three files under the site root:
+
+- `assets/scss/_pantoken.scss` — a Sass partial (`$instui-*` variables). Import it from your main
+  SCSS and compile with `resources.Get "scss/main.scss" | toCSS`.
+- `assets/css/pantoken.css` — a plain stylesheet (`--instui-*` custom properties) you can pipe
+  directly with `resources.Get "css/pantoken.css"`.
+- `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
+
+- **`toHugoAssets(): HugoFile[]`** — build the token asset files (paths relative to the site root).
+- **`HugoFile`** — 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/jekyll`, the same idea for Jekyll 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 HugoFile {
+  path: string;
+  content: string;
+}
+/**
+ * Build the token asset files for a Hugo site (paths relative to the site root).
+ *
+ * @returns The Sass partial (`assets/scss/_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 { toHugoAssets } from "@pantoken/hugo";
+ *
+ * for (const { path, content } of toHugoAssets()) {
+ *   const dest = join("./my-site", path);
+ *   mkdirSync(dirname(dest), { recursive: true });
+ *   writeFileSync(dest, content);
+ * }
+ * ```
+ */
+declare function toHugoAssets(): HugoFile[];
+//#endregion
+export { HugoFile, toHugoAssets };

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/hugo` — emit the Instructure token stylesheet for a Hugo site.
+*
+* Hugo has no standard theming-variable contract, so this delivers the tokens as drop-in assets
+* under `assets/` (where Hugo Pipes / Dart Sass pick them up): a Sass partial and a plain CSS file
+* (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 Hugo site (paths relative to the site root).
+*
+* @returns The Sass partial (`assets/scss/_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 { toHugoAssets } from "@pantoken/hugo";
+*
+* for (const { path, content } of toHugoAssets()) {
+*   const dest = join("./my-site", path);
+*   mkdirSync(dirname(dest), { recursive: true });
+*   writeFileSync(dest, content);
+* }
+* ```
+*/
+function toHugoAssets() {
+	return [
+		{
+			path: "assets/scss/_pantoken.scss",
+			content: scss
+		},
+		{
+			path: "assets/css/pantoken.css",
+			content: css
+		},
+		{
+			path: "assets/css/pantoken-prose.css",
+			content: proseCss({ scope: ".pantoken-prose" })
+		}
+	];
+}
+//#endregion
+export { toHugoAssets };

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@pantoken/hugo",
+  "version": "0.1.0",
+  "description": "Emit the Instructure token stylesheet for a Hugo site (an assets 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/css": "0.1.0",
+    "@pantoken/components": "0.1.0",
+    "@pantoken/scss": "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"
+  }
+}