@rizom/brain-ui 0.0.0-stage → 0.2.0-alpha.650

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,63 @@
-# Temporary Holding Version
+# @rizom/brain-ui
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+React components for Rizom Brain sites and plugin views. They render with the
+selected theme's tokens (`text-theme`, `bg-theme-subtle`, `text-brand`), so a
+section built from them follows whichever theme the brain runs.
+
+## Install
+
+```bash
+bun add @rizom/brain-ui
+```
+
+`react` and `react-dom` are peer dependencies: the brain supplies the one React
+tree a site renders into.
+
+## Components
+
+| Export            | Renders                                                                                                                       |
+| ----------------- | ----------------------------------------------------------------------------------------------------------------------------- |
+| `Card`            | A card container, optionally a link (`href`), in a `vertical`, `horizontal` or `compact` variant                              |
+| `CardTitle`       | The card heading, optionally a link                                                                                           |
+| `CardMetadata`    | A metadata row under the title                                                                                                |
+| `TagsList`        | Tags as pills, truncated after `maxVisible`                                                                                   |
+| `MarkdownContent` | Markdown as sanitized prose; in a brain's site build, `entity://image/<id>` references render as the build's optimized images |
+| `formatDate`      | A date as `short`, `medium`, `long` or `full` text, in `en-US` and UTC, optionally with the time                              |
+
+Each component's props type is exported beside it (`CardProps`,
+`CardTitleProps`, `CardMetadataProps`, `TagsListProps`,
+`MarkdownContentProps`), as are `FormatDateOptions` and `DateFormatStyle`.
+
+```tsx
+import {
+  Card,
+  CardMetadata,
+  CardTitle,
+  MarkdownContent,
+  TagsList,
+  formatDate,
+} from "@rizom/brain-ui";
+
+export function BookmarkCard(props: {
+  title: string;
+  url: string;
+  savedAt: string;
+  tags: string[];
+  note: string;
+}) {
+  return (
+    <Card>
+      <CardTitle href={props.url}>{props.title}</CardTitle>
+      <CardMetadata>
+        Saved {formatDate(props.savedAt, { style: "medium" })}
+      </CardMetadata>
+      <TagsList tags={props.tags} />
+      <MarkdownContent markdown={props.note} />
+    </Card>
+  );
+}
+```
+
+## License
+
+Apache-2.0. See [`LICENSE`](./LICENSE).

package/dist/index.d.ts

