@vastare/fundatio 0.1.0 → 1.0.1

package/README.md

@@ -1,84 +1,351 @@
-# Fundatio
+# @vastare/fundatio
 
-**Version:** 1.0.0  
-**Distribution:** NPM  
-**Purpose:** Design Foundation / CSS Architecture Layer
+**Version:** 1.0.1  
+**Distribution:** npm  
+**Purpose:** Shared design foundation for Vastare projects
 
-Fundatio is a structured Sass design foundation providing a stable, production‑grade token, theme,
-and variable emission system.
+`@vastare/fundatio` is the canonical foundation package for Vastare front-end systems. It provides:
+
+- design tokens and theme primitives
+- typography and bundled font contracts
+- CSS variable emission mixins
+- Bootstrap 5 integration through the Fundatio adapter
+- typed DOM element helpers for runtime-enhanced UI work
+- a shared baseline for WordPress themes, Vite applications, and other web builds
+
+This package is intended to be consumed as a real upstream dependency. The examples below use the
+**actual published package name** and the **1.0.1 release surface**.
 
 ---
 
 ## Installation
 
 ```bash
-npm install fundatio
+npm install @vastare/fundatio
+```
+
+For a theme or application that compiles Sass directly from source, also ensure you have the
+expected peer toolchain in place, typically including:
+
+- `sass`
+- `bootstrap`
+- `vite` or your build tool of choice
+- `postcss` and `autoprefixer` when relevant
+
+---
+
+## Package entry points
+
+### JavaScript / TypeScript root
+
+```ts
+import { fundatioVersion, elements, tailwind } from '@vastare/fundatio';
+
+console.log(fundatioVersion);
 ```
 
+The root entry exposes:
+
+- `fundatioVersion`
+- `elements`
+- `tailwind`
+
+### CSS entry points
+
+Prebuilt CSS is available when you want the compiled output directly:
+
+```ts
+import '@vastare/fundatio/css';
+import '@vastare/fundatio/css/core';
+import '@vastare/fundatio/css/main';
+```
+
+### Sass entry points
+
+Fundatio is primarily designed to be consumed through Sass modules.
+
+```scss
+@use '@vastare/fundatio/scss';
+@use '@vastare/fundatio/scss/tokens/theme' as theme;
+@use '@vastare/fundatio/scss/mixins/theme' as theme-mx;
+@use '@vastare/fundatio/scss/mixins/fonts' as font-mx;
+```
+
+Useful public Sass entry points include:
+
+- `@vastare/fundatio/scss`
+- `@vastare/fundatio/scss/functions`
+- `@vastare/fundatio/scss/mixins`
+- `@vastare/fundatio/scss/tokens`
+- `@vastare/fundatio/scss/maps`
+- `@vastare/fundatio/scss/tokens/theme`
+- `@vastare/fundatio/scss/adapters/bootstrap/v5`
+
+### Bootstrap 5 adapter
+
+```scss
+@use '@vastare/fundatio/scss/adapters/bootstrap/v5' with (
+  $vs-bootstrap-baseline: core
+);
+```
+
+Supported baseline values:
+
+- `none` : Bootstrap only
+- `core` : Fundatio core + Bootstrap
+- `main` : Fundatio main baseline + Bootstrap
+
 ---
 
-## Entry Points
+## Theme tokens and CSS variable emission
 
-### Core Theme Root
+### Emit all theme variables
 
 ```scss
-@use 'fundatio/mixins/theme' as theme;
+@use '@vastare/fundatio/scss/mixins/theme' as theme-mx;
 
 :root {
-  @include theme.theme-root-vars();
+  @include theme-mx.theme-root-vars();
 }
 ```
 
-### Scoped Theme Example
+### Emit a single group
 
 ```scss
-[data-theme='dark'] {
-  @include theme.theme-root-vars();
+@use '@vastare/fundatio/scss/mixins/theme' as theme-mx;
+
+:root {
+  @include theme-mx.theme-group-vars('brand-colours');
 }
 ```
 
+### Override theme primitives
+
+```scss
+@use '@vastare/fundatio/scss/tokens/theme' with (
+  $theme-prefix: 'vastsite-',
+  $primary-colour: #233b4e,
+  $secondary-colour: #00bcd4,
+  $tertiary-colour: #4b3869
+);
+```
+
+The theme token layer is the consumer override surface. Downstream maps, functions, and mixins read
+from it and should not be patched directly unless you are deliberately extending Fundatio itself.
+
 ---
 
 ## Fonts
 
-### Default Behaviour
+### Default font contract
 
-Fundatio ships with:
+Fundatio ships with these bundled defaults:
 
-- Base font: **Merriweather**
-- Heading font: **Montserrat**
-- Default packaged format: **TTF**
+- **Base font:** Merriweather
+- **Heading font:** Montserrat
+- **Code font:** `ui-monospace`
+- **Default packaged font format:** `ttf`
 
-### Overriding Font Format
+### Override the packaged font format
+
+Fundatio no longer relies on bundled fallback source stacks. The active packaged format is
+controlled by a single overrideable token.
 
 ```scss
-@use 'fundatio/tokens/theme' with (
+@use '@vastare/fundatio/scss/tokens/theme' with (
   $font-package-format: 'woff2'
 );
 ```
 
-### Overriding Base Font
+That token controls the emitted source extension for the packaged contract.
+
+### Override font families
+
+```scss
+@use '@vastare/fundatio/scss/tokens/theme' with (
+  $base-font: 'Custom Serif',
+  $heading-font: 'Custom Sans'
+);
+```
+
+### Emit `@font-face` rules
+
+```scss
+@use '@vastare/fundatio/scss/mixins/fonts' as font-mx;
+
+@include font-mx.font-group-faces('base');
+@include font-mx.font-group-faces('headings');
+```
+
+or all groups:
+
+```scss
+@use '@vastare/fundatio/scss/mixins/fonts' as font-mx;
+
+@include font-mx.font-faces();
+```
+
+### Font asset paths in real builds
+
+This matters, because build tools love pretending asset paths are obvious when they absolutely are
+not.
+
+Fundatio emits font URLs using the configurable theme token:
+
+```scss
+$base-font-path
+```
+
+Default:
+
+```scss
+'../assets/fonts'
+```
+
+That default is intentionally conservative and works best when the consuming project copies the
+Fundatio font assets into its own build output.
+
+#### Recommended approach for Vite / WordPress themes
+
+1. Copy the package font assets into your project-owned public or dist asset directory.
+2. Override `$base-font-path` to the path your final CSS should use at runtime.
+
+Example:
+
+```scss
+@use '@vastare/fundatio/scss/tokens/theme' with (
+  $base-font-path: '../assets/fonts'
+);
+```
+
+If your build emits CSS somewhere else, set the path accordingly:
 
 ```scss
-@use 'fundatio/tokens/theme' with (
-  $base-font: 'Custom Serif'
+@use '@vastare/fundatio/scss/tokens/theme' with (
+  $base-font-path: '/wp-content/themes/vastsite/dist/assets/fonts'
 );
 ```
 
