@vastare/fundatio 0.1.0

package/dist/esm/elements/table/thead/thead.js

@@ -0,0 +1,9 @@
+import "../../../chunks/dom.js";
+import { T as s, a as r, c as E, e as c } from "../../../chunks/index31.js";
+export {
+  s as THEAD_SELECTOR,
+  r as THEAD_TAG,
+  E as createThead,
+  c as enhanceTheads
+};
+//# sourceMappingURL=thead.js.map

package/dist/esm/elements/table/thead/thead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thead.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/elements/table/tr/tr.js

@@ -0,0 +1,9 @@
+import "../../../chunks/dom.js";
+import { T as r, a as s, c, e as o } from "../../../chunks/index34.js";
+export {
+  r as TR_SELECTOR,
+  s as TR_TAG,
+  c as createTr,
+  o as enhanceTrs
+};
+//# sourceMappingURL=tr.js.map

package/dist/esm/elements/table/tr/tr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tr.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/elements/text/address/address.js

@@ -0,0 +1,9 @@
+import "../../../chunks/dom.js";
+import { A as r, a as A, c as S, e as d } from "../../../chunks/index48.js";
+export {
+  r as ADDRESS_SELECTOR,
+  A as ADDRESS_TAG,
+  S as createAddress,
+  d as enhanceAddresses
+};
+//# sourceMappingURL=address.js.map

package/dist/esm/elements/text/address/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/elements/text/blockquote/blockquote.js

@@ -0,0 +1,9 @@
+import "../../../chunks/dom.js";
+import { B as c, a as s, c as t, e as B } from "../../../chunks/index47.js";
+export {
+  c as BLOCKQUOTE_SELECTOR,
+  s as BLOCKQUOTE_TAG,
+  t as createBlockquote,
+  B as enhanceBlockquotes
+};
+//# sourceMappingURL=blockquote.js.map

package/dist/esm/elements/text/blockquote/blockquote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockquote.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/elements/text/hr/hr.js

@@ -0,0 +1,9 @@
+import "../../../chunks/dom.js";
+import { H as s, a as H, c, e as o } from "../../../chunks/index45.js";
+export {
+  s as HR_SELECTOR,
+  H as HR_TAG,
+  c as createHr,
+  o as enhanceHrs
+};
+//# sourceMappingURL=hr.js.map

package/dist/esm/elements/text/hr/hr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hr.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/elements/text/paragraph/paragraph.js

@@ -0,0 +1,9 @@
+import "../../../chunks/dom.js";
+import { P, a as r, c, e as o } from "../../../chunks/index44.js";
+export {
+  P as P_SELECTOR,
+  r as P_TAG,
+  c as createP,
+  o as enhancePs
+};
+//# sourceMappingURL=paragraph.js.map

package/dist/esm/elements/text/paragraph/paragraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paragraph.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/elements/text/pre/pre.js

@@ -0,0 +1,9 @@
+import "../../../chunks/dom.js";
+import { P as s, a as P, c as E, e as c } from "../../../chunks/index46.js";
+export {
+  s as PRE_SELECTOR,
+  P as PRE_TAG,
+  E as createPre,
+  c as enhancePres
+};
+//# sourceMappingURL=pre.js.map

package/dist/esm/elements/text/pre/pre.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/elements/text/text.js

@@ -0,0 +1,13 @@
+import { i as a } from "../../chunks/index44.js";
+import { i as p } from "../../chunks/index45.js";
+import { i as t } from "../../chunks/index46.js";
+import { i } from "../../chunks/index47.js";
+import { i as x } from "../../chunks/index48.js";
+export {
+  x as address,
+  i as blockquote,
+  p as hr,
+  a as paragraph,
+  t as pre
+};
+//# sourceMappingURL=text.js.map

package/dist/esm/elements/text/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;"}

package/dist/esm/elements.js

