@olwiba/dx 0.0.9

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Olwiba
+
+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,144 @@
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: light)" srcset="./public/olwibaDX--light.gif" />
+    <source media="(prefers-color-scheme: dark)" srcset="./public/olwibaDX.gif" />
+    <img src="./public/olwibaDX.gif" alt="olwibaDX" style="width: 100%;" />
+  </picture>
+</p>
+
+<p align="center">
+  <strong>Developer experience tooling for the Olwiba ecosystem.</strong>
+</p>
+
+<p align="center">
+  <a href="https://github.com/Olwiba/olwibaDX/issues/new?template=bug_report.md">🪲 Report a bug</a> ·
+  <a href="https://github.com/Olwiba/olwibaDX/issues/new?template=feature_request.md">✨ Feature request</a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/sponsors/Olwiba"><img src="https://img.shields.io/static/v1?label=Sponsor&message=%E2%9D%A4&logo=GitHub&color=22c55e" alt="Sponsor" /></a>
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/Olwiba/olwibaDX?label=license&logo=github" alt="License" /></a>
+  <a href="https://github.com/Olwiba/olwibaDX/issues"><img src="https://img.shields.io/github/issues/Olwiba/olwibaDX" alt="Issues" /></a>
+</p>
+
+## What This Is
+
+`@olwiba/dx` is a collection of tools focused on delivering the best developer experience when building projects.
+
+A lot of what's in here reflects personal preference. Small build-time tooling and helpers I've used in my projects.  
+This package grows as the ecosystem grows, so expect new features over time.
+
+Feel free to request additions or leverage what's already added as you see fit.
+
+## Installation
+
+```bash
+bun add -d @olwiba/dx
+```
+
+## Features
+
+### Dev Banners
+
+Coloured ASCII banners printed on Vite dev server start and tsup build success. Makes it instantly obvious which project is running in your terminal.
+
+```ts
+// vite.config.ts
+import { createDevBannerPlugin } from "@olwiba/dx";
+
+export default defineConfig({
+  plugins: [
+    createDevBannerPlugin({
+      segments: [
+        { text: "my" },
+        { text: "App", colorHex: "#22D3EE" },
+      ],
+    }),
+  ],
+});
+```
+
+For tsup, swap `createDevBannerPlugin` for `createTsupBannerHook` and pass it to `onSuccess`. For a one-shot print, call `printBanner` directly.
+
+### ASCII Text
+
+Figlet renderer with a bundled DOS Rebel font. Powers the `<AsciiText>` component in `@olwiba/cn`.
+
+```ts
+import { renderAscii } from "@olwiba/dx/ascii";
+
+const art = renderAscii("hello", { font: "dosrebel" });
+```
+
+### ASCII GIF Generator
+
+Render an animated ASCII GIF from any text. This is what produced the README banner you see at the top of this file.
+
+```bash
+bunx @olwiba/dx ascii-gif \
+  --text "olwibaDX" \
+  --accent "DX" \
+  --out ./public/olwibaDX.gif
+```
+
+### Preview Generator
+
+Puppeteer-based screenshot tool used to pre-render the isometric preview tiles on docs sites.
+
+```ts
+import { generatePreviews } from "@olwiba/dx";
+
+await generatePreviews({
+  url: "http://localhost:3000/preview",
+  outputDir: "./public/previews",
+});
+```
+
+### ESLint Config
+
+Opinionated lint rules shared across the ecosystem.
+
+```ts
+// eslint.config.js
+import olwibaConfig from "@olwiba/dx/eslint";
+
+export default [...olwibaConfig];
+```
+
+### Skills
+
+Installable Claude/Amp skills manifest for working in Olwiba projects.
+
+```bash
+bunx @olwiba/dx skills install
+```
+
+## Tech Stack
+
+- [TypeScript](https://www.typescriptlang.org)
+- [tsup](https://tsup.egoist.dev)
+- [Vite](https://vite.dev)
+- [Puppeteer](https://pptr.dev)
+- [figlet](https://github.com/patorjk/figlet.js)
+- [chalk](https://github.com/chalk/chalk)
+
+## Ecosystem
+
+- [`@olwiba/cn`](https://github.com/Olwiba/olwibaCN) — shadcn-style component primitives
+- _More coming soon!_
+
+## Contributing
+
+Bug reports, pull requests & feature requests are welcome.
+Open an issue first for anything beyond a small fix.
+
+<br/>
+<br/>
+
+<p align="center">
+  Built with 💖 by <a href="https://github.com/Olwiba">Olwiba</a>
+</p>
+
+<p align="center">
+  <a href="https://buymeacoffee.com/olwiba"><img src="https://img.shields.io/badge/Buy%20Me%20A%20Coffee-FFDD00?logo=buymeacoffee&logoColor=black" alt="Buy Me A Coffee" /></a>
+</p>

package/dist/ascii/index.d.ts

@@ -0,0 +1,64 @@
+export { A as AsciiFontName, a as asciiFonts, g as getAsciiFont } from '../fonts-DdHWzA4X.js';
+
+interface FigletFont {
+    height: number;
+    baseline: number;
+    hardblank: string;
+    chars: Map<number, string[]>;
+}
+declare function parseFigletFont(raw: string): FigletFont;
+
+interface AsciiCell {
+    ch: "█" | "░";
+    col: number;
+    row: number;
+}
+interface AsciiTextLayout {
+    cells: AsciiCell[];
+    cols: number;
+    rows: number;
+}
+declare function composeAsciiText(font: FigletFont, text: string): AsciiTextLayout;
+declare function getAsciiAccentColumns(font: FigletFont, text: string, accent: string): Set<number>;
+
+declare const ASCII_CHAR_WIDTH = 7.5;
+declare const ASCII_CHAR_HEIGHT = 15;
+interface AsciiWave {
+    cx: number;
+    cy: number;
+    t: number;
+}
+interface AsciiPointer {
+    x: number;
+    y: number;
+    active: boolean;
+}
+interface AsciiFrameState {
+    time?: number;
+    phase?: number;
+    pointer?: AsciiPointer;
+    waves?: AsciiWave[];
+}
+interface AsciiRenderOptions extends AsciiFrameState {
+    accentColumns?: ReadonlySet<number>;
+    color: string;
+    accentColor?: string;
+    charWidth?: number;
+    charHeight?: number;
+}
+interface AsciiFrameContext {
+    clearRect(x: number, y: number, width: number, height: number): void;
+    fillRect(x: number, y: number, width: number, height: number): void;
+    globalAlpha: number;
+    fillStyle: string;
+}
+declare function getAsciiCanvasSize(layout: AsciiTextLayout, charWidth?: number, charHeight?: number): {
+    width: number;
+    height: number;
+};
+declare function getAsciiCellIntensity(cell: AsciiCell, options: AsciiFrameState): number;
+declare function renderAsciiFrameToContext(ctx: AsciiFrameContext, layout: AsciiTextLayout, options: AsciiRenderOptions): void;
+
+declare const dosrebelFont: string;
+
+export { ASCII_CHAR_HEIGHT, ASCII_CHAR_WIDTH, type AsciiCell, type AsciiFrameContext, type AsciiFrameState, type AsciiPointer, type AsciiRenderOptions, type AsciiTextLayout, type AsciiWave, type FigletFont, composeAsciiText, dosrebelFont, getAsciiAccentColumns, getAsciiCanvasSize, getAsciiCellIntensity, parseFigletFont, renderAsciiFrameToContext };