@allxsmith/bestax-bulma 5.42.1 → 5.43.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allxsmith/bestax-bulma",
3
- "version": "5.42.1",
3
+ "version": "5.43.1",
4
4
  "description": "A fully-typed React component library for the Bulma CSS framework. Build modern UIs quickly with reusable, accessible, and customizable Bulma-based React components.",
5
5
  "main": "dist/index.cjs",
6
6
  "module": "dist/index.esm.js",
@@ -10,6 +10,7 @@
10
10
  "dist",
11
11
  "src/scss",
12
12
  "README.md",
13
+ "THIRD-PARTY-NOTICES.md",
13
14
  "AGENTS.md",
14
15
  "CLAUDE.md",
15
16
  "llms.txt"
@@ -31,15 +32,15 @@
31
32
  "@storybook/test-runner": "^0.26.0",
32
33
  "@testing-library/jest-dom": "^7.0.1",
33
34
  "@testing-library/react": "^16.3.3",
34
- "@testing-library/user-event": "^14.6.7",
35
+ "@testing-library/user-event": "^14.6.8",
35
36
  "@types/jest": "^30.0.0",
36
- "@types/react": "^19.2.18",
37
- "@types/react-dom": "^19.2.5",
38
- "@typescript-eslint/eslint-plugin": "^8.71.1",
39
- "@typescript-eslint/parser": "^8.71.1",
40
- "eslint": "^10.12.0",
37
+ "@types/react": "^19.3.0",
38
+ "@types/react-dom": "^19.3.0",
39
+ "@typescript-eslint/eslint-plugin": "^8.71.2",
40
+ "@typescript-eslint/parser": "^8.71.2",
41
+ "eslint": "^10.13.0",
41
42
  "eslint-config-prettier": "^10.1.5",
42
- "eslint-plugin-prettier": "^5.2.1",
43
+ "eslint-plugin-prettier": "^5.5.7",
43
44
  "eslint-plugin-react-hooks": "^7.1.1",
44
45
  "eslint-plugin-storybook": "^10.6.2",
45
46
  "ionicons": "^8.1.0",
@@ -47,18 +48,18 @@
47
48
  "jest-environment-jsdom": "^30.2.0",
48
49
  "material-icons": "^1.13.14",
49
50
  "material-symbols": "^0.47.6",
50
- "playwright": "^1.63.0",
51
+ "playwright": "^1.64.1",
51
52
  "prettier": "^3.9.9",
52
53
  "rimraf": "^6.0.1",
53
- "rollup": "^4.64.1",
54
+ "rollup": "^4.64.10",
54
55
  "rollup-plugin-scss": "^4.0.1",
55
56
  "rollup-plugin-visualizer": "^7.1.1",
56
- "sass": "^1.105.1",
57
+ "sass": "^1.105.2",
57
58
  "storybook": "^10.6.2",
58
- "ts-jest": "^29.4.14",
59
+ "ts-jest": "^29.4.15",
59
60
  "tslib": "^2.8.0",
60
61
  "typescript": "^6.0.3",
61
- "vite": "^8.3.3"
62
+ "vite": "^8.3.4"
62
63
  },
63
64
  "dependencies": {
64
65
  "bulma": "^1.0.4"
@@ -224,5 +225,5 @@
224
225
  "test-storybook:dark": "STORYBOOK_THEME=dark test-storybook",
225
226
  "test-storybook:ci": "node scripts/test-storybook-ci.mjs"
226
227
  },