@@ -0,0 +1,29 @@
+import { i as e } from "./chunks/index2.js";
+import { i as t } from "./chunks/index3.js";
+import { i as s } from "./chunks/index4.js";
+import { i as m } from "./chunks/index5.js";
+import { i as x } from "./chunks/index6.js";
+import { i as l } from "./chunks/index7.js";
+import { i as c } from "./chunks/index8.js";
+import { i as g } from "./chunks/index9.js";
+import { i as v } from "./chunks/index10.js";
+import { i as k } from "./chunks/index11.js";
+import { i as j } from "./chunks/index12.js";
+import { i as w } from "./chunks/index13.js";
+import { i as A } from "./chunks/index14.js";
+export {
+  t as break,
+  e as container,
+  v as figure,
+  k as form,
+  x as heading,
+  c as inline,
+  j as interactive,
+  A as layout,
+  g as list,
+  s as media,
+  w as responsive,
+  m as table,
+  l as text
+};
+//# sourceMappingURL=elements.js.map

package/dist/esm/elements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elements.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;"}

package/dist/esm/index.js

@@ -0,0 +1,85 @@
+import { i as w } from "./chunks/index.js";
+function t(n) {
+  return `rgb(var(${n}) / <alpha-value>)`;
+}
+function e(n) {
+  return `--Fundatio-colour-${n}-rgb`;
+}
+function r(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"
+  ], o = {
+    // 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;
+}
+const l = {
+  theme: {
+    extend: {
+      colors: a()
+    }
+  }
+};
+function s(n) {
+  return typeof n == "object" && n !== null;
+}
+async function u() {
+  let n;
+  try {
+    n = await import("./chunks/fundatio.js");
+  } 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")
+    throw new Error('"tailwindcss/plugin" did not export a plugin factory function as expected.');
+  return o;
+}
+async function d() {
+  return (await u())(({ addUtilities: o }) => {
+    o({
+      ".Fundatio-example": {
+        fontSize: "1rem"
+      }
+    });
+  });
+}
+const c = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  solTailwindPlugin: d,
+  solTailwindPreset: l
+}, Symbol.toStringTag, { value: "Module" })), f = "1.0.0";
+export {
+  w as elements,
+  f as solVersion,
+  c as tailwind
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +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;"}

package/dist/types/elements/break/br/index.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Fundatio Design Foundation: Br element helpers.
+ *
+ * @remarks
+ * The br element (`<br>`) represents a line break within phrasing content.
+ *
+ * Best-practice guidance:
+ * - Use `<br>` only for line breaks within text (e.g. poems, addresses).
+ * - Do not use `<br>` for layout or spacing. Use CSS instead.
+ * - `<br>` is a void element and must not contain text content.
+ *
+ * This module provides a small, framework-agnostic helper so consumers can:
+ * - create line breaks safely in vanilla JS/TS
+ * - apply consistent global attributes via Fundatio's hardened DOM helpers
+ * - rely on a stable enhancement hook for future evolution
+ *
+ * This module has no side effects and does not mutate the DOM unless you call
+ * its functions.
+ *
+ * @module
+ * @category Elements
+ */
+import { type ElementOf, type GlobalAttrs } from '../../../ts/dom';
+/**
+ * Structured ARIA input supported by Fundatio element factories.
+ *
+ * @remarks
+ * This is intentionally a small, typed subset that covers common cases and
+ * prevents typo-based ARIA bugs.
+ *
+ * It is mapped into {@link GlobalAttrs.aria} for application by `dom.ts`.
+ *
+ * @category Attributes
+ */
+export type StructuredAria = {
+    /**
+     * Accessible label, mapped to `aria-label`.
+     */
+    label?: string;
+    /**
+     * ID reference to labelling element(s), mapped to `aria-labelledby`.
+     */
+    labelledby?: string;
+    /**
+     * Decorative/hidden hint, mapped to `aria-hidden`.
+     */
+    hidden?: boolean;
+};
+/**
+ * The semantic tag name for line break elements.
+ *
+ * @category Constants
+ */
+export declare const BR_TAG: "br";
+/**
+ * A CSS selector targeting br elements.
+ *
+ * @category Constants
+ */
+export declare const BR_SELECTOR = "br";
+/**
+ * Attribute bag for br creation/enhancement.
+ *
+ * @remarks
+ * `<br>` accepts only global HTML attributes.
+ * It does not accept text content and has no element-specific attributes.
+ *
+ * @category Attributes
+ */
+export type BrAttrs = Omit<GlobalAttrs, 'aria'> & {
+    /**
+     * Structured ARIA fields mapped into `aria-*` attributes.
+     */
+    aria?: StructuredAria;
+};
+/**
+ * Create a br element with optional global attributes.
+ *
+ * @remarks
+ * - `<br>` is a void element and does not accept text content.
+ * - Global attributes are applied via Fundatio's shared DOM helper,
+ *   including security guards that block inline event handler attributes
+ *   (e.g. `onclick`) and raw `style` attribute strings.
+ *
+ * @param attrs - Optional attributes to apply.
+ * @returns The created `<br>` element.
+ *
+ * @example
+ * ```ts
+ * import { createBr } from "@Vastare/Fundatio/elements/break/br";
+ *
+ * paragraph.appendChild(createBr());
+ * ```
+ *
+ * @category DOM
+ */
+export declare function createBr(attrs?: BrAttrs): ElementOf<typeof BR_TAG>;
+/**
+ * Enhance br elements within a given root.
+ *
+ * @remarks
+ * This is intentionally a no-op in `1.0.0`.
+ *
+ * It exists to establish a stable enhancement pattern across all elements.
+ *
+ * @param root - The node to search within. Defaults to `document`.
+ *
+ * @category Enhancement
+ */
+export declare function enhanceBrs(root?: ParentNode): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/elements/break/br/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/break/br/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAqB,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEtF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,MAAM,EAAG,IAAa,CAAC;AAEpC;;;;GAIG;AACH,eAAO,MAAM,WAAW,OAAO,CAAC;AAEhC;;;;;;;;GAQG;AACH,MAAM,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IAChD;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB,CAAC;AA4BF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC,OAAO,MAAM,CAAC,CAElE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,UAAqB,GAAG,IAAI,CAG5D"}

package/dist/types/elements/break/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Line and word break element factories.
+ *
+ * Provides framework-agnostic factory functions for elements that control
+ * line breaking and word breaking behaviour within text flow.
+ *
+ * These factories:
+ * - Create semantic HTML break elements using Fundatio's hardened DOM helpers.
+ * - Forward curated global attributes.
+ * - Enforce structured ARIA input where applicable.
+ * - Prevent unsafe attribute injection.
+ *
+ * @module elements/break
+ * @since 1.0.0
+ */
+/**
+ * `<br>` element factory namespace.
+ *
+ * Represents a line break opportunity within text.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/br
+ */
+export * as br from './br';
+/**
+ * `<wbr>` element factory namespace.
+ *
+ * Represents a word break opportunity within text.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/wbr
+ */
+export * as wbr from './wbr';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/elements/break/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,MAAM,MAAM,CAAC;AAE3B;;;;;;GAMG;AACH,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC"}

package/dist/types/elements/break/wbr/index.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Fundatio Design Foundation: Wbr element helpers.
+ *
+ * @remarks
+ * The wbr element (`<wbr>`) represents a word break opportunity.
+ *
+ * Best-practice guidance:
+ * - Use `<wbr>` to suggest optional break points within long words or URLs.
+ * - It does not force a line break; the browser decides if a break is needed.
+ * - Do not use `<wbr>` for layout or spacing. Use CSS instead.
+ * - `<wbr>` is a void element and must not contain text content.
+ *
+ * This module provides a small, framework-agnostic helper so consumers can:
+ * - create word break opportunities safely in vanilla JS/TS
+ * - apply consistent global attributes via Fundatio's hardened DOM helpers
+ * - rely on a stable enhancement hook for future evolution
+ *
+ * This module has no side effects and does not mutate the DOM unless you call
+ * its functions.
+ *
+ * @module
+ * @category Elements
+ */
+import { type ElementOf, type GlobalAttrs } from '../../../ts/dom';
+/**
+ * Structured ARIA input supported by Fundatio element factories.
+ *
+ * @remarks
+ * This is intentionally a small, typed subset that covers common cases and
+ * prevents typo-based ARIA bugs.
+ *
+ * It is mapped into {@link GlobalAttrs.aria} for application by `dom.ts`.
+ *
+ * @category Attributes
+ */
+export type StructuredAria = {
+    /**
+     * Accessible label, mapped to `aria-label`.
+     */
+    label?: string;
+    /**
+     * ID reference to labelling element(s), mapped to `aria-labelledby`.
+     */
+    labelledby?: string;
+    /**
+     * Decorative/hidden hint, mapped to `aria-hidden`.
+     */
+    hidden?: boolean;
+};
+/**
+ * The semantic tag name for word break opportunity elements.
+ *
+ * @category Constants
+ */
+export declare const WBR_TAG: "wbr";
+/**
+ * A CSS selector targeting wbr elements.
+ *
+ * @category Constants
+ */
+export declare const WBR_SELECTOR = "wbr";
+/**
+ * Attribute bag for wbr creation/enhancement.
+ *
+ * @remarks
+ * `<wbr>` accepts only global HTML attributes.
+ * It does not accept text content and has no element-specific attributes.
+ *
+ * @category Attributes
+ */
+export type WbrAttrs = Omit<GlobalAttrs, 'aria'> & {
+    /**
+     * Structured ARIA fields mapped into `aria-*` attributes.
+     */
+    aria?: StructuredAria;
+};
+/**
+ * Create a wbr element with optional global attributes.
+ *
+ * @remarks
+ * - `<wbr>` is a void element and does not accept text content.
+ * - Global attributes are applied via Fundatio's shared DOM helper,
+ *   including security guards that block inline event handler attributes
+ *   (e.g. `onclick`) and raw `style` attribute strings.
+ *
+ * @param attrs - Optional attributes to apply.
+ * @returns The created `<wbr>` element.
+ *
+ * @example
+ * ```ts
+ * import { createWbr } from "@Vastare/Fundatio/elements/break/wbr";
+ *
+ * paragraph.appendChild(createWbr());
+ * ```
+ *
+ * @category DOM
+ */
+export declare function createWbr(attrs?: WbrAttrs): ElementOf<typeof WBR_TAG>;
+/**
+ * Enhance wbr elements within a given root.
+ *
+ * @remarks
+ * This is intentionally a no-op in `1.0.0`.
+ *
+ * It exists to establish a stable enhancement pattern across all elements.
+ *
+ * @param root - The node to search within. Defaults to `document`.
+ *
+ * @category Enhancement
+ */
+export declare function enhanceWbrs(root?: ParentNode): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/elements/break/wbr/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/break/wbr/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAqB,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEtF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAG,KAAc,CAAC;AAEtC;;;;GAIG;AACH,eAAO,MAAM,YAAY,QAAQ,CAAC;AAElC;;;;;;;;GAQG;AACH,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IACjD;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB,CAAC;AA4BF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,SAAS,CAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC,OAAO,OAAO,CAAC,CAErE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,IAAI,GAAE,UAAqB,GAAG,IAAI,CAG7D"}

package/dist/types/elements/container/div/index.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Fundatio Design Foundation: Div element helpers.
+ *
+ * @remarks
+ * The div element (`<div>`) is a non-semantic, generic container.
+ *
+ * Best-practice guidance:
+ * - Prefer semantic elements when available (e.g. `<section>`, `<nav>`, `<article>`).
+ * - Use `<div>` as a last resort when no semantic element fits.
+ * - Avoid obsolete attributes like `align`; use CSS instead.
+ *
+ * This module provides small, framework-agnostic helpers so consumers can:
+ * - create div containers in vanilla JS/TS without templates
+ * - apply consistent global attributes safely
+ * - use a stable "enhancement" hook if Fundatio ever needs runtime behavior
+ *
+ * This module has no side effects and does not mutate the DOM unless you call
+ * its functions.
+ *
+ * @module
+ * @category Elements
+ */
+import { type ElementOf, type GlobalAttrs } from '../../../ts/dom';
+/**
+ * Structured ARIA input supported by Fundatio element factories.
+ *
+ * @remarks
+ * This is intentionally a small, typed subset that covers common cases and
+ * prevents typo-based ARIA bugs (e.g. `lable`).
+ *
+ * It is mapped into {@link GlobalAttrs.aria} for application by `dom.ts`.
+ *
+ * @category Attributes
+ */
+export type StructuredAria = {
+    /**
+     * Accessible label, mapped to `aria-label`.
+     */
+    label?: string;
+    /**
+     * ID reference to the labelling element(s), mapped to `aria-labelledby`.
+     */
+    labelledby?: string;
+    /**
+     * Decorative/hidden hint, mapped to `aria-hidden`.
+     */
+    hidden?: boolean;
+};
+/**
+ * The semantic tag name for div containers.
+ *
+ * @category Constants
+ */
+export declare const DIV_TAG: "div";
+/**
+ * A CSS selector targeting div elements.
+ *
+ * @category Constants
+ */
+export declare const DIV_SELECTOR = "div";
+/**
+ * Attribute bag for div creation/enhancement.
+ *
+ * @remarks
+ * Div elements accept standard HTML global attributes.
+ *
+ * Fundatio also supports a structured ARIA input for common ARIA fields, which is
+ * mapped into {@link GlobalAttrs.aria} without changing Fundatio's core DOM helpers.
+ *
+ * @category Attributes
+ */
+export type DivAttrs = Omit<GlobalAttrs, 'aria'> & {
+    /**
+     * Structured ARIA fields mapped into `aria-*` attributes.
+     */
+    aria?: StructuredAria;
+};
+/**
+ * Create a div element with optional text content and global attributes.
+ *
+ * @remarks
+ * - Text content is assigned via `textContent` (never `innerHTML`).
+ * - Global attributes are applied via Fundatio's shared DOM helper,
+ *   including security guards that block inline event handler attributes
+ *   (e.g. `onclick`) and raw `style` attribute strings.
+ *
+ * @param text - Optional text content for the div.
+ * @param attrs - Optional attributes to apply.
+ * @returns The created `<div>` element.
+ *
+ * @example
+ * Create and append a div:
+ * ```ts
+ * import { createDiv } from "@Vastare/Fundatio/elements/container/div";
+ *
+ * document.body.appendChild(
+ *   createDiv("Hello.", { className: "box", id: "root" })
+ * );
+ * ```
+ *
+ * @category DOM
+ */
+export declare function createDiv(text?: string, attrs?: DivAttrs): ElementOf<typeof DIV_TAG>;
+/**
+ * Enhance div elements within a given root.
+ *
+ * @remarks
+ * This is intentionally a no-op in `1.0.0`.
+ *
+ * Why does it exist?
+ * - It establishes a stable integration pattern for frameworks (Vue/React/etc.)
+ * - It allows future progressive enhancements without changing consumer code
+ *
+ * What it will never do:
+ * - It will not inject styles (CSS remains the source of truth)
+ * - It will not introduce framework-specific behavior
+ *
+ * @param root - The node to search within. Defaults to `document`.
+ *
+ * @category Enhancement
+ */
+export declare function enhanceDivs(root?: ParentNode): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/elements/container/div/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/container/div/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAiB,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAElF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAG,KAAc,CAAC;AAEtC;;;;GAIG;AACH,eAAO,MAAM,YAAY,QAAQ,CAAC;AAElC;;;;;;;;;;GAUG;AACH,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;IACjD;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB,CAAC;AA6BF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC,OAAO,OAAO,CAAC,CAEpF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,IAAI,GAAE,UAAqB,GAAG,IAAI,CAG7D"}