+#### Why this is explicit now
+
+Bundlers such as Vite cannot safely guess your deployment structure for self-hosted font assets
+inside a WordPress theme, library consumer app, or multi-stage CI pipeline. Fundatio therefore
+treats the font base path as a **consumer-controlled deployment concern** rather than hiding it
+behind brittle magic.
+
+That keeps the package predictable across:
+
+- Vite applications
+- WordPress themes
+- static site builds
+- other self-hosted pipelines
+
 ---
 
-## Versioning
+## Bootstrap adapter notes
 
-Fundatio follows semantic versioning.
+Fundatio's Bootstrap adapter exists to provide a stable Bootstrap 5 composition point while still
+allowing Fundatio tokens and baselines to participate in the build.
+
+```scss
+@use '@vastare/fundatio/scss/adapters/bootstrap/v5' with (
+  $vs-bootstrap-baseline: main
+);
+```
+
+### About Sass deprecation warnings
+
+Bootstrap 5 still depends on legacy Sass import-era patterns internally. Because Bootstrap's
+variable configuration model is still based on that pipeline, Fundatio maintains a minimal
+compatibility bridge in the adapter.
+
+In practice this means:
+
+- Fundatio keeps its own Sass modules modern where it can
+- Bootstrap-originated Sass warnings may still appear until Bootstrap fully modernises upstream
+- those upstream warnings are not the same thing as Fundatio having an invalid public API
+
+If you are auditing warnings in CI, separate:
+
+- **Fundatio-owned warnings**
+- **Bootstrap upstream warnings**
+
+That distinction saves a lot of pointless suffering.
+
+---
+
+## Real-world Vite + WordPress integration example
 
-- 1.x.x — stable public API
-- 0.x.x — internal evolution
+```scss
+@use '@vastare/fundatio/scss/tokens/theme' with (
+  $theme-prefix: 'vastsite-',
+  $base-font-path: '../assets/fonts',
+  $primary-colour: #233b4e,
+  $secondary-colour: #00bcd4,
+  $tertiary-colour: #4b3869
+);
+
+@use '@vastare/fundatio/scss/adapters/bootstrap/v5' with (
+  $vs-bootstrap-baseline: core
+);
+
+@use '@vastare/fundatio/scss/mixins/theme' as theme-mx;
+@use '@vastare/fundatio/scss/mixins/fonts' as font-mx;
+
+:root {
+  @include theme-mx.theme-root-vars();
+}
+
+@include font-mx.font-faces();
+```
 
 ---
 
-## Release
+## Public API notes
+
+### Version export
+
+```ts
+import { fundatioVersion } from '@vastare/fundatio';
+```
+
+### Elements namespace
+
+```ts
+import { elements } from '@vastare/fundatio';
+```
+
+### Tailwind adapter namespace
+
+```ts
+import { tailwind } from '@vastare/fundatio';
+```
+
+Fundatio's public surface should be treated as intentional. Internal naming leftovers should not be
+relied upon for new integrations.
+
+---
+
+## Versioning and release discipline
+
+Fundatio follows semantic versioning.
+
+- `1.x` is the stable public package line
+- `1.0.1` is the current release represented by this repository snapshot
+
+For releases, keep these aligned every single time:
+
+- `package.json`
+- git tag
+- npm publish version
+- README examples and metadata
+
+Because breaking your consumers with version drift is a spectacularly boring way to lose trust.
+
+---
 
-This documentation corresponds to:
+## Release metadata
 
-**Fundatio v1.0.0**  
-Generated: 2026-04-02T21:09:50.423742Z
+- **Package:** `@vastare/fundatio`
+- **Release:** `1.0.1`
+- **README target:** production consumer usage

package/dist/cjs/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./chunks/index.cjs");function t(n){return`rgb(var(${n}) / <alpha-value>)`}function e(n){return`--Fundatio-colour-${n}-rgb`}function l(n){return{50:t(e(`${n}-tint-90`)),100:t(e(`${n}-tint-80`)),200:t(e(`${n}-tint-70`)),300:t(e(`${n}-tint-60`)),500:t(e(`${n}-base`)),600:t(e(`${n}-shade-10`)),700:t(e(`${n}-shade-20`)),800:t(e(`${n}-shade-30`)),900:t(e(`${n}-shade-40`))}}function a(){const n=["grey","blue","indigo","purple","pink","red","orange","yellow","green","teal"],i={Fundatio:{0:t("--Fundatio-colour-black-rgb"),1e3:t("--Fundatio-colour-white-rgb")}};for(const o of n)i[o]=l(o);return i}const s={theme:{extend:{colors:a()}}};function u(n){return typeof n=="object"&&n!==null}async function d(){let n;try{n=await Promise.resolve().then(()=>require("./chunks/fundatio.cjs"))}catch{throw new Error('Tailwind is not installed. Install "tailwindcss" to use solTailwindPlugin.')}const i=u(n)&&"default"in n?n.default:n;if(typeof i!="function")throw new Error('"tailwindcss/plugin" did not export a plugin factory function as expected.');return i}async function c(){return(await d())(({addUtilities:i})=>{i({".Fundatio-example":{fontSize:"1rem"}})})}const f=Object.freeze(Object.defineProperty({__proto__:null,solTailwindPlugin:c,solTailwindPreset:s},Symbol.toStringTag,{value:"Module"})),g="1.0.0";exports.elements=r.index;exports.solVersion=g;exports.tailwind=f;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./chunks/index.cjs");function t(n){return`rgb(var(${n}) / <alpha-value>)`}function e(n){return`--Fundatio-colour-${n}-rgb`}function l(n){return{50:t(e(`${n}-tint-90`)),100:t(e(`${n}-tint-80`)),200:t(e(`${n}-tint-70`)),300:t(e(`${n}-tint-60`)),500:t(e(`${n}-base`)),600:t(e(`${n}-shade-10`)),700:t(e(`${n}-shade-20`)),800:t(e(`${n}-shade-30`)),900:t(e(`${n}-shade-40`))}}function a(){const n=["grey","blue","indigo","purple","pink","red","orange","yellow","green","teal"],i={Fundatio:{0:t("--Fundatio-colour-black-rgb"),1e3:t("--Fundatio-colour-white-rgb")}};for(const o of n)i[o]=l(o);return i}const s={theme:{extend:{colors:a()}}};function u(n){return typeof n=="object"&&n!==null}async function d(){let n;try{n=await Promise.resolve().then(()=>require("./chunks/fundatio.cjs"))}catch{throw new Error('Tailwind is not installed. Install "tailwindcss" to use solTailwindPlugin.')}const i=u(n)&&"default"in n?n.default:n;if(typeof i!="function")throw new Error('"tailwindcss/plugin" did not export a plugin factory function as expected.');return i}async function c(){return(await d())(({addUtilities:i})=>{i({".Fundatio-example":{fontSize:"1rem"}})})}const f=Object.freeze(Object.defineProperty({__proto__:null,solTailwindPlugin:c,solTailwindPreset:s},Symbol.toStringTag,{value:"Module"})),g="1.0.1";exports.elements=r.index;exports.fundatioVersion=g;exports.tailwind=f;
 //# sourceMappingURL=index.cjs.map

