@pantoken/stylus 0.1.0

package/README.md

@@ -0,0 +1,54 @@
+# @pantoken/stylus
+
+Instructure design tokens as Stylus variables, resolved to concrete single-mode values from the
+pantoken IR — a self-contained Stylus token file (`instui-color-brand = #0374b5`). Icon tokens are
+skipped; they belong in CSS.
+
+## Install
+
+```sh
+npm i @pantoken/stylus
+```
+
+Also available as `pantoken/stylus`.
+
+## Usage
+
+```ts
+import { toStylus, stylus } from "@pantoken/stylus";
+import { tokens } from "@pantoken/tokens";
+
+stylus; // the ready-made rebrand variables
+toStylus(tokens, { mode: "dark" }); // convert any IR, picking the colour mode
+```
+
+Or `@import` the static file straight into a Stylus build:
+
+```stylus
+@import "@pantoken/stylus/tokens.styl"
+
+.button
+  background instui-color-brand
+```
+
+Values are resolved once, in a single colour mode (`light` by default). References (`var(...)`) and
+`light-dark(...)` are flattened to concrete values, so the output stands alone. For runtime theming,
+use `@pantoken/css` instead.
+
+## API
+
+- **`stylus: string`** — the ready-made `rebrand` variable set (also the default export).
+- **`toStylus(tokens, options?): string`** — emit Stylus variables for any token IR. `options.mode`
+  picks the colour mode (default `"light"`).
+- **`ToStylusOptions`** — options for `toStylus`.
+- **`Mode`** — the colour mode to resolve (`"light"` or `"dark"`).
+- **`./tokens.styl`** — the generated plain Stylus file, for a direct `@import`.
+
+## Related
+
+- Built from the IR published by `@pantoken/tokens`.
+- `@pantoken/scss` and `@pantoken/less` emit the same tokens for other preprocessors.
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,49 @@
+import { Mode, Mode as Mode$1 } from "@pantoken/utils";
+import { Token } from "@pantoken/model";
+
+//#region src/to-stylus.d.ts
+/** Options for {@link toStylus}. */
+interface ToStylusOptions {
+  /** Which colour mode to resolve (default `"light"`). */
+  mode?: Mode$1;
+}
+/**
+ * Emit Stylus variables for a token IR.
+ *
+ * @param tokens - The IR (e.g. from `@pantoken/tokens`).
+ * @param options - {@link ToStylusOptions}.
+ * @returns The Stylus source string.
+ *
+ * @example Emit the default (light) variables
+ * ```ts
+ * import { toStylus } from "@pantoken/stylus";
+ * import { tokens } from "@pantoken/tokens";
+ *
+ * toStylus(tokens); // "instui-color-brand = #0374b5\n…"
+ * ```
+ *
+ * @example Resolve the dark mode of another theme
+ * ```ts
+ * import { toStylus } from "@pantoken/stylus";
+ * import { byTheme } from "@pantoken/tokens";
+ *
+ * toStylus(byTheme("canvas"), { mode: "dark" });
+ * ```
+ */
+declare function toStylus(tokens: readonly Token[], options?: ToStylusOptions): string;
+//#endregion
+//#region src/index.d.ts
+/**
+ * The ready-made `rebrand` Stylus variable set.
+ *
+ * @example
+ * ```ts
+ * import { stylus } from "@pantoken/stylus";
+ * import { writeFileSync } from "node:fs";
+ *
+ * writeFileSync("tokens.styl", stylus);
+ * ```
+ */
+declare const stylus: string;
+//#endregion
+export { type Mode, type ToStylusOptions, stylus as default, stylus, toStylus };

package/dist/index.mjs

@@ -0,0 +1,67 @@
+import { tokens } from "@pantoken/tokens";
+import { resolveTokens } from "@pantoken/utils";
+//#region src/to-stylus.ts
+/**
+* Emit the pantoken IR as Stylus variables. Values are resolved to concrete, single-mode values so
+* the output is a self-contained Stylus token file (`instui-color-brand = #0374b5`). Icon tokens are
+* skipped — they belong in CSS, not Stylus variables.
+*
+* @module
+*/
+/**
+* Emit Stylus variables for a token IR.
+*
+* @param tokens - The IR (e.g. from `@pantoken/tokens`).
+* @param options - {@link ToStylusOptions}.
+* @returns The Stylus source string.
+*
+* @example Emit the default (light) variables
+* ```ts
+* import { toStylus } from "@pantoken/stylus";
+* import { tokens } from "@pantoken/tokens";
+*
+* toStylus(tokens); // "instui-color-brand = #0374b5\n…"
+* ```
+*
+* @example Resolve the dark mode of another theme
+* ```ts
+* import { toStylus } from "@pantoken/stylus";
+* import { byTheme } from "@pantoken/tokens";
+*
+* toStylus(byTheme("canvas"), { mode: "dark" });
+* ```
+*/
+function toStylus(tokens, options = {}) {
+	const resolved = resolveTokens(tokens, { mode: options.mode ?? "light" });
+	const lines = ["// DO NOT EDIT — generated by @pantoken/stylus", ""];
+	for (const token of tokens) {
+		if (token.meta?.kind === "icon") continue;
+		lines.push(`${token.name.replace(/^--/, "")} = ${resolved.get(token.name) ?? token.value}`);
+	}
+	return `${lines.join("\n")}\n`;
+}
+//#endregion
+//#region src/index.ts
+/**
+* `@pantoken/stylus` — Instructure design tokens as Stylus variables.
+*
+* {@link toStylus} converts any IR; {@link stylus} is the ready-made `rebrand` variable set. A static
+* file is published at `@pantoken/stylus/tokens.styl`.
+*
+* @module
+* @experimental
+*/
+/**
+* The ready-made `rebrand` Stylus variable set.
+*
+* @example
+* ```ts
+* import { stylus } from "@pantoken/stylus";
+* import { writeFileSync } from "node:fs";
+*
+* writeFileSync("tokens.styl", stylus);
+* ```
+*/
+const stylus = toStylus(tokens);
+//#endregion
+export { stylus as default, stylus, toStylus };