@pantoken/components 0.2.3 → 0.2.5

package/dist/index.d.mts

@@ -1,5 +1,4 @@
 import { ELEVATION_NAMES, FOCUSABLE_SELECTOR, elevationDeclarations, focusOutlineDeclarations, focusOutlineRules } from "@pantoken/utils";
-
 //#region src/lib/helpers.d.ts
 /**
  * Shared primitives for the component builders: the class-prefix namespace helper, the standalone-sheet
@@ -27,6 +26,30 @@ interface ComponentOptions {
   theme?: ComponentTheme;
 }
 //#endregion
+//#region ../../node_modules/.pnpm/@cssdoc+core@0.7.9/node_modules/@cssdoc/core/dist/lite-CLGf1QSF.d.mts
+/**
+ * What kind of CSS surface a record documents. `component` is a namespaced component class with
+ * `-modifier`s and parts; `utility` a single-purpose class family; `rule` bare-element/reset styling;
+ * `declaration` a custom-property / `@property` registration layer. The record-opening tag chooses it
+ * (`@component`/`@utility`/`@rule`/`@declaration`); `@name` is an alias for `component`.
+ */
+type CssRecordKind = "component" | "utility" | "rule" | "declaration";
+//#endregion
+//#region src/lib/define.d.ts
+/** A resolved record: `rules(prefix)` emits the doc block plus CSS body for the aggregator, and `css(options)` returns the standalone header-wrapped sheet. */
+interface Definition {
+  name: string;
+  kind: CssRecordKind;
+  /** Doc block + CSS body at the given (already `ns()`-joined) prefix — concatenated by the aggregator. */
+  rules(this: void, prefix: string, options?: ComponentOptions): string;
+  /**
+   * The standalone, header-wrapped stylesheet — what the exported `xxxCss` returns. Declared `this: void`
+   * because it's a plain closure (no receiver): callers bind it as `export const buttonCss = button.css`,
+   * so the annotation tells the linter the free-floating reference is safe.
+   */
+  css(this: void, options?: ComponentOptions): string;
+}
+//#endregion
 //#region src/rules/prose.d.ts
 /** Options for {@link proseCss}. */
 interface ProseOptions {
@@ -84,199 +107,199 @@ declare function focusOutlineCss(options?: {
 //#endregion
 //#region src/components/button.d.ts
 /** Standalone `button` stylesheet — the prefixed CSS for the action button, ready to ship as a `.css` file. */
-declare const buttonCss: (this: void, options?: ComponentOptions) => string;
+declare const buttonCss: Definition["css"];
 //#endregion
 //#region src/components/alert.d.ts
 /** Standalone `alert` stylesheet — the prefixed CSS for the status message, ready to ship as a `.css` file. */
-declare const alertCss: (this: void, options?: ComponentOptions) => string;
+declare const alertCss: Definition["css"];
 //#endregion
 //#region src/components/badge.d.ts
 /** Standalone `badge` stylesheet — the prefixed CSS for the count-and-status badge, ready to ship as a `.css` file. */
-declare const badgeCss: (this: void, options?: ComponentOptions) => string;
+declare const badgeCss: Definition["css"];
 //#endregion
 //#region src/components/pill.d.ts
 /** Standalone `pill` stylesheet — the prefixed CSS for the status pill, ready to ship as a `.css` file. */
-declare const pillCss: (this: void, options?: ComponentOptions) => string;
+declare const pillCss: Definition["css"];
 //#endregion
 //#region src/components/tag.d.ts
 /** Standalone `tag` stylesheet — the prefixed CSS for the chip, ready to ship as a `.css` file. */
-declare const tagCss: (this: void, options?: ComponentOptions) => string;
+declare const tagCss: Definition["css"];
 //#endregion
 //#region src/components/avatar.d.ts
 /** Standalone `avatar` stylesheet — the prefixed CSS for the avatar, ready to ship as a `.css` file. */
-declare const avatarCss: (this: void, options?: ComponentOptions) => string;
+declare const avatarCss: Definition["css"];
 //#endregion
 //#region src/components/tabs.d.ts
 /** Standalone `tabs` stylesheet — the prefixed CSS for the tabbed panels, ready to ship as a `.css` file. */
-declare const tabsCss: (this: void, options?: ComponentOptions) => string;
+declare const tabsCss: Definition["css"];
 //#endregion
 //#region src/components/metric.d.ts
 /** Standalone `metric` stylesheet — the prefixed CSS for the statistic, ready to ship as a `.css` file. */
-declare const metricCss: (this: void, options?: ComponentOptions) => string;
+declare const metricCss: Definition["css"];
 //#endregion
 //#region src/components/img.d.ts
 /** Standalone `img` stylesheet — the prefixed CSS for the styled image, ready to ship as a `.css` file. */
-declare const imgCss: (this: void, options?: ComponentOptions) => string;
+declare const imgCss: Definition["css"];
 //#endregion
 //#region src/components/byline.d.ts
 /** Standalone `byline` stylesheet — the prefixed CSS for the media object, ready to ship as a `.css` file. */
-declare const bylineCss: (this: void, options?: ComponentOptions) => string;
+declare const bylineCss: Definition["css"];
 //#endregion
 //#region src/components/table.d.ts
 /** Standalone `table` stylesheet — the prefixed CSS for the data table, ready to ship as a `.css` file. */
-declare const tableCss: (this: void, options?: ComponentOptions) => string;
+declare const tableCss: Definition["css"];
 //#endregion
 //#region src/components/link.d.ts
 /** Standalone `link` stylesheet — the prefixed CSS for the hyperlink, ready to ship as a `.css` file. */
-declare const linkCss: (this: void, options?: ComponentOptions) => string;
+declare const linkCss: Definition["css"];
 //#endregion
 //#region src/components/list.d.ts
 /** Standalone `list` stylesheet — the prefixed CSS for the spaced list, ready to ship as a `.css` file. */
-declare const listCss: (this: void, options?: ComponentOptions) => string;
+declare const listCss: Definition["css"];
 //#endregion
 //#region src/components/checkbox.d.ts
 /** Standalone `checkbox` stylesheet — the prefixed CSS for the checkbox and switch, ready to ship as a `.css` file. */
-declare const checkboxCss: (this: void, options?: ComponentOptions) => string;
+declare const checkboxCss: Definition["css"];
 //#endregion
 //#region src/components/radio.d.ts
 /** Standalone `radio` stylesheet — the prefixed CSS for the radio button, ready to ship as a `.css` file. */
-declare const radioCss: (this: void, options?: ComponentOptions) => string;
+declare const radioCss: Definition["css"];
 //#endregion
 //#region src/components/spinner.d.ts
 /** Standalone `spinner` stylesheet — the prefixed CSS for the loading ring, ready to ship as a `.css` file. */
-declare const spinnerCss: (this: void, options?: ComponentOptions) => string;
+declare const spinnerCss: Definition["css"];
 //#endregion
 //#region src/components/progress.d.ts
 /** Standalone `progress` stylesheet — the prefixed CSS for the progress bar, ready to ship as a `.css` file. */
-declare const progressCss: (this: void, options?: ComponentOptions) => string;
+declare const progressCss: Definition["css"];
 //#endregion
 //#region src/components/menu.d.ts
 /** Standalone `menu` stylesheet — the prefixed CSS for the dropdown menu, ready to ship as a `.css` file. */
-declare const menuCss: (this: void, options?: ComponentOptions) => string;
+declare const menuCss: Definition["css"];
 //#endregion
 //#region src/components/modal.d.ts
 /** Standalone `modal` stylesheet — the prefixed CSS for the dialog surface, ready to ship as a `.css` file. */
-declare const modalCss: (this: void, options?: ComponentOptions) => string;
+declare const modalCss: Definition["css"];
 //#endregion
 //#region src/components/breadcrumb.d.ts
 /** Standalone `breadcrumb` stylesheet — the prefixed CSS for the breadcrumb trail, ready to ship as a `.css` file. */
-declare const breadcrumbCss: (this: void, options?: ComponentOptions) => string;
+declare const breadcrumbCss: Definition["css"];
 //#endregion
 //#region src/components/billboard.d.ts
 /** Standalone `billboard` stylesheet — the prefixed CSS for the empty-state block, ready to ship as a `.css` file. */
-declare const billboardCss: (this: void, options?: ComponentOptions) => string;
+declare const billboardCss: Definition["css"];
 //#endregion
 //#region src/components/rating.d.ts
 /** Standalone `rating` stylesheet — the prefixed CSS for the star rating, ready to ship as a `.css` file. */
-declare const ratingCss: (this: void, options?: ComponentOptions) => string;
+declare const ratingCss: Definition["css"];
 //#endregion
 //#region src/components/toggle-group.d.ts
 /** Standalone `toggleGroup` stylesheet — the prefixed CSS for the bordered disclosure, ready to ship as a `.css` file. */
-declare const toggleGroupCss: (this: void, options?: ComponentOptions) => string;
+declare const toggleGroupCss: Definition["css"];
 //#endregion
 //#region src/components/context-view.d.ts
 /** Standalone `contextView` stylesheet — the prefixed CSS for the caret callout, ready to ship as a `.css` file. */
-declare const contextViewCss: (this: void, options?: ComponentOptions) => string;
+declare const contextViewCss: Definition["css"];
 //#endregion
 //#region src/components/progress-circle.d.ts
 /** Standalone `progressCircle` stylesheet — the prefixed CSS for the progress ring, ready to ship as a `.css` file. */
-declare const progressCircleCss: (this: void, options?: ComponentOptions) => string;
+declare const progressCircleCss: Definition["css"];
 //#endregion
 //#region src/components/pagination.d.ts
 /** Standalone `pagination` stylesheet — the prefixed CSS for the page navigation, ready to ship as a `.css` file. */
-declare const paginationCss: (this: void, options?: ComponentOptions) => string;
+declare const paginationCss: Definition["css"];
 //#endregion
 //#region src/components/truncate.d.ts
 /** Standalone `truncate` stylesheet — the prefixed CSS for the truncation utility, ready to ship as a `.css` file. */
-declare const truncateCss: (this: void, options?: ComponentOptions) => string;
+declare const truncateCss: Definition["css"];
 //#endregion
 //#region src/components/toggle-details.d.ts
 /** Standalone `toggleDetails` stylesheet — the prefixed CSS for the details disclosure, ready to ship as a `.css` file. */
-declare const toggleDetailsCss: (this: void, options?: ComponentOptions) => string;
+declare const toggleDetailsCss: Definition["css"];
 //#endregion
 //#region src/components/file-drop.d.ts
 /** Standalone `fileDrop` stylesheet — the prefixed CSS for the file dropzone, ready to ship as a `.css` file. */
-declare const fileDropCss: (this: void, options?: ComponentOptions) => string;
+declare const fileDropCss: Definition["css"];
 //#endregion
 //#region src/components/side-nav-bar.d.ts
 /** Standalone `sideNavBar` stylesheet — the prefixed CSS for the navigation rail, ready to ship as a `.css` file. */
-declare const sideNavBarCss: (this: void, options?: ComponentOptions) => string;
+declare const sideNavBarCss: Definition["css"];
 //#endregion
 //#region src/components/tree-browser.d.ts
 /** Standalone `treeBrowser` stylesheet — the prefixed CSS for the disclosure tree, ready to ship as a `.css` file. */
-declare const treeBrowserCss: (this: void, options?: ComponentOptions) => string;
+declare const treeBrowserCss: Definition["css"];
 //#endregion
 //#region src/components/calendar.d.ts
 /** Standalone `calendar` stylesheet — the prefixed CSS for the month grid, ready to ship as a `.css` file. */
-declare const calendarCss: (this: void, options?: ComponentOptions) => string;
+declare const calendarCss: Definition["css"];
 //#endregion
 //#region src/components/popover.d.ts
 /** Standalone `popover` stylesheet — the prefixed CSS for the popover surface, ready to ship as a `.css` file. */
-declare const popoverCss: (this: void, options?: ComponentOptions) => string;
+declare const popoverCss: Definition["css"];
 //#endregion
 //#region src/components/tray.d.ts
 /** Standalone `tray` stylesheet — the prefixed CSS for the sliding tray, ready to ship as a `.css` file. */
-declare const trayCss: (this: void, options?: ComponentOptions) => string;
+declare const trayCss: Definition["css"];
 //#endregion
 //#region src/components/tooltip.d.ts
 /** Standalone `tooltip` stylesheet — the prefixed CSS for the tooltip bubble, ready to ship as a `.css` file. */
-declare const tooltipCss: (this: void, options?: ComponentOptions) => string;
+declare const tooltipCss: Definition["css"];
 //#endregion
 //#region src/components/range-input.d.ts
 /** Standalone `rangeInput` stylesheet — the prefixed CSS for the range slider, ready to ship as a `.css` file. */
-declare const rangeInputCss: (this: void, options?: ComponentOptions) => string;
+declare const rangeInputCss: Definition["css"];
 //#endregion
 //#region src/components/heading.d.ts
 /** Standalone `heading` stylesheet — the prefixed CSS for the heading type, ready to ship as a `.css` file. */
-declare const headingCss: (this: void, options?: ComponentOptions) => string;
+declare const headingCss: Definition["css"];
 //#endregion
 //#region src/components/text.d.ts
 /** Standalone `text` stylesheet — the prefixed CSS for the body typography, ready to ship as a `.css` file. */
-declare const textCss: (this: void, options?: ComponentOptions) => string;
+declare const textCss: Definition["css"];
 //#endregion
 //#region src/components/close-button.d.ts
 /** Standalone `closeButton` stylesheet — the prefixed CSS for the close button, ready to ship as a `.css` file. */
-declare const closeButtonCss: (this: void, options?: ComponentOptions) => string;
+declare const closeButtonCss: Definition["css"];
 //#endregion
 //#region src/components/text-input.d.ts
 /** Standalone `textInput` stylesheet — the prefixed CSS for the text input, ready to ship as a `.css` file. */
-declare const textInputCss: (this: void, options?: ComponentOptions) => string;
+declare const textInputCss: Definition["css"];
 //#endregion
 //#region src/components/text-area.d.ts
 /** Standalone `textArea` stylesheet — the prefixed CSS for the textarea, ready to ship as a `.css` file. */
-declare const textAreaCss: (this: void, options?: ComponentOptions) => string;
+declare const textAreaCss: Definition["css"];
 //#endregion
 //#region src/components/simple-select.d.ts
 /** Standalone `simpleSelect` stylesheet — the prefixed CSS for the native select, ready to ship as a `.css` file. */
-declare const simpleSelectCss: (this: void, options?: ComponentOptions) => string;
+declare const simpleSelectCss: Definition["css"];
 //#endregion
 //#region src/components/input-group.d.ts
 /** Standalone `inputGroup` stylesheet — the prefixed CSS for the input group, ready to ship as a `.css` file. */
-declare const inputGroupCss: (this: void, options?: ComponentOptions) => string;
+declare const inputGroupCss: Definition["css"];
 //#endregion
 //#region src/components/number-input.d.ts
 /** Standalone `numberInput` stylesheet — the prefixed CSS for the number input, ready to ship as a `.css` file. */
-declare const numberInputCss: (this: void, options?: ComponentOptions) => string;
+declare const numberInputCss: Definition["css"];
 //#endregion
 //#region src/components/in-place-edit.d.ts
 /** Standalone `inPlaceEdit` stylesheet — the prefixed CSS for the in-place editor, ready to ship as a `.css` file. */
-declare const inPlaceEditCss: (this: void, options?: ComponentOptions) => string;
+declare const inPlaceEditCss: Definition["css"];
 //#endregion
 //#region src/components/form-field-messages.d.ts
 /** Standalone `formFieldMessages` stylesheet — the prefixed CSS for the field messages, ready to ship as a `.css` file. */
-declare const formFieldMessagesCss: (this: void, options?: ComponentOptions) => string;
+declare const formFieldMessagesCss: Definition["css"];
 //#endregion
 //#region src/components/form-field.d.ts
 /** Standalone `formField` stylesheet — the prefixed CSS for the form-field wrapper, ready to ship as a `.css` file. */
-declare const formFieldCss: (this: void, options?: ComponentOptions) => string;
+declare const formFieldCss: Definition["css"];
 //#endregion
 //#region src/components/form-field-group.d.ts
 /** Standalone `formFieldGroup` stylesheet — the prefixed CSS for the fieldset group, ready to ship as a `.css` file. */
-declare const formFieldGroupCss: (this: void, options?: ComponentOptions) => string;
+declare const formFieldGroupCss: Definition["css"];
 //#endregion
 //#region src/components/radio-input-group.d.ts
 /** Standalone `radioInputGroup` stylesheet — the prefixed CSS for the radio group, ready to ship as a `.css` file. */
-declare const radioInputGroupCss: (this: void, options?: ComponentOptions) => string;
+declare const radioInputGroupCss: Definition["css"];
 //#endregion
 //#region src/components/select.d.ts
 /**
@@ -305,31 +328,31 @@ declare function selectCss(options?: ComponentOptions): string;
 //#endregion
 //#region src/utilities/view.d.ts
 /** The View utility as a standalone, header-wrapped stylesheet. */
-declare const viewCss: (this: void, options?: ComponentOptions) => string;
+declare const viewCss: Definition["css"];
 //#endregion
 //#region src/utilities/spacing.d.ts
 /** The spacing utilities as a standalone, header-wrapped stylesheet. */
-declare const spacingUtilitiesCss: (this: void, options?: ComponentOptions) => string;
+declare const spacingUtilitiesCss: Definition["css"];
 //#endregion
 //#region src/utilities/layout.d.ts
 /** The layout utilities as a standalone, header-wrapped stylesheet. */
-declare const layoutUtilitiesCss: (this: void, options?: ComponentOptions) => string;
+declare const layoutUtilitiesCss: Definition["css"];
 //#endregion
 //#region src/utilities/responsive.d.ts
 /** The responsive-visibility utilities as a standalone, header-wrapped stylesheet. */
-declare const responsiveUtilitiesCss: (this: void, options?: ComponentOptions) => string;
+declare const responsiveUtilitiesCss: Definition["css"];
 //#endregion
 //#region src/utilities/icon.d.ts
 /** The icon utility as a standalone, header-wrapped stylesheet. */
-declare const iconCss: (this: void, options?: ComponentOptions) => string;
+declare const iconCss: Definition["css"];
 //#endregion
 //#region src/utilities/mask.d.ts
 /** The mask utility as a standalone, header-wrapped stylesheet. */
-declare const maskCss: (this: void, options?: ComponentOptions) => string;
+declare const maskCss: Definition["css"];
 //#endregion
 //#region src/utilities/screen-reader-content.d.ts
 /** The screen-reader-content utility as a standalone, header-wrapped stylesheet. */
-declare const screenReaderContentCss: (this: void, options?: ComponentOptions) => string;
+declare const screenReaderContentCss: Definition["css"];
 //#endregion
 //#region src/utilities/icon-glyphs.d.ts
 /** Options for {@link iconGlyphsCss}. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pantoken/components",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "An InstUI-look CSS component library from the pantoken tokens: prose/content styling plus class-based components (button, alert, badge).",
   "homepage": "https://pantoken.iywahl.com",
   "bugs": "https://github.com/thedannywahl/pantoken/issues",