neatkit 0.4.2 → 0.5.0

package/dist/code.cjs

@@ -0,0 +1 @@
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./Code-CDHkXHVo.cjs");exports.Code=e.Code;

package/dist/code.js

@@ -0,0 +1,5 @@
+"use client";
+import { C as r } from "./Code-D4qqPnTN.js";
+export {
+  r as Code
+};

package/dist/components/Button/Button.d.ts

@@ -19,8 +19,8 @@ type ButtonOwnProps = {
     variant?: ButtonVariant;
     /** The semantic intent applied to the Button. */
     tone?: ButtonTone;
-    /** The outline shape applied to the Button. */
-    shape: ButtonShape;
+    /** The outline shape applied to the Button. Defaults to capsule. */
+    shape?: ButtonShape;
     /** Whether the Button fills its containing block. */
     fullWidth?: boolean;
     /** Whether the Button displays a loading indicator and blocks interaction. */

package/dist/components/Code/Code.d.ts

@@ -0,0 +1,47 @@
+import { type HTMLAttributes } from "react";
+import "./styles/code.css";
+/** A syntax-highlighting language supported by Code. */
+export type CodeLanguage = "C" | "C++" | "CSS" | "Go" | "HTML" | "JSON" | "JavaScript" | "Markdown" | "Python" | "Ruby" | "Rust" | "SQL" | "Shell" | "TypeScript" | "YAML";
+/** Properties owned by Code rather than its native container. */
+type CodeOwnProps = {
+    /** Native properties applied to the rendered code element. */
+    codeProps?: Omit<HTMLAttributes<HTMLElement>, "children" | "dangerouslySetInnerHTML">;
+    /** The plain source string displayed by the component. */
+    code: string;
+    /** The additional class name applied to the horizontal scroll container. */
+    containerClassName?: string;
+    /** The language label and optional syntax grammar applied to the source. */
+    language?: CodeLanguage;
+    /**
+     * The maximum line count rendered with individual wrappers and numbers.
+     * Larger source remains complete as one plain text node. Set to null only
+     * for trusted source whose line count is constrained elsewhere.
+     */
+    maxLineCount?: number | null;
+    /**
+     * The maximum UTF-16 source length processed by syntax highlighting. Set to
+     * null only for trusted source whose size is constrained elsewhere.
+     */
+    maxHighlightLength?: number | null;
+    /** Native properties applied to the rendered preformatted element. */
+    preProps?: Omit<HTMLAttributes<HTMLPreElement>, "children" | "dangerouslySetInnerHTML">;
+    /** The optional source title displayed in the Card header. */
+    title?: string;
+};
+/** A type representing properties for the Code component. */
+export type CodeProps = Omit<HTMLAttributes<HTMLDivElement>, "children" | "dangerouslySetInnerHTML" | "title"> & CodeOwnProps;
+/**
+ * Renders highlighted, line-numbered source inside a Card.
+ *
+ * The horizontal scroll region becomes keyboard-focusable only when its
+ * content overflows, while line numbers remain hidden from assistive
+ * technology and text selection. Syntax highlighting and individual line
+ * wrappers are bounded while oversized source remains complete as plain text.
+ *
+ * @param props - The source, presentation, and native container properties.
+ * @param forwardedReference - The reference assigned to the outer Card.
+ *
+ * @returns The rendered source-code surface.
+ */
+declare const Code: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLDivElement>, "title" | "children" | "dangerouslySetInnerHTML"> & CodeOwnProps & import("react").RefAttributes<HTMLDivElement>>;
+export default Code;

package/dist/components/Code/index.d.ts

@@ -0,0 +1,2 @@
+export { default as Code } from "./Code";
+export type { CodeLanguage, CodeProps } from "./Code";

package/dist/components/Code/utils/highlight.d.ts

@@ -0,0 +1,17 @@
+import type { CodeLanguage } from "../Code";
+/** A highlighted text fragment rendered within one source line. */
+export type CodeHighlightSegment = {
+    /** The syntax classes describing the highlighted fragment. */
+    className?: string;
+    /** The source text represented by the fragment. */
+    text: string;
+};
+/**
+ * Highlights source code and groups its syntax fragments by line.
+ *
+ * @param code - The normalized source code to highlight.
+ * @param language - The language grammar used to parse the source.
+ *
+ * @returns Highlighted lines, or null when parsing cannot complete.
+ */
+export declare function highlightCode(code: string, language: CodeLanguage): CodeHighlightSegment[][] | null;

package/dist/components/Content/Content.d.ts

@@ -5,7 +5,7 @@ export type ContentTheme = "light" | "dark";
 /** A type representing Content's visual background modes. */
 export type ContentMode = "grid" | "none";
 /** A type representing Content's minimum-height behavior. */
-export type ContentFill = "none" | "available" | "viewport";
+export type ContentMinHeight = "auto" | "available" | "viewport";
 /** A type representing Content's vertical spacing behavior. */
 export type ContentSpacing = "standard" | "none";
 /** A type representing CSS custom properties accepted by Content styles. */
@@ -24,8 +24,8 @@ type ContentOwnProps = {
     accent?: string;
     /** The visual background treatment applied to Content. */
     mode?: ContentMode;
-    /** The minimum-height behavior applied to Content. */
-    fill?: ContentFill;
+    /** The minimum height applied to Content. */
+    minHeight?: ContentMinHeight;
     /** The vertical spacing applied within Content. */
     spacing?: ContentSpacing;
     /** Whether Content applies its responsive cell-aligned inner width. */

package/dist/components/Content/index.d.ts

@@ -1,2 +1,2 @@
 export { default as Content } from "./Content";
-export type { ContentFill, ContentMode, ContentProps, ContentSpacing, ContentTheme, } from "./Content";
+export type { ContentMinHeight, ContentMode, ContentProps, ContentSpacing, ContentTheme, } from "./Content";

package/dist/components/Markdown/Markdown.d.ts

@@ -0,0 +1,66 @@
+import { type HTMLAttributes } from "react";
+import type { PluggableList } from "unified";
+import { type MarkdownImageSourceAllowlist } from "./utils/security";
+import "./styles/markdown.css";
+/** Properties owned by Markdown rather than its native container. */
+type MarkdownOwnProps = {
+    /** Image sources permitted to initiate requests. The default blocks all. */
+    allowedImageSources?: MarkdownImageSourceAllowlist;
+    /**
+     * A stable public prefix applied after Markdown's fixed `md-` security
+     * namespace. IDs remain document-global: multiple Markdown components and
+     * their footnotes can collide, and duplicate fragments use native first-match
+     * behavior. Use distinct values for multiple navigable documents.
+     */
+    anchorPrefix?: string;
+    /** The untrusted Markdown source to parse and render. */
+    content: string;
+    /** Trusted absolute base used to resolve pattern-allowed relative images. */
+    imageBaseUrl?: string;
+    /** Trusted rehype plugins run before the mandatory security transforms. */
+    rehypePlugins?: PluggableList;
+    /** Trusted remark plugins run after the built-in GFM extension. */
+    remarkPlugins?: PluggableList;
+    /**
+     * The maximum UTF-16 source length parsed synchronously. Set to null only
+     * for trusted content whose size is constrained elsewhere.
+     */
+    maxContentLength?: number | null;
+    /**
+     * The maximum source length syntax-highlighted within each code block. Set
+     * to null only for trusted source whose size is constrained elsewhere.
+     */
+    maxCodeHighlightLength?: number | null;
+    /**
+     * The maximum code-block line count rendered with wrappers and numbers.
+     * Larger blocks remain complete as one plain text node. Set to null only
+     * for trusted source whose line count is constrained elsewhere.
+     */
+    maxCodeLineCount?: number | null;
+    /**
+     * The pixel offset reserved above smoothly scrolled anchors. Set to null to
+     * use immediate in-document navigation without a reserved offset.
+     */
+    scrollOffset?: number | null;
+};
+/** A type representing properties for the Markdown component. */
+export type MarkdownProps = Omit<HTMLAttributes<HTMLDivElement>, "children" | "dangerouslySetInnerHTML"> & MarkdownOwnProps;
+/**
+ * Renders untrusted CommonMark and GFM content through Neatkit components.
+ *
+ * Embedded HTML is parsed through a fixed allowlist, unsafe URL protocols are
+ * removed, generated IDs use a fixed `md-` clobber-protection namespace, and
+ * all images are blocked unless explicitly enabled. IDs are document-global;
+ * consumers must provide distinct `anchorPrefix` values when rendering
+ * multiple independently navigable documents. Parsing and code rendering are
+ * bounded by default. Consumer plugins run before the fixed security
+ * transforms; renderer overrides and Markdown-to-HTML conversion options stay
+ * private because they can invalidate these guarantees.
+ *
+ * @param props - The Markdown source, security options, and native properties.
+ * @param forwardedReference - The reference assigned to the outer container.
+ *
+ * @returns The safely rendered Markdown content.
+ */
+declare const Markdown: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLDivElement>, "children" | "dangerouslySetInnerHTML"> & MarkdownOwnProps & import("react").RefAttributes<HTMLDivElement>>;
+export default Markdown;

package/dist/components/Markdown/index.d.ts

@@ -0,0 +1,3 @@
+export { default as Markdown } from "./Markdown";
+export type { MarkdownProps } from "./Markdown";
+export type { MarkdownImageSourceAllowlist } from "./utils/security";

package/dist/components/Markdown/utils/language.d.ts

@@ -0,0 +1,9 @@
+import type { CodeLanguage } from "../../Code/Code";
+/**
+ * Resolves a fenced-code identifier to a supported syntax grammar.
+ *
+ * @param className - The language class generated from the Markdown fence.
+ *
+ * @returns The supported language, or undefined for an unknown identifier.
+ */
+export declare function resolveCodeLanguage(className?: string): CodeLanguage | undefined;

package/dist/components/Markdown/utils/renderers.d.ts

@@ -0,0 +1,15 @@
+import type { MouseEventHandler } from "react";
+import type { Components } from "react-markdown";
+import { type MarkdownImageSourceAllowlist } from "./security";
+/**
+ * Creates the constrained element renderers used by Markdown.
+ *
+ * @param allowedImageSources - The consumer-owned image source allowlist.
+ * @param imageBaseUrl - The trusted base used to resolve relative sources.
+ * @param maxCodeHighlightLength - Maximum highlighted code-block length.
+ * @param maxCodeLineCount - Maximum individually rendered code-block lines.
+ * @param onAnchorClick - The handler for scoped in-document navigation.
+ *
+ * @returns Renderers composed from semantic Neatkit components.
+ */
+export declare function createMarkdownComponents(allowedImageSources: MarkdownImageSourceAllowlist | undefined, imageBaseUrl: string | undefined, maxCodeHighlightLength: number | null | undefined, maxCodeLineCount: number | null | undefined, onAnchorClick: MouseEventHandler<HTMLAnchorElement>): Components;

package/dist/components/Markdown/utils/security.d.ts

@@ -0,0 +1,66 @@
+import type { Root } from "hast";
+import { type Options as SanitizeSchema } from "rehype-sanitize";
+/** Options used to prefix public Markdown identifiers. */
+type MarkdownIdentifierOptions = {
+    /** The fixed security prefix applied by the final sanitizer. */
+    clobberPrefix: string;
+    /** The stable consumer-provided prefix prepended to every identifier. */
+    prefix: string;
+};
+/** The namespace preventing Markdown IDs from clobbering host globals. */
+export declare const MARKDOWN_CLOBBER_PREFIX = "md-";
+/** Sources a Markdown document may load as images. */
+export type MarkdownImageSourceAllowlist = "*" | RegExp | readonly RegExp[];
+/** The elements produced by the supported CommonMark and GFM syntax. */
+export declare const ALLOWED_MARKDOWN_ELEMENTS: readonly ["a", "blockquote", "br", "code", "del", "em", "h1", "h2", "h3", "h4", "h5", "h6", "hr", "img", "input", "li", "ol", "p", "picture", "pre", "section", "source", "strong", "sup", "table", "tbody", "td", "th", "thead", "tr", "ul"];
+/** The final sanitizer schema applied after all Markdown transformations. */
+export declare const MARKDOWN_SANITIZE_SCHEMA: SanitizeSchema;
+/**
+ * Resolves an image source through the consumer's explicit allowlist.
+ *
+ * Pattern policies inspect and return a normalized absolute URL. Relative and
+ * protocol-relative sources therefore require an explicit trusted base URL.
+ * The wildcard retains authored URLs after applying the protocol constraints.
+ *
+ * @param source - The safe source returned by React Markdown.
+ * @param allowedSources - The consumer-owned source allowlist.
+ * @param baseUrl - The trusted base used to resolve non-absolute sources.
+ *
+ * @returns The safe URL to render, or undefined when the source is blocked.
+ */
+export declare function resolveAllowedImageSource(source: string, allowedSources: MarkdownImageSourceAllowlist | undefined, baseUrl?: string): string | undefined;
+/**
+ * Filters one responsive image source list through the image URL policy.
+ *
+ * A malformed candidate invalidates the complete list instead of allowing the
+ * browser to select an unverified fallback.
+ *
+ * @param sourceSet - The comma-separated image candidates to validate.
+ * @param allowedSources - The consumer-owned source allowlist.
+ * @param baseUrl - The trusted base used to resolve non-absolute sources.
+ *
+ * @returns The safe normalized list, or undefined when a candidate is unsafe.
+ */
+export declare function sanitizeImageSourceSet(sourceSet: string | undefined, allowedSources: MarkdownImageSourceAllowlist | undefined, baseUrl?: string): string | undefined;
+/**
+ * Removes authored inputs while retaining inert GFM task-list controls.
+ *
+ * Rehype Raw preserves source positions on authored HTML elements, whereas
+ * Remark GFM creates its disabled task-list inputs without source positions.
+ *
+ * @returns A rehype transformer that prevents authored form controls.
+ */
+export declare function rehypeRemoveAuthoredInputs(): (tree: Root) => void;
+/**
+ * Prefixes IDs and their internal references before final sanitization.
+ *
+ * The public prefix is applied to declarations and references here. The final
+ * sanitizer adds the fixed clobber prefix to declarations and ARIA references,
+ * so local fragment links account for that prefix in advance.
+ *
+ * @param options - The fixed security prefix and public document prefix.
+ *
+ * @returns A rehype transformer that keeps declarations and references aligned.
+ */
+export declare function rehypePrefixMarkdownIdentifiers(options: MarkdownIdentifierOptions): (tree: Root) => void;
+export {};

package/dist/components/Table/Table.d.ts

@@ -12,8 +12,6 @@ export type TableProps = TableHTMLAttributes<HTMLTableElement> & {
     children: ReactNode;
     /** The additional class name applied to the horizontal scroll container. */
     containerClassName?: string;
-    /** The accessible label announced for the horizontal scroll container. */
-    scrollContainerLabel?: string;
 };
 /** A type representing properties for the Table.Head component. */
 export type TableHeadProps = HTMLAttributes<HTMLTableSectionElement> & {
@@ -35,20 +33,20 @@ export type TableFootProps = HTMLAttributes<HTMLTableSectionElement> & {
     children: ReactNode;
 };
 /** Shared native properties for every Table.Row configuration. */
-type TableRowBaseProps = Omit<HTMLAttributes<HTMLTableRowElement>, "children" | "onClick"> & {
+type TableRowBaseProps = Omit<HTMLAttributes<HTMLTableRowElement>, "aria-label" | "children" | "onClick"> & {
     /** The cells rendered inside the Table row. */
     children: ReactNode;
 };
 /** A type representing a static Table.Row configuration. */
 type TableStaticRowProps = {
+    /** The optional accessible name applied to the static row. */
+    "aria-label"?: string;
     /** Static rows do not expose download behavior. */
     download?: never;
     /** Static rows do not expose a navigation destination. */
     href?: never;
     /** Static rows do not describe a linked resource language. */
     hrefLang?: never;
-    /** Static rows do not require an action label. */
-    label?: never;
     /** Static rows do not expose whole-row activation. */
     onClick?: never;
     /** Static rows do not expose navigation interception. */
@@ -58,14 +56,14 @@ type TableStaticRowProps = {
 };
 /** A type representing a button-backed Table.Row configuration. */
 type TableButtonRowProps = {
+    /** The accessible name describing the whole-row action. */
+    "aria-label": string;
     /** Button-backed rows do not expose download behavior. */
     download?: never;
     /** Button-backed rows do not expose a navigation destination. */
     href?: never;
     /** Button-backed rows do not describe a linked resource language. */
     hrefLang?: never;
-    /** The accessible name describing the whole-row action. */
-    label: string;
     /** The callback invoked when the row's button is activated. */
     onClick: MouseEventHandler<HTMLButtonElement>;
     /** Button-backed rows do not expose navigation interception. */
@@ -75,14 +73,14 @@ type TableButtonRowProps = {
 };
 /** A type representing a link-backed Table.Row configuration. */
 type TableLinkRowProps = {
+    /** The accessible name describing the whole-row link. */
+    "aria-label": string;
     /** Whether the linked resource should be downloaded. */
     download?: boolean | string;
     /** The destination opened by whole-row activation. */
     href: string;
     /** The language of the linked resource. */
     hrefLang?: string;
-    /** The accessible name describing the whole-row link. */
-    label: string;
     /** Link-backed rows do not expose button activation. */
     onClick?: never;
     /** The callback invoked when the row's link is activated. */
@@ -279,8 +277,6 @@ declare const TableRoot: import("react").ForwardRefExoticComponent<TableHTMLAttr
     children: ReactNode;
     /** The additional class name applied to the horizontal scroll container. */
     containerClassName?: string;
-    /** The accessible label announced for the horizontal scroll container. */
-    scrollContainerLabel?: string;
 } & import("react").RefAttributes<HTMLTableElement>>;
 /** The compound Table component and its semantic subcomponents. */
 declare const Table: TableComponent;

package/dist/entries/code.d.ts

@@ -0,0 +1 @@
+export { Code, type CodeLanguage, type CodeProps, } from "../components/Code";

package/dist/entries/index.d.ts

@@ -0,0 +1,29 @@
+import "../style.css";
+export { breakpoint, cell, px, space, } from "../utils/units";
+export { tokens } from "../tokens";
+export type { BreakpointName, SpaceSize } from "../tokens";
+export { Alert, type AlertProps, type AlertTone, } from "../components/Alert";
+export { Avatar, type AvatarProps } from "../components/Avatar";
+export { Badge, type BadgeProps, type BadgeTone, type BadgeVariant, } from "../components/Badge";
+export { Button, type ButtonIconAlignment, type ButtonProps, type ButtonShape, type ButtonTextAlignment, type ButtonTone, type ButtonVariant, } from "../components/Button";
+export { Card, type CardHeader, type CardProps, type CardSpacing, } from "../components/Card";
+export { Checkbox, type CheckboxProps } from "../components/Checkbox";
+export { CheckboxGroup, type CheckboxGroupOrientation, type CheckboxGroupProps, } from "../components/CheckboxGroup";
+export { Content, type ContentMinHeight, type ContentMode, type ContentProps, type ContentSpacing, type ContentTheme, } from "../components/Content";
+export { Divider, type DividerOrientation, type DividerProps, } from "../components/Divider";
+export { Field, type FieldOrientation, type FieldProps, } from "../components/Field";
+export { Icon, type IconProps, type IconType } from "../components/Icon";
+export { Input, type InputProps, type InputType, } from "../components/Input";
+export { Modal, type ModalCloseReason, type ModalProps, } from "../components/Modal";
+export { Popover, type PopoverOpenChangeReason, type PopoverPlacement, type PopoverProps, } from "../components/Popover";
+export { PinInput, type PinInputMode, type PinInputProps, } from "../components/PinInput";
+export { Radio, type RadioProps } from "../components/Radio";
+export { RadioGroup, type RadioGroupOrientation, type RadioGroupProps, } from "../components/RadioGroup";
+export { Select, type CustomSelectProps, type NativeSelectProps, type SelectDisplayOverride, type SelectOption, type SelectProps, } from "../components/Select";
+export { Skeleton, type SkeletonProps, type SkeletonShape, } from "../components/Skeleton";
+export { Spinner, type SpinnerProps } from "../components/Spinner";
+export { Switch, type SwitchProps } from "../components/Switch";
+export { Table, type TableActionCellProps, type TableActionHeaderCellProps, type TableActionProps, type TableBodyProps, type TableCellAlignment, type TableCellProps, type TableCellValue, type TableFootProps, type TableHeaderCellProps, type TableHeadProps, type TableProps, type TableRowProps, } from "../components/Table";
+export { Text, type TextAlignment, type TextProps, type TextSize, type TextTone, type TextWeight, } from "../components/Text";
+export { TextArea, type TextAreaProps, type TextAreaResize, } from "../components/TextArea";
+export { Tooltip, type TooltipPlacement, type TooltipProps, TooltipProvider, type TooltipProviderProps, } from "../components/Tooltip";

package/dist/entries/markdown.d.ts

@@ -0,0 +1 @@
+export { Markdown, type MarkdownImageSourceAllowlist, type MarkdownProps, } from "../components/Markdown";