@@ -0,0 +1,168 @@
+import { JSX, ReactNode } from "react";
+//#region src/variant-types.d.ts
+type VariantValue<T extends number | string> = T | null | undefined;
+//#endregion
+//#region src/Card.d.ts
+type CardVariant = "vertical" | "horizontal" | "compact";
+interface CardVariantProps {
+  variant?: VariantValue<CardVariant>;
+}
+interface CardProps extends CardVariantProps {
+  href?: string | undefined;
+  className?: string;
+  children: ReactNode;
+}
+/**
+ * Generic card container component used across blog posts, decks, links, and other content.
+ *
+ * Provides consistent styling with support for vertical (default), horizontal, and compact layouts.
+ * Can optionally be wrapped in a link for clickable cards.
+ *
+ * @example Vertical card (default)
+ * ```tsx
+ * <Card>
+ *   <CardImage src="..." alt="..." size="large" />
+ *   <CardTitle>Title</CardTitle>
+ *   <CardMetadata>Author • Date</CardMetadata>
+ * </Card>
+ * ```
+ *
+ * @example Horizontal card with link
+ * ```tsx
+ * <Card variant="horizontal" href="/post/slug">
+ *   <CardImage src="..." alt="..." size="small" />
+ *   <div>
+ *     <CardTitle>Title</CardTitle>
+ *     <CardMetadata>Metadata</CardMetadata>
+ *   </div>
+ * </Card>
+ * ```
+ */
+declare const Card: ({ href, variant, className, children }: CardProps) => JSX.Element;
+//#endregion
+//#region src/CardMetadata.d.ts
+interface CardMetadataProps {
+  children: ReactNode;
+  className?: string;
+}
+/**
+ * Flexible metadata container for card components.
+ *
+ * Provides consistent styling for metadata sections like dates, authors,
+ * tags, categories, or any other supplementary information.
+ *
+ * This is a generic container - plugins can compose it with their own
+ * specific metadata components (like PostMetadata, DeckMetadata, etc.)
+ *
+ * @example With PostMetadata
+ * ```tsx
+ * <CardMetadata>
+ *   <PostMetadata author="..." publishedAt="..." status="..." />
+ * </CardMetadata>
+ * ```
+ *
+ * @example With custom content
+ * ```tsx
+ * <CardMetadata>
+ *   <div className="text-sm text-brand">
+ *     Series: Ecosystem Architecture - Part 5
+ *   </div>
+ * </CardMetadata>
+ * ```
+ */
+declare const CardMetadata: ({ children, className }: CardMetadataProps) => JSX.Element;
+//#endregion
+//#region src/CardTitle.d.ts
+interface CardTitleProps {
+  href?: string;
+  children: ReactNode;
+  className?: string;
+}
+/**
+ * Card title component with optional link.
+ *
+ * Renders as a styled heading with consistent typography.
+ * If href is provided, wraps the title in a link with hover effects.
+ *
+ * @example Title without link
+ * ```tsx
+ * <CardTitle>My Post Title</CardTitle>
+ * ```
+ *
+ * @example Title with link
+ * ```tsx
+ * <CardTitle href="/posts/my-post">My Post Title</CardTitle>
+ * ```
+ */
+declare const CardTitle: ({ href, children, className }: CardTitleProps) => JSX.Element;
+//#endregion
+//#region src/MarkdownContent.d.ts
+interface MarkdownContentProps {
+  markdown: string;
+  className?: string;
+}
+/**
+ * Renders markdown content with image optimization support.
+ *
+ * Combines `markdownToHtml` conversion with `ProseContent` rendering.
+ * When rendered inside an `ImageRendererProvider` (during site builds),
+ * entity://image references are automatically resolved to optimized
+ * `<img srcset="...">` tags.
+ *
+ * Replaces the common pattern:
+ * ```tsx
+ * const htmlContent = markdownToHtml(post.body);
+ * <ProseContent html={htmlContent} />
+ * ```
+ *
+ * With:
+ * ```tsx
+ * <MarkdownContent markdown={post.body} />
+ * ```
+ */
+declare const MarkdownContent: ({ markdown, className }: MarkdownContentProps) => JSX.Element;
+//#endregion
+//#region src/TagsList.d.ts
+interface TagVariantProps {
+  variant?: VariantValue<"default" | "muted" | "accent">;
+  size?: VariantValue<"xs" | "sm" | "md" | "lg">;
+}
+interface TagsListProps extends TagVariantProps {
+  tags: string[];
+  maxVisible?: number;
+  className?: string;
+}
+/**
+ * TagsList component - displays a list of tags/keywords with optional truncation
+ *
+ * @example
+ * ```tsx
+ * <TagsList tags={link.keywords} maxVisible={4} />
+ * ```
+ */
+declare const TagsList: ({ tags, maxVisible, variant, size, className }: TagsListProps) => JSX.Element;
+//#endregion
+//#region src/utils/formatDate.d.ts
+type DateFormatStyle = "short" | "medium" | "long" | "full";
+interface FormatDateOptions {
+  style?: DateFormatStyle;
+  includeTime?: boolean;
+}
+/**
+ * Format a date string or Date object for display
+ *
+ * @param date - Date string or Date object to format
+ * @param options - Formatting options
+ * @returns Formatted date string
+ *
+ * @example
+ * ```tsx
+ * formatDate("2024-01-15") // "1/15/2024"
+ * formatDate("2024-01-15", { style: "medium" }) // "Jan 15, 2024"
+ * formatDate("2024-01-15", { style: "long" }) // "January 15, 2024"
+ * formatDate(date, { style: "long", includeTime: true }) // "January 15, 2024 at 3:30 PM"
+ * ```
+ */
+declare const formatDate: (date: string | Date, options?: FormatDateOptions) => string;
+//#endregion
+export { Card, CardMetadata, type CardMetadataProps, type CardProps, CardTitle, type CardTitleProps, type DateFormatStyle, type FormatDateOptions, MarkdownContent, type MarkdownContentProps, TagsList, type TagsListProps, formatDate };