package/dist/cjs/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../src/ts/adapters/tailwind/v4/preset.ts","../../src/ts/adapters/tailwind/v4/plugin.ts","../../src/index.ts"],"sourcesContent":["/**\n * Fundatio Tailwind preset.\n *\n * This intentionally:\n * - does NOT import Tailwind at runtime (so it can be used as a plain object)\n * - maps Fundatio CSS variables to Tailwind theme tokens\n */\n\nexport type SolTailwindPreset = {\n  theme?: Record<string, unknown>;\n};\n\ntype TailwindColours = Record<string, Record<string, string>>;\n\nfunction rgbaVar(varName: string): string {\n  // Tailwind supports the <alpha-value> placeholder for arbitrary alpha.\n  return `rgb(var(${varName}) / <alpha-value>)`;\n}\n\nfunction solColourVarRgb(token: string): string {\n  return `--Fundatio-colour-${token}-rgb`;\n}\n\nfunction makeSolColourScale(colourName: string): Record<string, string> {\n  // Fundatio defines: tint-90/80/70/60 + base + shade-10/20/30/40.\n  // Map to Tailwind's 50..900 scale.\n  return {\n    '50': rgbaVar(solColourVarRgb(`${colourName}-tint-90`)),\n    '100': rgbaVar(solColourVarRgb(`${colourName}-tint-80`)),\n    '200': rgbaVar(solColourVarRgb(`${colourName}-tint-70`)),\n    '300': rgbaVar(solColourVarRgb(`${colourName}-tint-60`)),\n    '500': rgbaVar(solColourVarRgb(`${colourName}-base`)),\n    '600': rgbaVar(solColourVarRgb(`${colourName}-shade-10`)),\n    '700': rgbaVar(solColourVarRgb(`${colourName}-shade-20`)),\n    '800': rgbaVar(solColourVarRgb(`${colourName}-shade-30`)),\n    '900': rgbaVar(solColourVarRgb(`${colourName}-shade-40`)),\n  };\n}\n\nfunction makeSolColours(): TailwindColours {\n  const names = [\n    'grey',\n    'blue',\n    'indigo',\n    'purple',\n    'pink',\n    'red',\n    'orange',\n    'yellow',\n    'green',\n    'teal',\n  ];\n\n  const colours: TailwindColours = {\n    // Convenience accessors.\n    Fundatio: {\n      '0': rgbaVar('--Fundatio-colour-black-rgb'),\n      '1000': rgbaVar('--Fundatio-colour-white-rgb'),\n    },\n  };\n\n  for (const name of names) {\n    colours[name] = makeSolColourScale(name);\n  }\n\n  return colours;\n}\n\nexport const solTailwindPreset: SolTailwindPreset = {\n  theme: {\n    extend: {\n      colors: makeSolColours(),\n    },\n  },\n};\n","export type PluginApi = {\n  addUtilities: (utilities: Record<string, Record<string, string>>) => void;\n  theme: (path: string) => unknown;\n};\n\ntype TailwindPluginFactory = (handler: (api: PluginApi) => void) => unknown;\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\nasync function loadTailwindPluginFactory(): Promise<TailwindPluginFactory> {\n  let mod: unknown;\n\n  try {\n    // Dynamic import keeps Tailwind as an optional peer dependency.\n    mod = (await import('tailwindcss/plugin')) as unknown;\n  } catch {\n    throw new Error('Tailwind is not installed. Install \"tailwindcss\" to use solTailwindPlugin.');\n  }\n\n  // Handle both CJS and ESM default export shapes.\n  const candidate: unknown = isRecord(mod) && 'default' in mod ? mod.default : mod;\n\n  if (typeof candidate !== 'function') {\n    throw new Error('\"tailwindcss/plugin\" did not export a plugin factory function as expected.');\n  }\n\n  return candidate as TailwindPluginFactory;\n}\n\n/**\n * Returns the Fundatio Tailwind plugin.\n *\n * Note: this is async so Tailwind can remain an optional peer dependency.\n */\nexport async function solTailwindPlugin(): Promise<unknown> {\n  const plugin = await loadTailwindPluginFactory();\n\n  return plugin(({ addUtilities }: PluginApi) => {\n    addUtilities({\n      '.Fundatio-example': {\n        fontSize: '1rem',\n      },\n    });\n  });\n}\n","export * as elements from './elements';\nexport * as tailwind from './ts/adapters/tailwind/v4';\n\nexport const solVersion = '1.0.0';\n"],"names":["rgbaVar","varName","solColourVarRgb","token","makeSolColourScale","colourName","makeSolColours","names","colours","name","solTailwindPreset","isRecord","value","loadTailwindPluginFactory","mod","candidate","solTailwindPlugin","addUtilities","solVersion"],"mappings":"sHAcA,SAASA,EAAQC,EAAyB,CAExC,MAAO,WAAWA,CAAO,oBAC3B,CAEA,SAASC,EAAgBC,EAAuB,CAC9C,MAAO,qBAAqBA,CAAK,MACnC,CAEA,SAASC,EAAmBC,EAA4C,CAGtE,MAAO,CACL,GAAML,EAAQE,EAAgB,GAAGG,CAAU,UAAU,CAAC,EACtD,IAAOL,EAAQE,EAAgB,GAAGG,CAAU,UAAU,CAAC,EACvD,IAAOL,EAAQE,EAAgB,GAAGG,CAAU,UAAU,CAAC,EACvD,IAAOL,EAAQE,EAAgB,GAAGG,CAAU,UAAU,CAAC,EACvD,IAAOL,EAAQE,EAAgB,GAAGG,CAAU,OAAO,CAAC,EACpD,IAAOL,EAAQE,EAAgB,GAAGG,CAAU,WAAW,CAAC,EACxD,IAAOL,EAAQE,EAAgB,GAAGG,CAAU,WAAW,CAAC,EACxD,IAAOL,EAAQE,EAAgB,GAAGG,CAAU,WAAW,CAAC,EACxD,IAAOL,EAAQE,EAAgB,GAAGG,CAAU,WAAW,CAAC,CAAA,CAE5D,CAEA,SAASC,GAAkC,CACzC,MAAMC,EAAQ,CACZ,OACA,OACA,SACA,SACA,OACA,MACA,SACA,SACA,QACA,MAAA,EAGIC,EAA2B,CAE/B,SAAU,CACR,EAAKR,EAAQ,6BAA6B,EAC1C,IAAQA,EAAQ,6BAA6B,CAAA,CAC/C,EAGF,UAAWS,KAAQF,EACjBC,EAAQC,CAAI,EAAIL,EAAmBK,CAAI,EAGzC,OAAOD,CACT,CAEO,MAAME,EAAuC,CAClD,MAAO,CACL,OAAQ,CACN,OAAQJ,EAAA,CAAe,CACzB,CAEJ,ECnEA,SAASK,EAASC,EAAkD,CAClE,OAAO,OAAOA,GAAU,UAAYA,IAAU,IAChD,CAEA,eAAeC,GAA4D,CACzE,IAAIC,EAEJ,GAAI,CAEFA,EAAO,MAAM,QAAA,QAAA,EAAA,KAAA,IAAA,QAAO,uBAAoB,CAAA,CAC1C,MAAQ,CACN,MAAM,IAAI,MAAM,4EAA4E,CAC9F,CAGA,MAAMC,EAAqBJ,EAASG,CAAG,GAAK,YAAaA,EAAMA,EAAI,QAAUA,EAE7E,GAAI,OAAOC,GAAc,WACvB,MAAM,IAAI,MAAM,4EAA4E,EAG9F,OAAOA,CACT,CAOA,eAAsBC,GAAsC,CAG1D,OAFe,MAAMH,EAAA,GAEP,CAAC,CAAE,aAAAI,KAA8B,CAC7CA,EAAa,CACX,oBAAqB,CACnB,SAAU,MAAA,CACZ,CACD,CACH,CAAC,CACH,4IC3CaC,EAAa"}
+{"version":3,"file":"index.cjs","sources":["../../src/ts/adapters/tailwind/v4/preset.ts","../../src/ts/adapters/tailwind/v4/plugin.ts","../../src/index.ts"],"sourcesContent":["/**\n * Fundatio Tailwind preset.\n *\n * This intentionally:\n * - does NOT import Tailwind at runtime (so it can be used as a plain object)\n * - maps Fundatio CSS variables to Tailwind theme tokens\n */\n\nexport type SolTailwindPreset = {\n  theme?: Record<string, unknown>;\n};\n\ntype TailwindColours = Record<string, Record<string, string>>;\n\nfunction rgbaVar(varName: string): string {\n  // Tailwind supports the <alpha-value> placeholder for arbitrary alpha.\n  return `rgb(var(${varName}) / <alpha-value>)`;\n}\n\nfunction solColourVarRgb(token: string): string {\n  return `--Fundatio-colour-${token}-rgb`;\n}\n\nfunction makeSolColourScale(colourName: string): Record<string, string> {\n  // Fundatio defines: tint-90/80/70/60 + base + shade-10/20/30/40.\n  // Map to Tailwind's 50..900 scale.\n  return {\n    '50': rgbaVar(solColourVarRgb(`${colourName}-tint-90`)),\n    '100': rgbaVar(solColourVarRgb(`${colourName}-tint-80`)),\n    '200': rgbaVar(solColourVarRgb(`${colourName}-tint-70`)),\n    '300': rgbaVar(solColourVarRgb(`${colourName}-tint-60`)),\n    '500': rgbaVar(solColourVarRgb(`${colourName}-base`)),\n    '600': rgbaVar(solColourVarRgb(`${colourName}-shade-10`)),\n    '700': rgbaVar(solColourVarRgb(`${colourName}-shade-20`)),\n    '800': rgbaVar(solColourVarRgb(`${colourName}-shade-30`)),\n    '900': rgbaVar(solColourVarRgb(`${colourName}-shade-40`)),\n  };\n}\n\nfunction makeSolColours(): TailwindColours {\n  const names = [\n    'grey',\n    'blue',\n    'indigo',\n    'purple',\n    'pink',\n    'red',\n    'orange',\n    'yellow',\n    'green',\n    'teal',\n  ];\n\n  const colours: TailwindColours = {\n    // Convenience accessors.\n    Fundatio: {\n      '0': rgbaVar('--Fundatio-colour-black-rgb'),\n      '1000': rgbaVar('--Fundatio-colour-white-rgb'),\n    },\n  };\n\n  for (const name of names) {\n    colours[name] = makeSolColourScale(name);\n  }\n\n  return colours;\n}\n\nexport const solTailwindPreset: SolTailwindPreset = {\n  theme: {\n    extend: {\n      colors: makeSolColours(),\n    },\n  },\n};\n","export type PluginApi = {\n  addUtilities: (utilities: Record<string, Record<string, string>>) => void;\n  theme: (path: string) => unknown;\n};\n\ntype TailwindPluginFactory = (handler: (api: PluginApi) => void) => unknown;\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\nasync function loadTailwindPluginFactory(): Promise<TailwindPluginFactory> {\n  let mod: unknown;\n\n  try {\n    // Dynamic import keeps Tailwind as an optional peer dependency.\n    mod = (await import('tailwindcss/plugin')) as unknown;\n  } catch {\n    throw new Error('Tailwind is not installed. Install \"tailwindcss\" to use solTailwindPlugin.');\n  }\n\n  // Handle both CJS and ESM default export shapes.\n  const candidate: unknown = isRecord(mod) && 'default' in mod ? mod.default : mod;\n\n  if (typeof candidate !== 'function') {\n    throw new Error('\"tailwindcss/plugin\" did not export a plugin factory function as expected.');\n  }\n\n  return candidate as TailwindPluginFactory;\n}\n\n/**\n * Returns the Fundatio Tailwind plugin.\n *\n * Note: this is async so Tailwind can remain an optional peer dependency.\n */\nexport async function solTailwindPlugin(): Promise<unknown> {\n  const plugin = await loadTailwindPluginFactory();\n\n  return plugin(({ addUtilities }: PluginApi) => {\n    addUtilities({\n      '.Fundatio-example': {\n        fontSize: '1rem',\n      },\n    });\n  });\n}\n","export * as elements from './elements';\nexport * as tailwind from './ts/adapters/tailwind/v4';\n\n/**\n * Canonical package version.\n */\nexport const fundatioVersion: string = '1.0.1';\n"],"names":["rgbaVar","varName","solColourVarRgb","token","makeSolColourScale","colourName","makeSolColours","names","colours","name","solTailwindPreset","isRecord","value","loadTailwindPluginFactory","mod","candidate","solTailwindPlugin","addUtilities","fundatioVersion"],"mappings":"sHAcA,SAASA,EAAQC,EAAyB,CAExC,MAAO,WAAWA,CAAO,oBAC3B,CAEA,SAASC,EAAgBC,EAAuB,CAC9C,MAAO,qBAAqBA,CAAK,MACnC,CAEA,SAASC,EAAmBC,EAA4C,CAGtE,MAAO,CACL,GAAML,EAAQE,EAAgB,GAAGG,CAAU,UAAU,CAAC,EACtD,IAAOL,EAAQE,EAAgB,GAAGG,CAAU,UAAU,CAAC,EACvD,IAAOL,EAAQE,EAAgB,GAAGG,CAAU,UAAU,CAAC,EACvD,IAAOL,EAAQE,EAAgB,GAAGG,CAAU,UAAU,CAAC,EACvD,IAAOL,EAAQE,EAAgB,GAAGG,CAAU,OAAO,CAAC,EACpD,IAAOL,EAAQE,EAAgB,GAAGG,CAAU,WAAW,CAAC,EACxD,IAAOL,EAAQE,EAAgB,GAAGG,CAAU,WAAW,CAAC,EACxD,IAAOL,EAAQE,EAAgB,GAAGG,CAAU,WAAW,CAAC,EACxD,IAAOL,EAAQE,EAAgB,GAAGG,CAAU,WAAW,CAAC,CAAA,CAE5D,CAEA,SAASC,GAAkC,CACzC,MAAMC,EAAQ,CACZ,OACA,OACA,SACA,SACA,OACA,MACA,SACA,SACA,QACA,MAAA,EAGIC,EAA2B,CAE/B,SAAU,CACR,EAAKR,EAAQ,6BAA6B,EAC1C,IAAQA,EAAQ,6BAA6B,CAAA,CAC/C,EAGF,UAAWS,KAAQF,EACjBC,EAAQC,CAAI,EAAIL,EAAmBK,CAAI,EAGzC,OAAOD,CACT,CAEO,MAAME,EAAuC,CAClD,MAAO,CACL,OAAQ,CACN,OAAQJ,EAAA,CAAe,CACzB,CAEJ,ECnEA,SAASK,EAASC,EAAkD,CAClE,OAAO,OAAOA,GAAU,UAAYA,IAAU,IAChD,CAEA,eAAeC,GAA4D,CACzE,IAAIC,EAEJ,GAAI,CAEFA,EAAO,MAAM,QAAA,QAAA,EAAA,KAAA,IAAA,QAAO,uBAAoB,CAAA,CAC1C,MAAQ,CACN,MAAM,IAAI,MAAM,4EAA4E,CAC9F,CAGA,MAAMC,EAAqBJ,EAASG,CAAG,GAAK,YAAaA,EAAMA,EAAI,QAAUA,EAE7E,GAAI,OAAOC,GAAc,WACvB,MAAM,IAAI,MAAM,4EAA4E,EAG9F,OAAOA,CACT,CAOA,eAAsBC,GAAsC,CAG1D,OAFe,MAAMH,EAAA,GAEP,CAAC,CAAE,aAAAI,KAA8B,CAC7CA,EAAa,CACX,oBAAqB,CACnB,SAAU,MAAA,CACZ,CACD,CACH,CAAC,CACH,4ICxCaC,EAA0B"}

package/dist/esm/index.js

@@ -30,16 +30,16 @@ function a() {
     "yellow",
     "green",
     "teal"
-  ], o = {
+  ], i = {
     // Convenience accessors.
     Fundatio: {
       0: t("--Fundatio-colour-black-rgb"),
       1e3: t("--Fundatio-colour-white-rgb")
     }
   };
-  for (const i of n)
-    o[i] = r(i);
-  return o;
+  for (const o of n)
+    i[o] = r(o);
+  return i;
 }
 const l = {
   theme: {
@@ -58,14 +58,14 @@ async function u() {
   } catch {
     throw new Error('Tailwind is not installed. Install "tailwindcss" to use solTailwindPlugin.');
   }
-  const o = s(n) && "default" in n ? n.default : n;
-  if (typeof o != "function")
+  const i = s(n) && "default" in n ? n.default : n;
+  if (typeof i != "function")
     throw new Error('"tailwindcss/plugin" did not export a plugin factory function as expected.');
-  return o;
+  return i;
 }
 async function d() {
-  return (await u())(({ addUtilities: o }) => {
-    o({
+  return (await u())(({ addUtilities: i }) => {
+    i({
       ".Fundatio-example": {
         fontSize: "1rem"
       }
@@ -76,10 +76,10 @@ const c = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   solTailwindPlugin: d,
   solTailwindPreset: l
-}, Symbol.toStringTag, { value: "Module" })), f = "1.0.0";
+}, Symbol.toStringTag, { value: "Module" })), f = "1.0.1";
 export {
   w as elements,
-  f as solVersion,
+  f as fundatioVersion,
   c as tailwind
 };
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/ts/adapters/tailwind/v4/preset.ts","../../src/ts/adapters/tailwind/v4/plugin.ts","../../src/index.ts"],"sourcesContent":["/**\n * Fundatio Tailwind preset.\n *\n * This intentionally:\n * - does NOT import Tailwind at runtime (so it can be used as a plain object)\n * - maps Fundatio CSS variables to Tailwind theme tokens\n */\n\nexport type SolTailwindPreset = {\n  theme?: Record<string, unknown>;\n};\n\ntype TailwindColours = Record<string, Record<string, string>>;\n\nfunction rgbaVar(varName: string): string {\n  // Tailwind supports the <alpha-value> placeholder for arbitrary alpha.\n  return `rgb(var(${varName}) / <alpha-value>)`;\n}\n\nfunction solColourVarRgb(token: string): string {\n  return `--Fundatio-colour-${token}-rgb`;\n}\n\nfunction makeSolColourScale(colourName: string): Record<string, string> {\n  // Fundatio defines: tint-90/80/70/60 + base + shade-10/20/30/40.\n  // Map to Tailwind's 50..900 scale.\n  return {\n    '50': rgbaVar(solColourVarRgb(`${colourName}-tint-90`)),\n    '100': rgbaVar(solColourVarRgb(`${colourName}-tint-80`)),\n    '200': rgbaVar(solColourVarRgb(`${colourName}-tint-70`)),\n    '300': rgbaVar(solColourVarRgb(`${colourName}-tint-60`)),\n    '500': rgbaVar(solColourVarRgb(`${colourName}-base`)),\n    '600': rgbaVar(solColourVarRgb(`${colourName}-shade-10`)),\n    '700': rgbaVar(solColourVarRgb(`${colourName}-shade-20`)),\n    '800': rgbaVar(solColourVarRgb(`${colourName}-shade-30`)),\n    '900': rgbaVar(solColourVarRgb(`${colourName}-shade-40`)),\n  };\n}\n\nfunction makeSolColours(): TailwindColours {\n  const names = [\n    'grey',\n    'blue',\n    'indigo',\n    'purple',\n    'pink',\n    'red',\n    'orange',\n    'yellow',\n    'green',\n    'teal',\n  ];\n\n  const colours: TailwindColours = {\n    // Convenience accessors.\n    Fundatio: {\n      '0': rgbaVar('--Fundatio-colour-black-rgb'),\n      '1000': rgbaVar('--Fundatio-colour-white-rgb'),\n    },\n  };\n\n  for (const name of names) {\n    colours[name] = makeSolColourScale(name);\n  }\n\n  return colours;\n}\n\nexport const solTailwindPreset: SolTailwindPreset = {\n  theme: {\n    extend: {\n      colors: makeSolColours(),\n    },\n  },\n};\n","export type PluginApi = {\n  addUtilities: (utilities: Record<string, Record<string, string>>) => void;\n  theme: (path: string) => unknown;\n};\n\ntype TailwindPluginFactory = (handler: (api: PluginApi) => void) => unknown;\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\nasync function loadTailwindPluginFactory(): Promise<TailwindPluginFactory> {\n  let mod: unknown;\n\n  try {\n    // Dynamic import keeps Tailwind as an optional peer dependency.\n    mod = (await import('tailwindcss/plugin')) as unknown;\n  } catch {\n    throw new Error('Tailwind is not installed. Install \"tailwindcss\" to use solTailwindPlugin.');\n  }\n\n  // Handle both CJS and ESM default export shapes.\n  const candidate: unknown = isRecord(mod) && 'default' in mod ? mod.default : mod;\n\n  if (typeof candidate !== 'function') {\n    throw new Error('\"tailwindcss/plugin\" did not export a plugin factory function as expected.');\n  }\n\n  return candidate as TailwindPluginFactory;\n}\n\n/**\n * Returns the Fundatio Tailwind plugin.\n *\n * Note: this is async so Tailwind can remain an optional peer dependency.\n */\nexport async function solTailwindPlugin(): Promise<unknown> {\n  const plugin = await loadTailwindPluginFactory();\n\n  return plugin(({ addUtilities }: PluginApi) => {\n    addUtilities({\n      '.Fundatio-example': {\n        fontSize: '1rem',\n      },\n    });\n  });\n}\n","export * as elements from './elements';\nexport * as tailwind from './ts/adapters/tailwind/v4';\n\nexport const solVersion = '1.0.0';\n"],"names":["rgbaVar","varName","solColourVarRgb","token","makeSolColourScale","colourName","makeSolColours","names","colours","name","solTailwindPreset","isRecord","value","loadTailwindPluginFactory","mod","candidate","solTailwindPlugin","addUtilities","solVersion"],"mappings":";AAcA,SAASA,EAAQC,GAAyB;AAExC,SAAO,WAAWA,CAAO;AAC3B;AAEA,SAASC,EAAgBC,GAAuB;AAC9C,SAAO,qBAAqBA,CAAK;AACnC;AAEA,SAASC,EAAmBC,GAA4C;AAGtE,SAAO;AAAA,IACL,IAAML,EAAQE,EAAgB,GAAGG,CAAU,UAAU,CAAC;AAAA,IACtD,KAAOL,EAAQE,EAAgB,GAAGG,CAAU,UAAU,CAAC;AAAA,IACvD,KAAOL,EAAQE,EAAgB,GAAGG,CAAU,UAAU,CAAC;AAAA,IACvD,KAAOL,EAAQE,EAAgB,GAAGG,CAAU,UAAU,CAAC;AAAA,IACvD,KAAOL,EAAQE,EAAgB,GAAGG,CAAU,OAAO,CAAC;AAAA,IACpD,KAAOL,EAAQE,EAAgB,GAAGG,CAAU,WAAW,CAAC;AAAA,IACxD,KAAOL,EAAQE,EAAgB,GAAGG,CAAU,WAAW,CAAC;AAAA,IACxD,KAAOL,EAAQE,EAAgB,GAAGG,CAAU,WAAW,CAAC;AAAA,IACxD,KAAOL,EAAQE,EAAgB,GAAGG,CAAU,WAAW,CAAC;AAAA,EAAA;AAE5D;AAEA,SAASC,IAAkC;AACzC,QAAMC,IAAQ;AAAA,IACZ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA,GAGIC,IAA2B;AAAA;AAAA,IAE/B,UAAU;AAAA,MACR,GAAKR,EAAQ,6BAA6B;AAAA,MAC1C,KAAQA,EAAQ,6BAA6B;AAAA,IAAA;AAAA,EAC/C;AAGF,aAAWS,KAAQF;AACjB,IAAAC,EAAQC,CAAI,IAAIL,EAAmBK,CAAI;AAGzC,SAAOD;AACT;AAEO,MAAME,IAAuC;AAAA,EAClD,OAAO;AAAA,IACL,QAAQ;AAAA,MACN,QAAQJ,EAAA;AAAA,IAAe;AAAA,EACzB;AAEJ;ACnEA,SAASK,EAASC,GAAkD;AAClE,SAAO,OAAOA,KAAU,YAAYA,MAAU;AAChD;AAEA,eAAeC,IAA4D;AACzE,MAAIC;AAEJ,MAAI;AAEF,IAAAA,IAAO,MAAM,OAAO,sBAAoB;AAAA,EAC1C,QAAQ;AACN,UAAM,IAAI,MAAM,4EAA4E;AAAA,EAC9F;AAGA,QAAMC,IAAqBJ,EAASG,CAAG,KAAK,aAAaA,IAAMA,EAAI,UAAUA;AAE7E,MAAI,OAAOC,KAAc;AACvB,UAAM,IAAI,MAAM,4EAA4E;AAG9F,SAAOA;AACT;AAOA,eAAsBC,IAAsC;AAG1D,UAFe,MAAMH,EAAA,GAEP,CAAC,EAAE,cAAAI,QAA8B;AAC7C,IAAAA,EAAa;AAAA,MACX,qBAAqB;AAAA,QACnB,UAAU;AAAA,MAAA;AAAA,IACZ,CACD;AAAA,EACH,CAAC;AACH;;;;;8CC3CaC,IAAa;"}
+{"version":3,"file":"index.js","sources":["../../src/ts/adapters/tailwind/v4/preset.ts","../../src/ts/adapters/tailwind/v4/plugin.ts","../../src/index.ts"],"sourcesContent":["/**\n * Fundatio Tailwind preset.\n *\n * This intentionally:\n * - does NOT import Tailwind at runtime (so it can be used as a plain object)\n * - maps Fundatio CSS variables to Tailwind theme tokens\n */\n\nexport type SolTailwindPreset = {\n  theme?: Record<string, unknown>;\n};\n\ntype TailwindColours = Record<string, Record<string, string>>;\n\nfunction rgbaVar(varName: string): string {\n  // Tailwind supports the <alpha-value> placeholder for arbitrary alpha.\n  return `rgb(var(${varName}) / <alpha-value>)`;\n}\n\nfunction solColourVarRgb(token: string): string {\n  return `--Fundatio-colour-${token}-rgb`;\n}\n\nfunction makeSolColourScale(colourName: string): Record<string, string> {\n  // Fundatio defines: tint-90/80/70/60 + base + shade-10/20/30/40.\n  // Map to Tailwind's 50..900 scale.\n  return {\n    '50': rgbaVar(solColourVarRgb(`${colourName}-tint-90`)),\n    '100': rgbaVar(solColourVarRgb(`${colourName}-tint-80`)),\n    '200': rgbaVar(solColourVarRgb(`${colourName}-tint-70`)),\n    '300': rgbaVar(solColourVarRgb(`${colourName}-tint-60`)),\n    '500': rgbaVar(solColourVarRgb(`${colourName}-base`)),\n    '600': rgbaVar(solColourVarRgb(`${colourName}-shade-10`)),\n    '700': rgbaVar(solColourVarRgb(`${colourName}-shade-20`)),\n    '800': rgbaVar(solColourVarRgb(`${colourName}-shade-30`)),\n    '900': rgbaVar(solColourVarRgb(`${colourName}-shade-40`)),\n  };\n}\n\nfunction makeSolColours(): TailwindColours {\n  const names = [\n    'grey',\n    'blue',\n    'indigo',\n    'purple',\n    'pink',\n    'red',\n    'orange',\n    'yellow',\n    'green',\n    'teal',\n  ];\n\n  const colours: TailwindColours = {\n    // Convenience accessors.\n    Fundatio: {\n      '0': rgbaVar('--Fundatio-colour-black-rgb'),\n      '1000': rgbaVar('--Fundatio-colour-white-rgb'),\n    },\n  };\n\n  for (const name of names) {\n    colours[name] = makeSolColourScale(name);\n  }\n\n  return colours;\n}\n\nexport const solTailwindPreset: SolTailwindPreset = {\n  theme: {\n    extend: {\n      colors: makeSolColours(),\n    },\n  },\n};\n","export type PluginApi = {\n  addUtilities: (utilities: Record<string, Record<string, string>>) => void;\n  theme: (path: string) => unknown;\n};\n\ntype TailwindPluginFactory = (handler: (api: PluginApi) => void) => unknown;\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\nasync function loadTailwindPluginFactory(): Promise<TailwindPluginFactory> {\n  let mod: unknown;\n\n  try {\n    // Dynamic import keeps Tailwind as an optional peer dependency.\n    mod = (await import('tailwindcss/plugin')) as unknown;\n  } catch {\n    throw new Error('Tailwind is not installed. Install \"tailwindcss\" to use solTailwindPlugin.');\n  }\n\n  // Handle both CJS and ESM default export shapes.\n  const candidate: unknown = isRecord(mod) && 'default' in mod ? mod.default : mod;\n\n  if (typeof candidate !== 'function') {\n    throw new Error('\"tailwindcss/plugin\" did not export a plugin factory function as expected.');\n  }\n\n  return candidate as TailwindPluginFactory;\n}\n\n/**\n * Returns the Fundatio Tailwind plugin.\n *\n * Note: this is async so Tailwind can remain an optional peer dependency.\n */\nexport async function solTailwindPlugin(): Promise<unknown> {\n  const plugin = await loadTailwindPluginFactory();\n\n  return plugin(({ addUtilities }: PluginApi) => {\n    addUtilities({\n      '.Fundatio-example': {\n        fontSize: '1rem',\n      },\n    });\n  });\n}\n","export * as elements from './elements';\nexport * as tailwind from './ts/adapters/tailwind/v4';\n\n/**\n * Canonical package version.\n */\nexport const fundatioVersion: string = '1.0.1';\n"],"names":["rgbaVar","varName","solColourVarRgb","token","makeSolColourScale","colourName","makeSolColours","names","colours","name","solTailwindPreset","isRecord","value","loadTailwindPluginFactory","mod","candidate","solTailwindPlugin","addUtilities","fundatioVersion"],"mappings":";AAcA,SAASA,EAAQC,GAAyB;AAExC,SAAO,WAAWA,CAAO;AAC3B;AAEA,SAASC,EAAgBC,GAAuB;AAC9C,SAAO,qBAAqBA,CAAK;AACnC;AAEA,SAASC,EAAmBC,GAA4C;AAGtE,SAAO;AAAA,IACL,IAAML,EAAQE,EAAgB,GAAGG,CAAU,UAAU,CAAC;AAAA,IACtD,KAAOL,EAAQE,EAAgB,GAAGG,CAAU,UAAU,CAAC;AAAA,IACvD,KAAOL,EAAQE,EAAgB,GAAGG,CAAU,UAAU,CAAC;AAAA,IACvD,KAAOL,EAAQE,EAAgB,GAAGG,CAAU,UAAU,CAAC;AAAA,IACvD,KAAOL,EAAQE,EAAgB,GAAGG,CAAU,OAAO,CAAC;AAAA,IACpD,KAAOL,EAAQE,EAAgB,GAAGG,CAAU,WAAW,CAAC;AAAA,IACxD,KAAOL,EAAQE,EAAgB,GAAGG,CAAU,WAAW,CAAC;AAAA,IACxD,KAAOL,EAAQE,EAAgB,GAAGG,CAAU,WAAW,CAAC;AAAA,IACxD,KAAOL,EAAQE,EAAgB,GAAGG,CAAU,WAAW,CAAC;AAAA,EAAA;AAE5D;AAEA,SAASC,IAAkC;AACzC,QAAMC,IAAQ;AAAA,IACZ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA,GAGIC,IAA2B;AAAA;AAAA,IAE/B,UAAU;AAAA,MACR,GAAKR,EAAQ,6BAA6B;AAAA,MAC1C,KAAQA,EAAQ,6BAA6B;AAAA,IAAA;AAAA,EAC/C;AAGF,aAAWS,KAAQF;AACjB,IAAAC,EAAQC,CAAI,IAAIL,EAAmBK,CAAI;AAGzC,SAAOD;AACT;AAEO,MAAME,IAAuC;AAAA,EAClD,OAAO;AAAA,IACL,QAAQ;AAAA,MACN,QAAQJ,EAAA;AAAA,IAAe;AAAA,EACzB;AAEJ;ACnEA,SAASK,EAASC,GAAkD;AAClE,SAAO,OAAOA,KAAU,YAAYA,MAAU;AAChD;AAEA,eAAeC,IAA4D;AACzE,MAAIC;AAEJ,MAAI;AAEF,IAAAA,IAAO,MAAM,OAAO,sBAAoB;AAAA,EAC1C,QAAQ;AACN,UAAM,IAAI,MAAM,4EAA4E;AAAA,EAC9F;AAGA,QAAMC,IAAqBJ,EAASG,CAAG,KAAK,aAAaA,IAAMA,EAAI,UAAUA;AAE7E,MAAI,OAAOC,KAAc;AACvB,UAAM,IAAI,MAAM,4EAA4E;AAG9F,SAAOA;AACT;AAOA,eAAsBC,IAAsC;AAG1D,UAFe,MAAMH,EAAA,GAEP,CAAC,EAAE,cAAAI,QAA8B;AAC7C,IAAAA,EAAa;AAAA,MACX,qBAAqB;AAAA,QACnB,UAAU;AAAA,MAAA;AAAA,IACZ,CACD;AAAA,EACH,CAAC;AACH;;;;;8CCxCaC,IAA0B;"}

package/dist/types/index.d.ts

@@ -1,4 +1,7 @@
 export * as elements from './elements';
 export * as tailwind from './ts/adapters/tailwind/v4';
-export declare const solVersion = "1.0.0";
+/**
+ * Canonical package version.
+ */
+export declare const fundatioVersion: string;
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,QAAQ,MAAM,2BAA2B,CAAC;AAEtD,eAAO,MAAM,UAAU,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,QAAQ,MAAM,2BAA2B,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAgB,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vastare/fundatio",
-  "version": "0.1.0",
-  "description": "Framework agnostic design foundation for Vastare UI kits and applications.",
+  "version": "1.0.1",
+  "description": "Production-grade design foundation for Vastare themes, applications, and shared UI infrastructure.",
   "homepage": "https://github.com/vastaredev/fundatio#readme",
   "bugs": {
     "url": "https://github.com/vastaredev/fundatio/issues"
@@ -702,5 +702,18 @@
     "tailwindcss": {
       "optional": true
     }
-  }
+  },
+  "keywords": [
+    "vastare",
+    "design-system",
+    "design-tokens",
+    "sass",
+    "scss",
+    "bootstrap",
+    "vite",
+    "wordpress",
+    "typescript",
+    "foundation"
+  ],
+  "sass": "./src/scss/main.scss"
 }

package/src/scss/adapters/bootstrap/v5/index.scss

@@ -4,6 +4,10 @@
  * Provides a single SCSS entry for consuming Bootstrap v5, optionally composed
  * with a Fundatio baseline.
  *
+ * Bootstrap 5 still exposes its Sass customisation surface through legacy import-era
+ * globals. Fundatio therefore keeps the adapter bridge intentionally small and
+ * isolated here so the rest of the package can remain module-first.
+ *
  * Baseline options:
  * - none: Bootstrap only
  * - core: Fundatio core + Bootstrap
@@ -35,6 +39,8 @@ $_allowed-baselines: (none, core, main);
 
 /**
  * Bootstrap still relies on legacy global variable configuration via @import.
+ * Fundatio limits that legacy flow to this adapter because Bootstrap variable
+ * overrides are not yet exposed through a fully modern @use-based API upstream.
  * Dart Sass requires @use to appear before other rules, so these @imports must
  * come after @use.
  *

package/src/scss/tokens/_theme.scss

@@ -141,6 +141,18 @@ $dark-colour: colours.$grey-shade-80 !default;
  - Asset paths
  --------------------------------------------------------------------------- */
 
+/**
+ * Base runtime path used when emitting packaged font URLs.
+ *
+ * Consumers should override this to the final public path used by their own
+ * deployment target when copying Fundatio fonts into application-owned assets.
+ *
+ * Examples:
+ * - '../assets/fonts' for a theme/app-local dist structure
+ * - '/wp-content/themes/vastsite/dist/assets/fonts' for a WordPress deployment
+ *
+ * @type string
+ */
 $base-font-path: '../assets/fonts' !default;
 
 /* ----------------------------------------------------------------------------