@eevenkoto/core 0.1.1 → 0.2.0

package/README.md

@@ -2,6 +2,8 @@
 
 Shared prop types and pure className helpers for Eevenkoto. No DOM, no templates, no CSS.
 
+Source modules live under `core/` and `domain/` (Atoms / Molecules / Organisms). The package root barrel keeps a stable public API.
+
 Most apps use this indirectly through `@eevenkoto/html`, `@eevenkoto/react`, or `@eevenkoto/vue`.
 
 ## Install
@@ -23,11 +25,13 @@ const className = buttonClassNames({
 // "eevenkoto-button eevenkoto-button--primary eevenkoto-button--sm eevenkoto-button--icon-left"
 ```
 
-Helpers: `buttonClassNames`, `badgeClassNames`, `headingClassNames`, `paragraphClassNames`, `captionClassNames`, `flowClassNames`.
+Helpers: `buttonClassNames`, `badgeClassNames`, `headingClassNames`, `paragraphClassNames`, `listClassNames`, `captionClassNames`, `flowClassNames`, `proseClassNames`, plus Domain helpers (`abilityScoreClassNames`, `statblockClassNames`, …).
 
 Pair with `@eevenkoto/css` for styling.
 
 ## Related
 
-- `@eevenkoto/css` — tokens and component styles
+- `@eevenkoto/css` — tokens and component styles (consume / never rules live there)
 - `@eevenkoto/html` / `@eevenkoto/react` / `@eevenkoto/vue` — markup bindings
+
+For agents: feed Storybook `/llms.txt` or `/llms-full.txt` (generated via `npm run generate:llms`).

package/dist/index.d.ts

@@ -4,7 +4,8 @@ type ButtonSize = 'sm' | 'md' | 'lg';
 type ButtonIconName = 'star' | 'check' | 'arrow' | 'plus';
 type ButtonIconPosition = 'left' | 'right' | 'only';
 interface ButtonProps {
-    variant: ButtonVariant;
+    /** Default: primary (host class alone is also primary in CSS) */
+    variant?: ButtonVariant;
     label: string;
     /** Default: md */
     size?: ButtonSize;
@@ -17,7 +18,7 @@ interface ButtonProps {
 /** Props that affect Button BEM class names (excludes label/disabled content). */
 type ButtonClassNameProps = Pick<ButtonProps, 'variant' | 'size' | 'icon' | 'iconPosition'>;
 declare const resolveButtonIconPosition: (props: Pick<ButtonProps, "icon" | "iconPosition">) => ButtonIconPosition | undefined;
-declare const buttonClassNames: (props: ButtonClassNameProps) => string;
+declare const buttonClassNames: (props?: ButtonClassNameProps) => string;
 
 type BadgeVariant = 'subtle' | 'solid' | 'outline';
 type BadgeSize = 'sm' | 'md' | 'lg';
@@ -41,12 +42,15 @@ declare const badgeClassNames: (props?: BadgeClassNameProps) => string;
 
 type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
 type HeadingTone = 'primary' | 'secondary';
+/** Levels that support run-in (inline into the following Paragraph). */
+declare const HEADING_RUN_IN_LEVELS: readonly [3, 6];
+type HeadingRunInLevel = (typeof HEADING_RUN_IN_LEVELS)[number];
 interface HeadingProps {
     level: HeadingLevel;
     text: string;
     tone?: HeadingTone;
     /**
-     * Level 6 only: flow the heading into the following Paragraph
+     * Levels 3 and 6: flow the heading into the following Paragraph
      * (`.eevenkoto-heading--run-in` + sibling `.eevenkoto-paragraph`).
      */
     runIn?: boolean;
@@ -64,6 +68,11 @@ interface ParagraphProps {
 type ParagraphClassNameProps = Pick<ParagraphProps, 'size' | 'tone'>;
 declare const paragraphClassNames: (props?: ParagraphClassNameProps) => string;
 
+interface ListItemProps {
+    /** Visible item copy (`li` text node). */
+    text: string;
+}
+
 type CaptionTone = 'primary' | 'secondary';
 interface CaptionProps {
     text: string;
@@ -72,13 +81,199 @@ interface CaptionProps {
 type CaptionClassNameProps = Pick<CaptionProps, 'tone'>;
 declare const captionClassNames: (props?: CaptionClassNameProps) => string;
 
+declare const frameClassNames: () => string;
+
+type ScrollAxis = 'x' | 'y' | 'both';
+interface ScrollClassNameProps {
+    /** Overflow axis. Defaults to `x` (wide tables). */
+    axis?: ScrollAxis;
+}
+interface ScrollProps extends ScrollClassNameProps {
+}
+declare const scrollClassNames: (props?: ScrollClassNameProps) => string;
+
+type TableCellKind = 'index' | 'numeric' | 'text';
+interface TableCellClassNameProps {
+    /** Column role. Defaults to `text`. */
+    kind?: TableCellKind;
+}
+interface TableCellProps extends TableCellClassNameProps {
+    /** Cell copy (product / locale data). */
+    text: string;
+    /** Render as header cell. */
+    header?: boolean;
+    /** `scope` when `header` is true. */
+    scope?: 'col' | 'row';
+    /** Wrap header label for angled numeric heads (numeric + header). */
+    angled?: boolean;
+}
+declare const tableCellClassNames: (props?: TableCellClassNameProps) => string;
+declare const tableColClassNames: (props?: TableCellClassNameProps) => string;
+
 type FlowDensity = 'tight' | 'loose';
 interface FlowProps {
     density?: FlowDensity;
 }
 declare const flowClassNames: (props?: FlowProps) => string;
 
+declare const proseClassNames: () => string;
+
+type ListVariant = 'unordered' | 'ordered';
+type ListSize = 'sm' | 'md' | 'lg';
+type ListTone = 'primary' | 'secondary';
+interface ListProps {
+    items: ListItemProps[];
+    variant?: ListVariant;
+    size?: ListSize;
+    tone?: ListTone;
+}
+type ListClassNameProps = Pick<ListProps, 'variant' | 'size' | 'tone'>;
+declare const listClassNames: (props?: ListClassNameProps) => string;
+
+interface PropertyItem {
+    /** Definition term for `dt` (colon is rendered by CSS). Product copy stays in the app. */
+    label: string;
+    /** Value shown in `dd`. */
+    value: string;
+}
+interface PropertyProps extends PropertyItem {
+}
+declare const propertyClassNames: () => string;
+
+interface PropertyListProps {
+    items: PropertyItem[];
+}
+declare const propertyListClassNames: () => string;
+
+type StatShape = 'disk' | 'arch' | 'shield';
+type StatSize = 'sm' | 'md' | 'lg';
+interface StatProps {
+    /** Displayed numeric or signed value (e.g. `16`, `+3`). */
+    value: string;
+    /** Geometric treatment. Default: `disk` */
+    shape?: StatShape;
+    /** Shared sm | md | lg ladder. Default: `md` */
+    size?: StatSize;
+    /**
+     * Deep accent border (`content-accent-strong`) plus a thicker stroke/outline
+     * so emphasis is not color-only. Used for proficient saving throws.
+     */
+    emphasis?: boolean;
+}
+type StatClassNameProps = Pick<StatProps, 'shape' | 'size' | 'emphasis'>;
+declare const statClassNames: (props?: StatClassNameProps) => string;
+
+type TableVariant = 'default' | 'numeric' | 'pair';
+type TableStripe = 'row' | 'column' | 'none';
+interface TableColumn {
+    key: string;
+    /** Visible header label (locale / product data). */
+    header: string;
+    kind?: TableCellKind;
+}
+interface TableClassNameProps {
+    variant?: TableVariant;
+    /** Alternating band. Defaults to `row`. */
+    stripe?: TableStripe;
+}
+interface TableProps extends TableClassNameProps {
+    caption?: string;
+    columns: TableColumn[];
+    /** Row cells aligned to `columns` order. */
+    rows: string[][];
+}
+declare const tableClassNames: (props?: TableClassNameProps) => string;
+declare const tableCaptionClassNames: () => string;
+
+declare const tableShellClassNames: () => string;
+declare const tableShellFooterClassNames: () => string;
+
+interface AbilityScoreProps {
+    /** Ability name shown in the column header (product copy). */
+    label: string;
+    /**
+     * Optional stable id for the label element. Used as `aria-labelledby` on the
+     * stats `dl`. When omitted, renderers derive an id from `label` / framework ids.
+     */
+    labelId?: string;
+    /** Base score value. */
+    score: string;
+    /** Modifier, typically signed (`+3`). */
+    modifier: string;
+    /** Saving throw bonus, typically signed. */
+    save: string;
+    /** Visually hidden term for score. Default: `Score` */
+    scoreLabel?: string;
+    /** Visually hidden term for modifier. Default: `Modifier` */
+    modifierLabel?: string;
+    /** Visually hidden term for save. Default: `Save` */
+    saveLabel?: string;
+    /**
+     * Creature is proficient in this save — thicker deep-gold border + outline on
+     * the shield (not color-only). Default: false
+     */
+    saveProficient?: boolean;
+    /**
+     * Suffix in the visually hidden save term when `saveProficient` is true.
+     * Default: `proficient`
+     */
+    proficientLabel?: string;
+}
+declare const abilityScoreClassNames: (props?: {
+    saveProficient?: boolean;
+}) => string;
+
+interface AbilityScoreGroupProps {
+    abilities: AbilityScoreProps[];
+}
+declare const abilityScoreGroupClassNames: () => string;
+
+interface StatblockFeatureProps {
+    /** Feature / action name (rendered as H3 run-in). */
+    name: string;
+    /**
+     * Body copy after the run-in name.
+     * HTML renderer: plain text or a small allowlist of inline tags
+     * (`em`, `strong`, `i`, `b`, `br`) — sanitized before insert.
+     * React/Vue: prefer framework nodes; string props stay text.
+     */
+    description: string;
+}
+declare const statblockFeatureClassNames: () => string;
+
+interface StatblockSectionProps {
+    /** Section heading (e.g. Actions / Reactions) — semantic H2. */
+    title: string;
+    features: StatblockFeatureProps[];
+}
+declare const statblockSectionClassNames: () => string;
+
+/** Heading levels allowed for the creature name (embed-safe). */
+type StatblockNameLevel = Extract<HeadingLevel, 1 | 2>;
+interface StatblockProps {
+    /** Creature / entity name. */
+    name: string;
+    /**
+     * Semantic heading level for `name`. Default `1` for a dedicated entry page.
+     * Use `2` when the host document already owns an H1.
+     */
+    nameLevel?: StatblockNameLevel;
+    /** Optional flavor paragraph. */
+    flavor?: string;
+    /** Optional italic type line (size / type). */
+    typeLine?: string;
+    /** Combat vitals — rendered in the ability group header slot. */
+    vitals: PropertyItem[];
+    /** Ability columns. */
+    abilities: AbilityScoreProps[];
+    /** Skills, senses, languages, CR — ability group footer rail. */
+    details: PropertyItem[];
+    /** Named sections (Actions, Reactions, …). */
+    sections?: StatblockSectionProps[];
+}
+declare const statblockClassNames: () => string;
+
 /** Placeholder SVG path data until a shared icon library exists. */
 declare const buttonIconPaths: Record<ButtonIconName, string>;
 
-export { type BadgeClassNameProps, type BadgeIntent, type BadgeProps, type BadgeShape, type BadgeSize, type BadgeVariant, type ButtonClassNameProps, type ButtonIconName, type ButtonIconPosition, type ButtonProps, type ButtonSize, type ButtonVariant, type CaptionClassNameProps, type CaptionProps, type CaptionTone, type FlowDensity, type FlowProps, type HeadingClassNameProps, type HeadingLevel, type HeadingProps, type HeadingTone, type ParagraphClassNameProps, type ParagraphProps, type ParagraphSize, type ParagraphTone, badgeClassNames, buttonClassNames, buttonIconPaths, captionClassNames, flowClassNames, headingClassNames, paragraphClassNames, resolveButtonIconPosition };
+export { type AbilityScoreGroupProps, type AbilityScoreProps, type BadgeClassNameProps, type BadgeIntent, type BadgeProps, type BadgeShape, type BadgeSize, type BadgeVariant, type ButtonClassNameProps, type ButtonIconName, type ButtonIconPosition, type ButtonProps, type ButtonSize, type ButtonVariant, type CaptionClassNameProps, type CaptionProps, type CaptionTone, type FlowDensity, type FlowProps, HEADING_RUN_IN_LEVELS, type HeadingClassNameProps, type HeadingLevel, type HeadingProps, type HeadingRunInLevel, type HeadingTone, type ListClassNameProps, type ListItemProps, type ListProps, type ListSize, type ListTone, type ListVariant, type ParagraphClassNameProps, type ParagraphProps, type ParagraphSize, type ParagraphTone, type PropertyItem, type PropertyListProps, type PropertyProps, type ScrollAxis, type ScrollClassNameProps, type ScrollProps, type StatClassNameProps, type StatProps, type StatShape, type StatSize, type StatblockFeatureProps, type StatblockNameLevel, type StatblockProps, type StatblockSectionProps, type TableCellClassNameProps, type TableCellKind, type TableCellProps, type TableClassNameProps, type TableColumn, type TableProps, type TableStripe, type TableVariant, abilityScoreClassNames, abilityScoreGroupClassNames, badgeClassNames, buttonClassNames, buttonIconPaths, captionClassNames, flowClassNames, frameClassNames, headingClassNames, listClassNames, paragraphClassNames, propertyClassNames, propertyListClassNames, proseClassNames, resolveButtonIconPosition, scrollClassNames, statClassNames, statblockClassNames, statblockFeatureClassNames, statblockSectionClassNames, tableCaptionClassNames, tableCellClassNames, tableClassNames, tableColClassNames, tableShellClassNames, tableShellFooterClassNames };

package/dist/index.js

@@ -1,16 +1,17 @@
-// src/button.ts
+// src/core/atoms/button.ts
 var resolveButtonIconPosition = (props) => {
   if (!props.icon) return props.iconPosition;
   return props.iconPosition ?? "left";
 };
-var buttonClassNames = (props) => {
+var buttonClassNames = (props = {}) => {
+  const variant = props.variant ?? "primary";
   const size = props.size ?? "md";
   const iconPosition = resolveButtonIconPosition(props);
   const iconClass = iconPosition ? ` eevenkoto-button--icon-${iconPosition}` : "";
-  return `eevenkoto-button eevenkoto-button--${props.variant} eevenkoto-button--${size}${iconClass}`;
+  return `eevenkoto-button eevenkoto-button--${variant} eevenkoto-button--${size}${iconClass}`;
 };
 
-// src/badge.ts
+// src/core/atoms/badge.ts
 var badgeClassNames = (props = {}) => {
   const variant = props.variant ?? "subtle";
   const intent = props.intent ?? "neutral";
@@ -25,33 +26,111 @@ var badgeClassNames = (props = {}) => {
   ].join(" ");
 };
 
-// src/heading.ts
+// src/core/atoms/heading.ts
+var HEADING_RUN_IN_LEVELS = [3, 6];
+var isRunInLevel = (level) => HEADING_RUN_IN_LEVELS.includes(level);
 var headingClassNames = (props) => {
   const tone = props.tone ?? "primary";
-  const runInClass = props.runIn && props.level === 6 ? " eevenkoto-heading--run-in" : "";
+  const runInClass = props.runIn && isRunInLevel(props.level) ? " eevenkoto-heading--run-in" : "";
   return `eevenkoto-heading eevenkoto-heading--${props.level} eevenkoto-heading--${tone}${runInClass}`;
 };
 
-// src/paragraph.ts
+// src/core/atoms/paragraph.ts
 var paragraphClassNames = (props = {}) => {
   const size = props.size ?? "md";
   const tone = props.tone ?? "primary";
   return `eevenkoto-paragraph eevenkoto-paragraph--${size} eevenkoto-paragraph--${tone}`;
 };
 
-// src/caption.ts
+// src/core/atoms/caption.ts
 var captionClassNames = (props = {}) => {
   const tone = props.tone ?? "secondary";
   return `eevenkoto-caption eevenkoto-caption--${tone}`;
 };
 
-// src/flow.ts
+// src/core/atoms/frame.ts
+var frameClassNames = () => "eevenkoto-frame";
+
+// src/core/atoms/scroll.ts
+var scrollClassNames = (props = {}) => {
+  const axis = props.axis ?? "x";
+  return `eevenkoto-scroll eevenkoto-scroll--${axis}`;
+};
+
+// src/core/atoms/tableCell.ts
+var tableCellClassNames = (props = {}) => {
+  const kind = props.kind ?? "text";
+  return `eevenkoto-table-cell eevenkoto-table-cell--${kind}`;
+};
+var tableColClassNames = (props = {}) => {
+  const kind = props.kind ?? "text";
+  return `eevenkoto-table__col eevenkoto-table__col--${kind}`;
+};
+
+// src/core/molecules/flow.ts
 var flowClassNames = (props = {}) => {
   const densityClass = props.density ? ` eevenkoto-flow--${props.density}` : "";
   return `eevenkoto-flow${densityClass}`;
 };
 
-// src/icons.ts
+// src/core/molecules/prose.ts
+var proseClassNames = () => "eevenkoto-prose";
+
+// src/core/molecules/list.ts
+var listClassNames = (props = {}) => {
+  const variant = props.variant ?? "unordered";
+  const size = props.size ?? "md";
+  const tone = props.tone ?? "primary";
+  return `eevenkoto-list eevenkoto-list--${variant} eevenkoto-list--${size} eevenkoto-list--${tone}`;
+};
+
+// src/core/atoms/property.ts
+var propertyClassNames = () => "eevenkoto-property";
+
+// src/core/molecules/propertyList.ts
+var propertyListClassNames = () => "eevenkoto-property-list";
+
+// src/core/atoms/stat.ts
+var statClassNames = (props = {}) => {
+  const shape = props.shape ?? "disk";
+  const size = props.size ?? "md";
+  const emphasis = props.emphasis ? " eevenkoto-stat--emphasis" : "";
+  return `eevenkoto-stat eevenkoto-stat--${shape} eevenkoto-stat--${size}${emphasis}`;
+};
+
+// src/core/molecules/table.ts
+var tableClassNames = (props = {}) => {
+  const variant = props.variant ?? "default";
+  const stripe = props.stripe ?? "row";
+  const variantClass = variant === "default" ? "" : ` eevenkoto-table--${variant}`;
+  const stripeClass = stripe === "row" ? "" : ` eevenkoto-table--stripe-${stripe}`;
+  return `eevenkoto-table${variantClass}${stripeClass}`;
+};
+var tableCaptionClassNames = () => "eevenkoto-table__caption";
+
+// src/core/organisms/tableShell.ts
+var tableShellClassNames = () => "eevenkoto-table-shell";
+var tableShellFooterClassNames = () => "eevenkoto-table-shell__footer";
+
+// src/domain/molecules/abilityScore.ts
+var abilityScoreClassNames = (props = {}) => {
+  const proficient = props.saveProficient ? " eevenkoto-ability-score--save-proficient" : "";
+  return `eevenkoto-ability-score${proficient}`;
+};
+
+// src/domain/organisms/abilityScoreGroup.ts
+var abilityScoreGroupClassNames = () => "eevenkoto-ability-score-group";
+
+// src/domain/molecules/statblockFeature.ts
+var statblockFeatureClassNames = () => "eevenkoto-statblock-feature";
+
+// src/domain/molecules/statblockSection.ts
+var statblockSectionClassNames = () => "eevenkoto-statblock-section";
+
+// src/domain/organisms/statblock.ts
+var statblockClassNames = () => "eevenkoto-statblock";
+
+// src/core/atoms/icons.ts
 var buttonIconPaths = {
   star: "M8 1.5a.75.75 0 0 1 .67.41l1.52 3.08 3.4.5a.75.75 0 0 1 .42 1.28l-2.46 2.4.58 3.39a.75.75 0 0 1-1.09.79L8 12.27l-3.04 1.6a.75.75 0 0 1-1.09-.79l.58-3.39-2.46-2.4a.75.75 0 0 1 .42-1.28l3.4-.5L7.33 1.91A.75.75 0 0 1 8 1.5Z",
   check: "M12.207 4.793a1 1 0 0 1 0 1.414l-4.5 4.5a1 1 0 0 1-1.414 0l-2-2a1 1 0 0 1 1.414-1.414L7 8.586l3.793-3.793a1 1 0 0 1 1.414 0Z",
@@ -59,12 +138,31 @@ var buttonIconPaths = {
   plus: "M8 3a.75.75 0 0 1 .75.75v3.5h3.5a.75.75 0 0 1 0 1.5h-3.5v3.5a.75.75 0 0 1-1.5 0v-3.5h-3.5a.75.75 0 0 1 0-1.5h3.5v-3.5A.75.75 0 0 1 8 3Z"
 };
 export {
+  HEADING_RUN_IN_LEVELS,
+  abilityScoreClassNames,
+  abilityScoreGroupClassNames,
   badgeClassNames,
   buttonClassNames,
   buttonIconPaths,
   captionClassNames,
   flowClassNames,
+  frameClassNames,
   headingClassNames,
+  listClassNames,
   paragraphClassNames,
-  resolveButtonIconPosition
+  propertyClassNames,
+  propertyListClassNames,
+  proseClassNames,
+  resolveButtonIconPosition,
+  scrollClassNames,
+  statClassNames,
+  statblockClassNames,
+  statblockFeatureClassNames,
+  statblockSectionClassNames,
+  tableCaptionClassNames,
+  tableCellClassNames,
+  tableClassNames,
+  tableColClassNames,
+  tableShellClassNames,
+  tableShellFooterClassNames
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eevenkoto/core",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Eevenkoto shared prop types and className helpers",
   "type": "module",
   "files": [