package/dist/index.js

@@ -0,0 +1,349 @@
+// src/Card.tsx
+import { cva } from "class-variance-authority";
+
+// src/lib/utils.ts
+import { clsx } from "clsx";
+import { extendTailwindMerge } from "tailwind-merge";
+var twMerge = extendTailwindMerge({
+  extend: {
+    classGroups: {
+      "font-size": [
+        {
+          text: [
+            "display-2xl",
+            "display-xl",
+            "display-lg",
+            "display-md",
+            "display-sm",
+            "heading-lg",
+            "heading-md",
+            "heading-sm",
+            "body-xl",
+            "body-lg",
+            "body-md",
+            "body-sm",
+            "body-xs",
+            "label-md",
+            "label-sm",
+            "label-xs"
+          ]
+        }
+      ]
+    }
+  }
+});
+function cn(...inputs) {
+  return twMerge(clsx(inputs));
+}
+
+// src/Card.tsx
+import { jsx } from "react/jsx-runtime";
+var cardVariants = cva("bg-theme-subtle rounded-lg border border-theme hover:shadow-lg transition-shadow", {
+  variants: {
+    variant: {
+      vertical: "flex flex-col p-6",
+      horizontal: "flex flex-col sm:flex-row items-start gap-4 p-6",
+      compact: "flex flex-col p-4"
+    }
+  },
+  defaultVariants: {
+    variant: "vertical"
+  }
+});
+var Card = ({
+  href,
+  variant,
+  className,
+  children
+}) => {
+  const classes = cn(cardVariants({ variant }), className);
+  if (href) {
+    return /* @__PURE__ */ jsx("article", {
+      className: cn(classes, "group"),
+      children: /* @__PURE__ */ jsx("a", {
+        href,
+        className: "contents",
+        children
+      })
+    });
+  }
+  return /* @__PURE__ */ jsx("article", {
+    className: classes,
+    children
+  });
+};
+// src/CardMetadata.tsx
+import { jsx as jsx2 } from "react/jsx-runtime";
+var CardMetadata = ({
+  children,
+  className
+}) => {
+  return /* @__PURE__ */ jsx2("div", {
+    className: cn("mb-3", className),
+    children
+  });
+};
+// src/CardTitle.tsx
+import { jsx as jsx3 } from "react/jsx-runtime";
+var CardTitle = ({
+  href,
+  children,
+  className
+}) => {
+  const baseClasses = cn("text-2xl font-semibold mb-2 text-theme", className);
+  if (href) {
+    return /* @__PURE__ */ jsx3("h2", {
+      className: baseClasses,
+      children: /* @__PURE__ */ jsx3("a", {
+        href,
+        className: "hover:text-brand",
+        children
+      })
+    });
+  }
+  return /* @__PURE__ */ jsx3("h2", {
+    className: baseClasses,
+    children
+  });
+};
+// src/ProseContent.tsx
+import { jsx as jsx4 } from "react/jsx-runtime";
+var ProseContent = ({
+  html,
+  className
+}) => {
+  return /* @__PURE__ */ jsx4("article", {
+    className: cn(`prose prose-lg max-w-none
+        prose-h1:text-4xl prose-h1:font-bold prose-h1:mb-8 prose-h1:mt-0
+        prose-h2:text-3xl prose-h2:font-semibold prose-h2:mt-16 prose-h2:mb-6 prose-h2:border-b prose-h2:pb-4
+        prose-h3:text-2xl prose-h3:font-semibold prose-h3:mt-10 prose-h3:mb-4
+        prose-p:text-lg prose-p:leading-relaxed prose-p:mb-6
+        prose-ul:my-6 prose-ul:space-y-3
+        prose-ol:my-6 prose-ol:space-y-3
+        prose-li:leading-relaxed
+        prose-code:px-1.5 prose-code:py-0.5 prose-code:rounded prose-code:text-sm prose-code:font-mono
+        prose-pre:rounded-lg prose-pre:my-6 prose-pre:p-4 prose-pre:overflow-x-auto prose-pre:text-sm
+        prose-blockquote:border-l-2 prose-blockquote:border-brand prose-blockquote:pl-6 prose-blockquote:py-2 prose-blockquote:mt-8 prose-blockquote:mb-2 prose-blockquote:text-lg prose-blockquote:leading-relaxed prose-blockquote:font-light prose-blockquote:not-italic
+        prose-hr:my-12
+        prose-img:rounded-lg prose-img:shadow-md prose-img:my-8`, className),
+    dangerouslySetInnerHTML: { __html: html }
+  });
+};
+
+// src/ImageRendererProvider.tsx
+import { createElement as h } from "react";
+import { useContext } from "react";
+
+// src/markdown-html.ts
+import { Marked } from "marked";
+import sanitizeHtml from "sanitize-html";
+var defaultMarked = new Marked({ gfm: true, breaks: true });
+var SANITIZE_OPTIONS = {
+  allowedTags: [
+    "h1",
+    "h2",
+    "h3",
+    "h4",
+    "h5",
+    "h6",
+    "p",
+    "br",
+    "hr",
+    "ul",
+    "ol",
+    "li",
+    "blockquote",
+    "cite",
+    "code",
+    "pre",
+    "em",
+    "strong",
+    "del",
+    "ins",
+    "sub",
+    "sup",
+    "a",
+    "img",
+    "span",
+    "table",
+    "thead",
+    "tbody",
+    "tr",
+    "th",
+    "td",
+    "div"
+  ],
+  allowedAttributes: {
+    a: ["href", "title", "name"],
+    img: [
+      "src",
+      "srcset",
+      "sizes",
+      "alt",
+      "title",
+      "width",
+      "height",
+      "class",
+      "loading",
+      "decoding"
+    ],
+    code: ["class"],
+    pre: ["class"],
+    span: ["class"],
+    cite: ["class"],
+    div: ["class"],
+    th: ["align", "colspan", "rowspan", "scope"],
+    td: ["align", "colspan", "rowspan"]
+  },
+  allowedSchemes: ["http", "https", "mailto", "tel"],
+  allowedSchemesByTag: {
+    img: ["http", "https", "entity"]
+  },
+  allowProtocolRelative: false,
+  disallowedTagsMode: "discard"
+};
+function markdownToHtml(markdown, options) {
+  const { imageRenderer } = options ?? {};
+  const instance = imageRenderer ? new Marked({ gfm: true, breaks: true }).use({
+    renderer: {
+      image({ href, title, text }) {
+        return imageRenderer({
+          href,
+          alt: text,
+          ...title !== null ? { title } : {}
+        }) ?? false;
+      }
+    }
+  }) : defaultMarked;
+  const parsed = instance.parse(markdown);
+  if (typeof parsed !== "string") {
+    throw new Error("Markdown renderer received an async marked result");
+  }
+  let html = parsed;
+  html = html.replace(/<\/blockquote>\s*<p>(—|--|–)([\s\S]*?)<\/p>/g, `</blockquote>
+<cite class="block-attribution"><span class="emdash">$1</span>$2</cite>`);
+  return sanitizeHtml(html, SANITIZE_OPTIONS);
+}
+
+// src/shared-context.ts
+import { createContext } from "react";
+function sharedContext(key, defaultValue) {
+  const symbol = Symbol.for(`@rizom/brain-ui/${key}`);
+  const existing = Reflect.get(globalThis, symbol);
+  if (existing !== undefined) {
+    return existing;
+  }
+  const context = createContext(defaultValue);
+  Object.defineProperty(globalThis, symbol, {
+    value: context,
+    enumerable: false,
+    configurable: false,
+    writable: false
+  });
+  return context;
+}
+
+// src/ImageRendererProvider.tsx
+var ImageRendererContext = sharedContext("image-renderer@1", null);
+function useImageRenderer() {
+  return useContext(ImageRendererContext);
+}
+function useMarkdownToHtml() {
+  const imageRenderer = useImageRenderer();
+  return (markdown) => markdownToHtml(markdown, imageRenderer ? { imageRenderer } : undefined);
+}
+
+// src/MarkdownContent.tsx
+import { jsx as jsx5 } from "react/jsx-runtime";
+var MarkdownContent = ({
+  markdown,
+  className
+}) => {
+  const toHtml = useMarkdownToHtml();
+  return /* @__PURE__ */ jsx5(ProseContent, {
+    html: toHtml(markdown),
+    ...className && { className }
+  });
+};
+// src/TagsList.tsx
+import { cva as cva2 } from "class-variance-authority";
+import { jsx as jsx6, jsxs } from "react/jsx-runtime";
+var tagVariants = cva2("rounded-full", {
+  variants: {
+    variant: {
+      default: "bg-theme-muted text-theme",
+      muted: "bg-theme text-theme-muted",
+      accent: "bg-accent/10 text-accent"
+    },
+    size: {
+      xs: "text-xs px-2 py-1",
+      sm: "text-sm px-3 py-1",
+      md: "text-sm px-3 py-1 font-medium",
+      lg: "text-sm px-4 py-2 font-medium"
+    }
+  },
+  defaultVariants: {
+    variant: "default",
+    size: "xs"
+  }
+});
+var TagsList = ({
+  tags,
+  maxVisible = 5,
+  variant,
+  size,
+  className
+}) => {
+  const visibleTags = tags.slice(0, maxVisible);
+  const remainingCount = tags.length - maxVisible;
+  return /* @__PURE__ */ jsxs("div", {
+    className: cn("flex flex-wrap gap-2", className),
+    children: [
+      visibleTags.map((tag) => /* @__PURE__ */ jsx6("span", {
+        className: cn(tagVariants({ variant, size })),
+        children: tag
+      }, tag)),
+      remainingCount > 0 && /* @__PURE__ */ jsxs("span", {
+        className: cn(tagVariants({ size }), "bg-transparent text-theme-muted"),
+        children: [
+          "+",
+          remainingCount,
+          " more"
+        ]
+      })
+    ]
+  });
+};
+// src/utils/formatDate.ts
+var LOCALE = "en-US";
+var TIME_ZONE = "UTC";
+var STYLE_OPTIONS = {
+  short: { year: "numeric", month: "numeric", day: "numeric" },
+  medium: { year: "numeric", month: "short", day: "numeric" },
+  long: { year: "numeric", month: "long", day: "numeric" },
+  full: { weekday: "long", year: "numeric", month: "long", day: "numeric" }
+};
+var formatDate = (date, options = {}) => {
+  const { style = "short", includeTime = false } = options;
+  const dateObj = typeof date === "string" ? new Date(date) : date;
+  if (includeTime) {
+    return dateObj.toLocaleString(LOCALE, {
+      ...STYLE_OPTIONS[style],
+      hour: "numeric",
+      minute: "2-digit",
+      timeZone: TIME_ZONE
+    });
+  }
+  return dateObj.toLocaleDateString(LOCALE, {
+    ...STYLE_OPTIONS[style],
+    timeZone: TIME_ZONE
+  });
+};
+export {
+  Card,
+  CardMetadata,
+  CardTitle,
+  MarkdownContent,
+  TagsList,
+  formatDate
+};

package/package.json

@@ -1,6 +1,54 @@
 {
   "name": "@rizom/brain-ui",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0-alpha.650",
+  "description": "React components for Rizom Brain sites and plugin views",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "bun scripts/build.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "lint": "eslint . --max-warnings 0",
+    "lint:fix": "eslint . --max-warnings 0 --fix",
+    "prepack": "publish-manifest prepare",
+    "prepublishOnly": "bun scripts/build.ts"
+  },
+  "dependencies": {
+    "class-variance-authority": "^0.7.0",
+    "clsx": "^2.1.0",
+    "marked": "^18.0.5",
+    "sanitize-html": "^2.18.0",
+    "tailwind-merge": "^3.6.0"
+  },
+  "peerDependencies": {
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rizom-ai/brains.git",
+    "directory": "packages/ui"
+  },
+  "license": "Apache-2.0",
+  "author": "Yeehaa <yeehaa@rizom.ai> (https://rizom.ai)",
+  "homepage": "https://github.com/rizom-ai/brains/tree/main/packages/ui#readme",
+  "bugs": {
+    "url": "https://github.com/rizom-ai/brains/issues"
+  },
+  "engines": {
+    "bun": ">=1.3.3"
+  }
+}