227
- "readme": "# @allxsmith/bestax-bulma\n\n[![npm version](https://img.shields.io/npm/v/@allxsmith/bestax-bulma.svg)](https://www.npmjs.com/package/@allxsmith/bestax-bulma)\n[![npm downloads](https://img.shields.io/npm/dm/@allxsmith/bestax-bulma.svg)](https://www.npmjs.com/package/@allxsmith/bestax-bulma)\n[![bundle size](https://img.shields.io/bundlephobia/minzip/@allxsmith/bestax-bulma.svg)](https://bundlephobia.com/package/@allxsmith/bestax-bulma)\n[![TypeScript](https://img.shields.io/badge/TypeScript-100%25-blue.svg)](https://www.typescriptlang.org/)\n[![Coverage](https://img.shields.io/badge/coverage-99%25-brightgreen.svg)](https://github.com/allxsmith/bestax/blob/main/bulma-ui/jest.config.js)\n[![Bulma](https://img.shields.io/badge/Bulma-v1.0+-00d1b2.svg)](https://bulma.io)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Socket Badge](https://badge.socket.dev/npm/package/@allxsmith/bestax-bulma/latest)](https://socket.dev/npm/package/@allxsmith/bestax-bulma/overview)\n[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/allxsmith/bestax/badge)](https://scorecard.dev/viewer/?uri=github.com/allxsmith/bestax)\n[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/14361/badge)](https://www.bestpractices.dev/projects/14361)\n[![npm provenance](https://img.shields.io/badge/npm-provenance-3fb950.svg)](https://www.npmjs.com/package/@allxsmith/bestax-bulma#provenance)\n[![Security policy](https://img.shields.io/badge/security-policy-blue.svg)](https://github.com/allxsmith/bestax/blob/main/SECURITY.md)\n\nTypeScript-first React component library for the **Bulma v1** CSS framework — 80+ fully typed, tree-shakeable components, including extras like Carousel, Dialog, Sidebar, Steps, and date/time pickers.\n\n**Requires React `^18 || ^19`.** Bulma v1 is the only runtime dependency and installs automatically.\n\nPart of the [bestax monorepo](https://github.com/allxsmith/bestax) — see also [`create-bestax`](https://www.npmjs.com/package/create-bestax) for scaffolding new projects.\n\n---\n\n## 📚 Comprehensive Documentation\n\n**Looking for full documentation, guides, API references, and best practices?** \n👉 **Visit our official docs at [https://bestax.io](https://bestax.io)**\n\n> The documentation site is the best place to learn about all bestax-bulma features, usage patterns, and updates. We strongly recommend using the docs as your primary resource!\n\n---\n\n## 🚀 Getting Started\n\nStarting fresh? Scaffold a ready-to-go app instead: `npm create bestax@latest my-app`.\n\n### 1. Install the package\n\n```bash\nnpm install @allxsmith/bestax-bulma\n# or\npnpm add @allxsmith/bestax-bulma\n```\n\n### 2. Import the CSS\n\nThe library bundles its own CSS (Bulma v1 + the bestax extras). Import it once in your main JS/TS file:\n\n```js\nimport '@allxsmith/bestax-bulma/bestax.css';\n```\n\nPrefer stock Bulma? That works too — add `extras.css` for the bestax-only components' styles:\n\n```js\nimport 'bulma/css/bulma.min.css';\nimport '@allxsmith/bestax-bulma/extras.css';\n```\n\nMore flavors are shipped as subpath exports — prefixed classes (`versions/bestax-prefixed.css` + `<ConfigProvider classPrefix=\"bestax-\">`), no-helpers, no-dark-mode, and raw SCSS at `@allxsmith/bestax-bulma/scss/*`. See the [installation guide](https://bestax.io/docs/guides/getting-started/installation).\n\n### 3. (Optional) Add an Icon Library\n\nFive icon libraries are supported as optional peer dependencies: [Font Awesome](https://fontawesome.com/) (`@fortawesome/fontawesome-free`), Material Design Icons (`@mdi/font`), `ionicons`, `material-icons`, and `material-symbols`.\n\n```bash\nnpm install @fortawesome/fontawesome-free\n```\n\nSet the default for your whole app with [`ConfigProvider`](https://bestax.io/docs/api/helpers/config), e.g. `<ConfigProvider iconLibrary=\"fa\">`.\n\n### 4. Quick Example\n\n```tsx\nimport '@allxsmith/bestax-bulma/bestax.css';\nimport { Button } from '@allxsmith/bestax-bulma';\n\nfunction App() {\n return (\n <Button color=\"primary\" onClick={() => alert('Clicked!')}>\n Click Me\n </Button>\n );\n}\n\nexport default App;\n```\n\n### 5. Theming and Dark Mode\n\nWrap your app in [`Theme`](https://bestax.io/docs/api/helpers/theme) to override Bulma's `--bulma-*` CSS variables and control the color scheme:\n\n```tsx\nimport { Theme } from '@allxsmith/bestax-bulma';\n\n<Theme isRoot colorMode=\"system\">\n {/* colorMode: 'light' | 'dark' | 'system' */}\n <App />\n</Theme>;\n```\n\n---\n\n## ⭐ Why Choose bestax-bulma?\n\n- **Supports the latest Bulma v1.x**\n Other React Bulma libraries are stuck on Bulma 0.9.4 — bestax-bulma is built for the future.\n- **80+ components**\n All of Bulma v1, plus extras: Carousel, Dialog, Sidebar, Steps, Autocomplete, Taginput, DateInput/TimeInput/DateTimeInput pickers, and more. (Migrating from v2? Snackbar merged into [Toast](https://bestax.io/docs/api/components/toast).)\n- **Dark mode & theming built in**\n `Theme colorMode`, `--bulma-*` variable overrides, and prefixed-class builds via `ConfigProvider`.\n- **Just one dependency: Bulma**\n Every Bulma library depends on it — we ship it automatically. Clean install, fewer security concerns.\n- **Tree-shakeable ESM + CJS**\n Import only what you use — see the live [bundle size](https://bundlephobia.com/package/@allxsmith/bestax-bulma).\n- **99% unit test coverage**\n Enforced in CI by the [jest config](https://github.com/allxsmith/bestax/blob/main/bulma-ui/jest.config.js) — not just claimed.\n- **100% TypeScript**\n Full type safety for you and your team.\n- **Active developer support**\n Issues? Questions? PRs? Get fast responses and real improvements.\n\n---\n\n## 📦 NPM Package\n\nView the package on npmjs: \n👉 [https://www.npmjs.com/package/@allxsmith/bestax-bulma](https://www.npmjs.com/package/@allxsmith/bestax-bulma)\n\n---\n\n## 🔒 Hardened by default\n\nThis package is one runtime dependency deep (Bulma) and is published under a deliberately strict pipeline:\n\n- **Signed provenance** — every release carries a sigstore attestation linking the tarball to the exact commit and CI run that built it. Verify it in the **Provenance** section of the [npm page](https://www.npmjs.com/package/@allxsmith/bestax-bulma#provenance), or run `npm audit signatures` in your project.\n- **npm OIDC trusted publishing** — short-lived, per-run credentials; no long-lived `NPM_TOKEN` exists to be stolen. Release commits and tags are GPG-signed.\n- **Socket.dev scans every PR** for malware, install scripts, obfuscated code, and privilege escalation before it can reach `main`.\n- **Dependencies are a deliberate act** — install scripts are blocked unless individually allow-listed, freshly published versions are refused for 3 days, and CI installs only what the reviewed lockfile resolves.\n- **Every GitHub Action is pinned to a full commit SHA**, so a compromised action release can't roll silently into a build of this package.\n- **CodeQL, Dependency Review, and Dependabot** run continuously, alongside a high-severity `pnpm audit` gate.\n- **Layered AI review before merge** — [CodeRabbit](https://coderabbit.ai) plus an independent adversarial Claude review (a different model from the one writing AI-authored changes), on top of required green CI, an approving review, and a human merge.\n\nFull detail: [`SECURITY.md`](https://github.com/allxsmith/bestax/blob/main/SECURITY.md) · [Security guide](https://bestax.io/docs/guides/security)\n\n---\n\n## 📚 Documentation\n\n**For full documentation, guides, and best practices, please use our official docs site:**\n\n👉 [https://bestax.io](https://bestax.io)\n\n> **Always refer to the [documentation site](https://bestax.io) first:** \n> It's the most complete and up-to-date source for everything bestax-bulma!\n\n---\n\n## 📖 Storybook\n\nExplore live, interactive component examples in our Storybook:\n\n👉 [https://bestax.io/storybook](https://bestax.io/storybook)\n\n---\n\n## 🤖 For AI Tools\n\nBuilding with an AI agent (Claude Code, Cursor, Copilot)? bestax-bulma ships LLM-optimized docs:\n\n- 📘 **[LLMs guide](https://bestax.io/docs/guides/llms)** — how to use the library with AI tools\n- 📄 **[llms.txt](https://bestax.io/llms.txt)** — curated index · **[llms-full.txt](https://bestax.io/llms-full.txt)** — the full docs in one file · every docs page is also served as raw markdown\n- 📦 **In the npm package** — the tarball ships `llms.txt`, `AGENTS.md`, and `CLAUDE.md` pointer files, so agents exploring `node_modules` land on these resources by filename\n- 🧩 **[Agent Skills](https://bestax.io/docs/skills/intro)** — teach your agent the bestax way:\n\n | Skill | Use it when… |\n | ------------------------- | -------------------------------------------------------------------------------- |\n | `bestax-layout-scaffold` | Turning a high-level request (dashboard, landing page, …) into a responsive page |\n | `bestax-form` | Building forms — Field/Control composition and the full input inventory |\n | `bestax-theming` | Customizing colors, fonts, dark mode via `Theme` and `--bulma-*` variables |\n | `bestax-custom-component` | Building a new custom component beyond stock Bulma, the bestax way |\n | `bestax-icons` | Adding icons — Icon/IconText and the five supported icon libraries |\n | `bestax-optimize` | Shrinking the built CSS — flavor builds, modular Sass, import hygiene |\n | `bestax-migrate` | Moving an app off react-bulma-components (v4) onto bestax-bulma |\n\n ```bash\n npx skills add https://github.com/allxsmith/bestax --skill bestax-layout-scaffold\n ```\n\n New projects get the skills automatically with `npm create bestax@latest my-app --skills` (plus a generated `CLAUDE.md`).\n\n---\n\n## 🙏 Attribution\n\nbestax-bulma is built on top of the incredible [Bulma](https://bulma.io) CSS framework,\n© [Jeremy Thomas](https://github.com/jgthms) and licensed under the\n[MIT License](https://github.com/jgthms/bulma/blob/main/LICENSE). Some example content and\ndocumentation is adapted from the Bulma website\n([CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/)), © Jeremy Thomas.\n\nIf you find Bulma useful, please consider\n[sponsoring Jeremy Thomas](https://github.com/sponsors/jgthms) to support its continued\ndevelopment.\n\n_We are not affiliated with Bulma or Jeremy Thomas in any way — we're just big fans of the\nBulma framework!_\n\n## License\n\nSource code licensed MIT\n"
228
+ "readme": "# @allxsmith/bestax-bulma\n\n[![npm version](https://img.shields.io/npm/v/@allxsmith/bestax-bulma.svg)](https://www.npmjs.com/package/@allxsmith/bestax-bulma)\n[![npm downloads](https://img.shields.io/npm/dm/@allxsmith/bestax-bulma.svg)](https://www.npmjs.com/package/@allxsmith/bestax-bulma)\n[![bundle size](https://img.shields.io/bundlephobia/minzip/@allxsmith/bestax-bulma.svg)](https://bundlephobia.com/package/@allxsmith/bestax-bulma)\n[![TypeScript](https://img.shields.io/badge/TypeScript-100%25-blue.svg)](https://www.typescriptlang.org/)\n[![Coverage](https://img.shields.io/badge/coverage-99%25-brightgreen.svg)](https://github.com/allxsmith/bestax/blob/main/bulma-ui/jest.config.js)\n[![Bulma](https://img.shields.io/badge/Bulma-v1.0+-00d1b2.svg)](https://bulma.io)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Socket Badge](https://badge.socket.dev/npm/package/@allxsmith/bestax-bulma/latest)](https://socket.dev/npm/package/@allxsmith/bestax-bulma/overview)\n[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/allxsmith/bestax/badge)](https://scorecard.dev/viewer/?uri=github.com/allxsmith/bestax)\n[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/14361/badge)](https://www.bestpractices.dev/projects/14361)\n[![npm provenance](https://img.shields.io/badge/npm-provenance-3fb950.svg)](https://www.npmjs.com/package/@allxsmith/bestax-bulma#provenance)\n[![Security policy](https://img.shields.io/badge/security-policy-blue.svg)](https://github.com/allxsmith/bestax/blob/main/SECURITY.md)\n\nTypeScript-first React component library for the **Bulma v1** CSS framework — 80+ fully typed, tree-shakeable components, including extras like Carousel, Dialog, Sidebar, Steps, and date/time pickers.\n\n**Requires React `^18 || ^19`.** Bulma v1 is the only runtime dependency and installs automatically.\n\nPart of the [bestax monorepo](https://github.com/allxsmith/bestax) — see also [`create-bestax`](https://www.npmjs.com/package/create-bestax) for scaffolding new projects.\n\n---\n\n## 📚 Comprehensive Documentation\n\n**Looking for full documentation, guides, API references, and best practices?** \n👉 **Visit our official docs at [https://bestax.io](https://bestax.io)**\n\n> The documentation site is the best place to learn about all bestax-bulma features, usage patterns, and updates. We strongly recommend using the docs as your primary resource!\n\n---\n\n## 🚀 Getting Started\n\nStarting fresh? Scaffold a ready-to-go app instead: `npm create bestax@latest my-app`.\n\n### 1. Install the package\n\n```bash\nnpm install @allxsmith/bestax-bulma\n# or\npnpm add @allxsmith/bestax-bulma\n```\n\n### 2. Import the CSS\n\nThe library bundles its own CSS (Bulma v1 + the bestax extras). Import it once in your main JS/TS file:\n\n```js\nimport '@allxsmith/bestax-bulma/bestax.css';\n```\n\nPrefer stock Bulma? That works too — add `extras.css` for the bestax-only components' styles:\n\n```js\nimport 'bulma/css/bulma.min.css';\nimport '@allxsmith/bestax-bulma/extras.css';\n```\n\nMore flavors are shipped as subpath exports — prefixed classes (`versions/bestax-prefixed.css` + `<ConfigProvider classPrefix=\"bestax-\">`), no-helpers, no-dark-mode, and raw SCSS at `@allxsmith/bestax-bulma/scss/*`. See the [installation guide](https://bestax.io/docs/guides/getting-started/installation).\n\n### 3. (Optional) Add an Icon Library\n\nFive icon libraries are supported as optional peer dependencies: [Font Awesome](https://fontawesome.com/) (`@fortawesome/fontawesome-free`), Material Design Icons (`@mdi/font`), `ionicons`, `material-icons`, and `material-symbols`.\n\n```bash\nnpm install @fortawesome/fontawesome-free\n```\n\nSet the default for your whole app with [`ConfigProvider`](https://bestax.io/docs/api/helpers/config), e.g. `<ConfigProvider iconLibrary=\"fa\">`.\n\n### 4. Quick Example\n\n```tsx\nimport '@allxsmith/bestax-bulma/bestax.css';\nimport { Button } from '@allxsmith/bestax-bulma';\n\nfunction App() {\n return (\n <Button color=\"primary\" onClick={() => alert('Clicked!')}>\n Click Me\n </Button>\n );\n}\n\nexport default App;\n```\n\n### 5. Theming and Dark Mode\n\nWrap your app in [`Theme`](https://bestax.io/docs/api/helpers/theme) to override Bulma's `--bulma-*` CSS variables and control the color scheme:\n\n```tsx\nimport { Theme } from '@allxsmith/bestax-bulma';\n\n<Theme isRoot colorMode=\"system\">\n {/* colorMode: 'light' | 'dark' | 'system' */}\n <App />\n</Theme>;\n```\n\n---\n\n## ⭐ Why Choose bestax-bulma?\n\n- **Supports the latest Bulma v1.x**\n Other React Bulma libraries are stuck on Bulma 0.9.4 — bestax-bulma is built for the future.\n- **80+ components**\n All of Bulma v1, plus extras: Carousel, Dialog, Sidebar, Steps, Autocomplete, Taginput, DateInput/TimeInput/DateTimeInput pickers, and more. (Migrating from v2? Snackbar merged into [Toast](https://bestax.io/docs/api/components/toast).)\n- **Dark mode & theming built in**\n `Theme colorMode`, `--bulma-*` variable overrides, and prefixed-class builds via `ConfigProvider`.\n- **Just one dependency: Bulma**\n Every Bulma library depends on it — we ship it automatically. Clean install, fewer security concerns.\n- **Tree-shakeable ESM + CJS**\n Import only what you use — see the live [bundle size](https://bundlephobia.com/package/@allxsmith/bestax-bulma).\n- **99% unit test coverage**\n Enforced in CI by the [jest config](https://github.com/allxsmith/bestax/blob/main/bulma-ui/jest.config.js) — not just claimed.\n- **100% TypeScript**\n Full type safety for you and your team.\n- **Active developer support**\n Issues? Questions? PRs? Get fast responses and real improvements.\n\n---\n\n## 📦 NPM Package\n\nView the package on npmjs: \n👉 [https://www.npmjs.com/package/@allxsmith/bestax-bulma](https://www.npmjs.com/package/@allxsmith/bestax-bulma)\n\n---\n\n## 🔒 Hardened by default\n\nThis package is one runtime dependency deep (Bulma) and is published under a deliberately strict pipeline:\n\n- **Signed provenance** — every release carries a sigstore attestation linking the tarball to the exact commit and CI run that built it. Verify it in the **Provenance** section of the [npm page](https://www.npmjs.com/package/@allxsmith/bestax-bulma#provenance), or run `npm audit signatures` in your project.\n- **npm OIDC trusted publishing** — short-lived, per-run credentials; no long-lived `NPM_TOKEN` exists to be stolen. Release commits and tags are GPG-signed.\n- **Socket.dev scans every PR** for malware, install scripts, obfuscated code, and privilege escalation before it can reach `main`.\n- **Dependencies are a deliberate act** — install scripts are blocked unless individually allow-listed, freshly published versions are refused for 3 days, and CI installs only what the reviewed lockfile resolves.\n- **Every GitHub Action is pinned to a full commit SHA**, so a compromised action release can't roll silently into a build of this package.\n- **CodeQL, Dependency Review, and Dependabot** run continuously, alongside a high-severity `pnpm audit` gate.\n- **Layered AI review before merge** — [CodeRabbit](https://coderabbit.ai) plus an independent adversarial Claude review (a different model from the one writing AI-authored changes), on top of required green CI, an approving review, and a human merge.\n\nFull detail: [`SECURITY.md`](https://github.com/allxsmith/bestax/blob/main/SECURITY.md) · [Security guide](https://bestax.io/docs/guides/security)\n\n---\n\n## 📚 Documentation\n\n**For full documentation, guides, and best practices, please use our official docs site:**\n\n👉 [https://bestax.io](https://bestax.io)\n\n> **Always refer to the [documentation site](https://bestax.io) first:** \n> It's the most complete and up-to-date source for everything bestax-bulma!\n\n---\n\n## 📖 Storybook\n\nExplore live, interactive component examples in our Storybook:\n\n👉 [https://bestax.io/storybook](https://bestax.io/storybook)\n\n---\n\n## 🤖 For AI Tools\n\nBuilding with an AI agent (Claude Code, Cursor, Copilot)? bestax-bulma ships LLM-optimized docs:\n\n- 📘 **[LLMs guide](https://bestax.io/docs/guides/llms)** — how to use the library with AI tools\n- 📄 **[llms.txt](https://bestax.io/llms.txt)** — curated index · **[llms-full.txt](https://bestax.io/llms-full.txt)** — the full docs in one file · every docs page is also served as raw markdown\n- 📦 **In the npm package** — the tarball ships `llms.txt`, `AGENTS.md`, and `CLAUDE.md` pointer files, so agents exploring `node_modules` land on these resources by filename\n- 🧩 **[Agent Skills](https://bestax.io/docs/skills/intro)** — teach your agent the bestax way:\n\n | Skill | Use it when… |\n | ------------------------- | -------------------------------------------------------------------------------- |\n | `bestax-layout-scaffold` | Turning a high-level request (dashboard, landing page, …) into a responsive page |\n | `bestax-form` | Building forms — Field/Control composition and the full input inventory |\n | `bestax-theming` | Customizing colors, fonts, dark mode via `Theme` and `--bulma-*` variables |\n | `bestax-custom-component` | Building a new custom component beyond stock Bulma, the bestax way |\n | `bestax-icons` | Adding icons — Icon/IconText and the five supported icon libraries |\n | `bestax-optimize` | Shrinking the built CSS — flavor builds, modular Sass, import hygiene |\n | `bestax-migrate` | Moving an app off react-bulma-components (v4) onto bestax-bulma |\n\n ```bash\n npx skills add https://github.com/allxsmith/bestax --skill bestax-layout-scaffold\n ```\n\n New projects get the skills automatically with `npm create bestax@latest my-app --skills` (plus a generated `CLAUDE.md`).\n\n---\n\n## 🙏 Attribution\n\nbestax-bulma is built on top of the incredible [Bulma](https://bulma.io) CSS framework,\n© [Jeremy Thomas](https://github.com/jgthms) and licensed under the\n[MIT License](https://github.com/jgthms/bulma/blob/main/LICENSE), whose notice ships with the\npackage in [THIRD-PARTY-NOTICES.md](THIRD-PARTY-NOTICES.md). Some example content and documentation is\nadapted from the Bulma website\n([CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/)), © Jeremy Thomas.\n\nIf you find Bulma useful, please consider\n[sponsoring Jeremy Thomas](https://github.com/sponsors/jgthms) to support its continued\ndevelopment.\n\n_We are not affiliated with Bulma or Jeremy Thomas in any way — we're just big fans of the\nBulma framework!_\n\n## License\n\nSource code licensed MIT\n"
228
229
  }
