@k2b/ui 0.13.0 → 0.14.0

package/dist/types/content/MarkdownView.d.ts

@@ -26,14 +26,18 @@ export type MarkdownRenderOptions = {
     /** Optional protocol allowlist, including trailing colons. Relative URLs resolve as HTTPS. */
     linkProtocols?: readonly string[];
     linkTarget?: "_blank";
+    /** Locale for the screen-reader names of untitled info blocks. `MarkdownView` passes the inherited render locale. */
+    locale?: string;
 };
 export declare const renderSafeMarkdown: (markdown: string, options?: MarkdownRenderOptions) => string;
 /**
  * Markdown View Component (SSR)
  *
  * Renders untrusted Markdown safely by default. Raw HTML and unsafe link
- * protocols are escaped. Already-rendered HTML requires the deliberately named
- * `trustedHtml` boundary; the caller owns sanitization in that mode.
+ * protocols are escaped. Info blocks (`:::note`, `:::info`, `:::success`,
+ * `:::warning`, `:::danger`) render as the calm `NoticeCard`. Already-rendered
+ * HTML requires the deliberately named `trustedHtml` boundary; the caller owns
+ * sanitization in that mode.
  *
  * @example
  * ```tsx

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

@@ -31,6 +31,7 @@ export { default as Lightbox } from "./Lightbox";
 export type { LogTableEntry } from "./LogEntriesTable";
 export { default as LogEntriesTable } from "./LogEntriesTable";
 export { default as MarkdownView, type MarkdownRenderOptions, type MarkdownViewProps, renderSafeMarkdown } from "./MarkdownView";
+export { type MarkdownInfoBlock, type MarkdownInfoBlockRenderInput, type MarkdownInfoBlockType, markdownInfoBlocks, renderMarkdownInfoBlock, scanMarkdownInfoBlock, } from "./markdown-info-blocks";
 export { Pagination, type PaginationProps } from "./Pagination";
 export type { PdfPreviewProps, PdfPreviewRequest } from "./PdfPreview";
 export { default as PdfPreview } from "./PdfPreview";

package/dist/types/content/markdown-info-blocks.d.ts

@@ -0,0 +1,67 @@
+import { type MarkedExtension } from "marked";
+/**
+ * Markdown info blocks: one grammar and one look for every Markdown surface.
+ *
+ * ```markdown
+ * :::warning Before deleting
+ * Deleting an item cannot be undone.
+ * :::
+ * ```
+ *
+ * The opening line holds `:::`, a type in any letter case, and an optional
+ * plain-text title. The block ends at a line holding only `:::`, indented no
+ * deeper than the opener; code, lists, quotes, and HTML inside the body cannot
+ * end it. The body is ordinary Markdown. A block that is never closed stays
+ * ordinary text.
+ */
+declare const TONES: {
+    readonly note: "neutral";
+    readonly info: "info";
+    readonly success: "success";
+    readonly warning: "warning";
+    readonly danger: "danger";
+};
+export type MarkdownInfoBlockType = keyof typeof TONES;
+export type MarkdownInfoBlock = {
+    type: MarkdownInfoBlockType;
+    /** Plain-text title from the opening line. */
+    title?: string;
+    /** Raw Markdown between the opening and closing lines, with `\n` line breaks. */
+    body: string;
+    /** Source length through the closing line, or the whole source when the block is not closed. */
+    length: number;
+    closed: boolean;
+};
+export type MarkdownInfoBlockRenderInput = {
+    type: MarkdownInfoBlockType;
+    title?: string;
+    /** Already rendered body HTML. The caller owns its sanitization. */
+    bodyHtml: string;
+    /** Locale for the screen-reader name of an untitled block. */
+    locale?: string;
+};
+/**
+ * Reads the info block that starts `source`. Returns `null` when the first
+ * line is not an info-block opener. Applications with their own Markdown
+ * pipeline use this to recognize exactly the blocks `MarkdownView` renders.
+ * Any line endings are accepted; `length` counts `source` as given.
+ */
+export declare const scanMarkdownInfoBlock: (source: string) => MarkdownInfoBlock | null;
+/**
+ * Renders an info block as the calm `NoticeCard`: the tone tints the surface,
+ * the text stays neutral, and there is no icon. A title is the visible heading
+ * and names the block; without one, the localized type name is announced to
+ * screen readers only.
+ */
+export declare const renderMarkdownInfoBlock: (input: MarkdownInfoBlockRenderInput) => string;
+/**
+ * `marked` extension for info blocks at the top level of a document. Blocks
+ * inside lists, quotes, or another block stay ordinary text. The body goes
+ * through the host's own Markdown renderer, so its escaping and link rules
+ * apply unchanged. Locales that share a UI message catalog get the same
+ * extension, so a host may cache one `marked` instance per extension.
+ */
+export declare const markdownInfoBlocks: (options?: {
+    locale?: string;
+}) => MarkedExtension;
+export {};

package/dist/types/intl/messages.d.ts

@@ -33,6 +33,11 @@ declare const uiMessages: import("@k2b/stdlib").Catalog<{
     close: string;
     closeDialog: string;
     copied: string;
+    infoBlockNote: string;
+    infoBlockInfo: string;
+    infoBlockSuccess: string;
+    infoBlockWarning: string;
+    infoBlockDanger: string;
     copy: string;
     closeLightbox: string;
     couldNotLoadData: string;

package/dist/types/layout/TabBar.d.ts

@@ -5,6 +5,8 @@ export type TabBarItem = {
     /** Icon class, for example `ti ti-home`. */
     icon: string;
     href: string;
+    /** The header title of the page this item opens, shown while that page loads. Defaults to `label`. */
+    title?: string;
     /** The page this item leads to is open. */
     current?: boolean;
 };
@@ -17,7 +19,8 @@ export type TabBarProps = {
 };
 /**
  * Bottom navigation between a phone app's top-level pages: native links with equal widths, an icon above each label,
- * and `aria-current="page"` on the open page. Place it in `MobileShell`'s footer; it pads the bottom safe area.
+ * and `aria-current="page"` on the open page. Place it in `MobileShell`'s footer; it pads the bottom safe area. There a
+ * tab switches at the first touch: the shell shows the item's `title` while its page loads.
  */
 export declare function TabBar(props: TabBarProps): JSX.Element;
 export default TabBar;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k2b/ui",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Production-ready components for SolidJS applications.",
   "repository": {
     "type": "git",