@@ -230,8 +230,13 @@ $carousel-indicator-line-radius: cv.getVar("radius-small") !default;
230
230
  width: $carousel-item-width;
231
231
  min-width: $carousel-item-width;
232
232
 
233
- // Allow images to fill the slide
234
- img {
233
+ // Hold an image in a slide to the slide's width. `:where()` keeps the
234
+ // rule at a bare `img`'s specificity, so anything that sizes an image
235
+ // itself wins: a ratio `Image` (Bulma's `.image.is-16by9 img` and the
236
+ // rest fill the frame with `height: 100%`), an Avatar's photo, a class of
237
+ // the page's own. Ranked above them, its `height: auto` let a ratio
238
+ // image overflow its frame (#1166).
239
+ @at-root :where(.#{iv.$class-prefix}carousel .#{iv.$class-prefix}carousel-item) img {
235
240
  max-width: 100%;
236
241
  height: auto;
237
242
  display: block;
@@ -7,6 +7,7 @@
7
7
  @use 'switch';
8
8
  @use 'slider';
9
9
  @use 'numberinput';
10
+ @use 'pininput';
10
11
  @use 'rate';
11
12
  @use 'autocomplete';
12
13
  @use 'combobox';
@@ -0,0 +1,175 @@
1
+ // Bestax Extras - PinInput Styles
2
+ // A row of boxes for a short code, drawn under the one input that holds it.
3
+ // Each box is a Bulma `.input`, the way DateRangeInput's field is, so the
4
+ // boxes take Bulma's input colors, sizes, rounded corners, focus ring, dark
5
+ // mode and `--bulma-input-*` theme variables as they are, and this partial
6
+ // only lays them out. The input lies over the row with its text, caret and
7
+ // selection transparent, so a click or a tap lands on it and the boxes show
8
+ // what it holds.
9
+
10
+ @use 'bulma/sass/utilities/initial-variables' as iv;
11
+ @use 'bulma/sass/utilities/css-variables' as cv;
12
+
13
+ // In em, so it follows the size of the boxes.
14
+ $pin-input-gap: 0.5em !default;
15
+ // A Bulma control's height, in the box's own size, so a box is square.
16
+ $pin-input-box-width: cv.getVar('control-height') !default;
17
+ $pin-input-caret-width: max(1px, 0.0625em) !default;
18
+ $pin-input-caret-height: 1.25em !default;
19
+ // The box's text color, so the caret follows a color, dark mode and a theme.
20
+ $pin-input-caret-color: currentColor !default;
21
+ $pin-input-caret-blink-duration: 1s !default;
22
+
23
+ .#{iv.$class-prefix}pin-input {
24
+ @include cv.register-vars(
25
+ (
26
+ 'pin-input-gap': #{$pin-input-gap},
27
+ 'pin-input-box-width': #{$pin-input-box-width},
28
+ 'pin-input-caret-width': #{$pin-input-caret-width},
29
+ 'pin-input-caret-height': #{$pin-input-caret-height},
30
+ 'pin-input-caret-color': #{$pin-input-caret-color},
31
+ 'pin-input-caret-blink-duration': #{$pin-input-caret-blink-duration},
32
+ )
33
+ );
34
+ }
35
+
36
+ // The row is as wide as its boxes, so the input over it covers them and
37
+ // nothing more, and no wider than its container: in a narrow one the boxes
38
+ // give up some width rather than overflow.
39
+ .#{iv.$class-prefix}pin-input {
40
+ display: inline-flex;
41
+ max-width: 100%;
42
+ position: relative;
43
+ vertical-align: top;
44
+ }
45
+
46
+ // Three classes, because Bulma's `.input` sets the width and its
47
+ // `.input.is-rounded` the side padding, and these have to win whichever
48
+ // stylesheet loads first. The character sits in the middle either way.
49
+ .#{iv.$class-prefix}pin-input
50
+ > .#{iv.$class-prefix}input.#{iv.$class-prefix}pin-input-box {
51
+ flex: 0 1 auto;
52
+ font-variant-numeric: tabular-nums;
53
+ justify-content: center;
54
+ min-width: 0;
55
+ padding-left: 0;
56
+ padding-right: 0;
57
+ width: cv.getVar('pin-input-box-width');
58
+ }
59
+
60
+ .#{iv.$class-prefix}pin-input-box + .#{iv.$class-prefix}pin-input-box {
61
+ margin-inline-start: cv.getVar('pin-input-gap');
62
+ }
63
+
64
+ // A div takes no `disabled`, so a disabled box is marked by class and drawn
65
+ // the way Bulma draws a disabled input.
66
+ .#{iv.$class-prefix}pin-input-box.#{iv.$class-prefix}is-disabled {
67
+ background-color: cv.getVar('input-disabled-background-color');
68
+ border-color: cv.getVar('input-disabled-border-color');
69
+ box-shadow: none;
70
+ color: cv.getVar('input-disabled-color');
71
+ }
72
+
73
+ // The caret, in the empty box at the input's caret. The box lays out its
74
+ // content in a centered row, so the caret sits in the middle.
75
+ .#{iv.$class-prefix}pin-input-box.#{iv.$class-prefix}has-caret::after {
76
+ animation: #{iv.$class-prefix}pin-input-caret-blink
77
+ cv.getVar('pin-input-caret-blink-duration') step-end infinite;
78
+ background-color: cv.getVar('pin-input-caret-color');
79
+ content: '';
80
+ height: cv.getVar('pin-input-caret-height');
81
+ width: cv.getVar('pin-input-caret-width');
82
+ }
83
+
84
+ @keyframes #{iv.$class-prefix}pin-input-caret-blink {
85
+ 50% {
86
+ opacity: 0;
87
+ }
88
+ }
89
+
90
+ // The input that holds the code, over the whole row. Its text is squeezed
91
+ // to the row's start, so a click anywhere on the row puts the caret at the
92
+ // end of the code, and the arrow keys move it from there. Its font is never
93
+ // under 16px, since iOS zooms the page into a field with smaller text when
94
+ // it takes focus.
95
+ .#{iv.$class-prefix}pin-input-field {
96
+ appearance: none;
97
+ background: transparent;
98
+ border: 0;
99
+ box-shadow: none;
100
+ caret-color: transparent;
101
+ color: transparent;
102
+ cursor: text;
103
+ font-family: monospace;
104
+ font-size: max(1em, 16px);
105
+ height: 100%;
106
+ left: 0;
107
+ letter-spacing: -0.5em;
108
+ line-height: 1;
109
+ margin: 0;
110
+ outline: 0;
111
+ padding: 0;
112
+ position: absolute;
113
+ top: 0;
114
+ width: 100%;
115
+ z-index: 1;
116
+
117
+ &::selection {
118
+ background-color: transparent;
119
+ color: transparent;
120
+ }
121
+
122
+ &::placeholder {
123
+ color: transparent;
124
+ }
125
+
126
+ &:disabled {
127
+ cursor: not-allowed;
128
+ }
129
+ }
130
+
131
+ // Autofill paints a fill and text of its own on the input. The boxes show
132
+ // the code, so the input hides instead. One rule each, since a browser
133
+ // drops a whole rule over a selector it doesn't know.
134
+ .#{iv.$class-prefix}pin-input-field:-webkit-autofill {
135
+ opacity: 0;
136
+ }
137
+
138
+ .#{iv.$class-prefix}pin-input-field:autofill {
139
+ opacity: 0;
140
+ }
141
+
142
+ @media (prefers-reduced-motion: reduce) {
143
+ .#{iv.$class-prefix}pin-input-box.#{iv.$class-prefix}has-caret::after {
144
+ animation: none;
145
+ }
146
+ }
147
+
148
+ @media (forced-colors: active) {
149
+ // Forced colors would paint the input's transparent text and caret in the
150
+ // text color, over the boxes, so it keeps its own.
151
+ .#{iv.$class-prefix}pin-input-field {
152
+ forced-color-adjust: none;
153
+ }
154
+
155
+ // Forced colors drops Bulma's focus ring, which is a shadow, so the box
156
+ // at the caret, and each selected one, gets an outline in the system's
157
+ // Highlight color. Three classes, to outrank Bulma's `.input.is-focused`
158
+ // border whichever stylesheet loads first.
159
+ .#{iv.$class-prefix}pin-input
160
+ > .#{iv.$class-prefix}pin-input-box.#{iv.$class-prefix}is-focused {
161
+ border-color: Highlight;
162
+ outline: 2px solid Highlight;
163
+ }
164
+
165
+ // The caret is a fill, which forced colors would make the background.
166
+ .#{iv.$class-prefix}pin-input-box.#{iv.$class-prefix}has-caret::after {
167
+ background-color: CanvasText;
168
+ forced-color-adjust: none;
169
+ }
170
+
171
+ .#{iv.$class-prefix}pin-input-box.#{iv.$class-prefix}is-disabled {
172
+ border-color: GrayText;
173
+ color: GrayText;
174
+ }
175
+ }