@agentick/core 0.0.1

package/dist/jsx/components/model.js

@@ -0,0 +1,96 @@
+/**
+ * Model component - React function component version.
+ *
+ * Uses React hooks (useEffect) for lifecycle instead of Agentick Component class.
+ */
+import React, { useEffect, useDebugValue } from "react";
+import { useCom } from "../../hooks/context";
+// Helper for createElement
+const h = React.createElement;
+/**
+ * Model component that dynamically sets the model adapter for the current execution.
+ *
+ * Model is a configuration component - it sets which model adapter to use.
+ * It does NOT contain content (messages, timeline entries, etc.).
+ *
+ * When mounted, sets the model on the COM.
+ * When unmounted, clears the model.
+ *
+ * @example
+ * ```tsx
+ * <>
+ *   <Model model={myModel} />
+ *   <Message role="user" content="Hello" />
+ * </>
+ * ```
+ */
+export function Model(props) {
+    const { model, onMount, onUnmount, ...options } = props;
+    const ctx = useCom();
+    // Debug value shows model identifier for React DevTools
+    useDebugValue(typeof model === "string"
+        ? `Model: ${model}`
+        : `Model: ${model.metadata?.id ?? "custom"}`);
+    // Set model on mount, clear on unmount
+    useEffect(() => {
+        ctx.setModel(model);
+        ctx.resetModelOptions();
+        // Register token estimator if adapter provides one
+        const resolvedModel = typeof model === "string" ? null : model;
+        if (resolvedModel?.metadata?.tokenEstimator) {
+            ctx.setTokenEstimator(resolvedModel.metadata.tokenEstimator);
+        }
+        // Call user's onMount if provided
+        if (onMount) {
+            const result = onMount(ctx);
+            if (result instanceof Promise) {
+                result.catch(() => { }); // Fire and forget
+            }
+        }
+        return () => {
+            ctx.unsetModel();
+            // Call user's onUnmount if provided
+            if (onUnmount) {
+                const result = onUnmount(ctx);
+                if (result instanceof Promise) {
+                    result.catch(() => { }); // Fire and forget
+                }
+            }
+        };
+    }, [model, ctx, onMount, onUnmount]);
+    // Set model options during render
+    useEffect(() => {
+        ctx.setModelOptions(options);
+    }, [ctx, options]);
+    // Model is configuration-only - doesn't render anything
+    return h(React.Fragment, null);
+}
+// Export ModelComponent as an alias for backwards compatibility in type detection
+export const ModelComponent = Model;
+/**
+ * ModelOptions component for configuring how content is transformed for model input.
+ *
+ * @example
+ * ```tsx
+ * <ModelOptions
+ *   messageTransformation={{
+ *     roleMapping: {
+ *       event: 'user',
+ *       ephemeral: 'user',
+ *     },
+ *   }}
+ * />
+ * ```
+ */
+export function ModelOptions(props) {
+    const ctx = useCom();
+    // Set model options during render
+    useEffect(() => {
+        ctx.setModelOptions(props);
+    }, [ctx, props]);
+    // ModelOptions is configuration-only - doesn't render anything
+    return h(React.Fragment, null);
+}
+// Export ModelOptionsComponent as an alias for backwards compatibility
+export const ModelOptionsComponent = ModelOptions;
+//# sourceMappingURL=model.js.map

package/dist/jsx/components/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../src/jsx/components/model.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAO7C,2BAA2B;AAC3B,MAAM,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC;AA8B9B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,KAAK,CAAC,KAA0B;IAC9C,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,CAAC;IACxD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IAErB,wDAAwD;IACxD,aAAa,CACX,OAAO,KAAK,KAAK,QAAQ;QACvB,CAAC,CAAC,UAAU,KAAK,EAAE;QACnB,CAAC,CAAC,UAAW,KAAa,CAAC,QAAQ,EAAE,EAAE,IAAI,QAAQ,EAAE,CACxD,CAAC;IAEF,uCAAuC;IACvC,SAAS,CAAC,GAAG,EAAE;QACb,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACpB,GAAG,CAAC,iBAAiB,EAAE,CAAC;QAExB,mDAAmD;QACnD,MAAM,aAAa,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;QAC/D,IAAI,aAAa,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;YAC5C,GAAG,CAAC,iBAAiB,CAAC,aAAa,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QAC/D,CAAC;QAED,kCAAkC;QAClC,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;gBAC9B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC,kBAAkB;YAC5C,CAAC;QACH,CAAC;QAED,OAAO,GAAG,EAAE;YACV,GAAG,CAAC,UAAU,EAAE,CAAC;YAEjB,oCAAoC;YACpC,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;gBAC9B,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;oBAC9B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC,kBAAkB;gBAC5C,CAAC;YACH,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;IAErC,kCAAkC;IAClC,SAAS,CAAC,GAAG,EAAE;QACb,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IAEnB,wDAAwD;IACxD,OAAO,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC;AA+BpC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IAErB,kCAAkC;IAClC,SAAS,CAAC,GAAG,EAAE;QACb,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;IAEjB,+DAA+D;IAC/D,OAAO,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,uEAAuE;AACvE,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAY,CAAC"}

package/dist/jsx/components/primitives.d.ts

@@ -0,0 +1,117 @@
+import type { ContentBlock, Message, MessageRoles } from "@agentick/shared";
+import type { JSX } from "react";
+import type { JSX as AgentickJSX } from "../jsx-runtime";
+import type { StreamEvent } from "../../engine/engine-events";
+import type { ComponentBaseProps } from "../jsx-types";
+export { Timeline, useTimelineContext } from "./timeline";
+export type { TimelineProps, TimelineRenderFn, TimelineContextValue } from "./timeline";
+/**
+ * Entry primitive component.
+ * Foundational structural primitive for timeline entries only.
+ * Uses discriminated union based on kind to determine data structure.
+ *
+ * Usage:
+ *   <Entry kind="message" message={{ role: 'user', content: [...] }} />
+ *   <Entry kind="event" event={{ type: 'user_action', data: {...} }} />
+ */
+/**
+ * Map of entry kinds to their specific data structures.
+ * This can be extended via module augmentation:
+ *
+ * declare module './primitives' {
+ *   interface EntryKindMap {
+ *     customKind: { customProp: string };
+ *   }
+ * }
+ */
+export interface EntryKindMap {
+    message: Message;
+    event: StreamEvent;
+}
+/**
+ * Union of all entry kinds.
+ * Automatically includes all keys from EntryKindMap.
+ */
+export type EntryKind = keyof EntryKindMap;
+/**
+ * Common props shared by all entry types.
+ */
+export interface EntryCommonProps {
+    id?: string;
+    visibility?: "model" | "observer" | "log";
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+    children?: any;
+    formattedContent?: ContentBlock[];
+}
+/**
+ * Entry primitive component props.
+ * Uses mapped type to create discriminated union from EntryKindMap.
+ *
+ * The structure ensures that:
+ * - kind="message" requires a `message` property with message-specific data
+ * - kind="event" requires an `event` property with event-specific data
+ *
+ * Usage:
+ *   <Entry kind="message" message={{ role: 'user', content: [...] }} />
+ *   <Entry kind="event" event={{ type: 'user_action', data: {...} }} />
+ *
+ * TypeScript will enforce type safety based on the `kind` discriminator.
+ */
+export type EntryProps = {
+    [K in EntryKind]: {
+        kind: K;
+    } & {
+        [P in K]: EntryKindMap[K];
+    } & EntryCommonProps;
+}[EntryKind];
+export declare function Entry(props: EntryProps): JSX.Element;
+/**
+ * Section primitive component.
+ * When used in JSX: <Section id="..." content="..." />
+ * Returns an intrinsic "section" element for react-reconciler compatibility.
+ */
+export declare function Section(props: AgentickJSX.IntrinsicElements["section"]): JSX.Element;
+/**
+ * Message primitive component props.
+ * Allows spreading Message objects directly, plus JSX-specific props.
+ *
+ * Uses intersection to accept both Message shape and JSX convenience props.
+ *
+ * Usage:
+ *   <Message role="user">Hello</Message>
+ *   <Message {...messageObject} tags={['important']} />
+ */
+export type MessageProps = Partial<Omit<Message, "content" | "role">> & {
+    role: MessageRoles;
+    content?: string | any[] | Message["content"];
+    tags?: string[];
+    visibility?: "model" | "observer" | "log";
+    children?: any;
+} & ComponentBaseProps;
+/**
+ * Message primitive component.
+ * Semantic sugar wrapper that wraps Entry with kind="message" for intuitive API.
+ *
+ * Accepts Message objects via spreading, converts to Entry structure.
+ *
+ * Usage:
+ *   <Message role="user">Hello</Message>
+ *   <Message {...messageFromTimeline} tags={['important']} />
+ * Compiles to: <Entry kind="message" message={{ role: 'user', content: [...] }} />
+ */
+export declare function Message(props: MessageProps): JSX.Element;
+/**
+ * Tool primitive component.
+ * When used in JSX: <Tool definition={myTool} />
+ */
+export declare function Tool(props: AgentickJSX.IntrinsicElements["tool"]): JSX.Element;
+export { Model, ModelOptions } from "./model";
+export type { ModelComponentProps, ModelOptionsProps } from "./model";
+export { Markdown } from "./markdown";
+export { H1, H2, H3, Header, Paragraph, List, ListItem, Table, Row, Column } from "./semantic";
+export { User, Assistant, System, ToolResult, Event, Ephemeral, Grounding } from "./messages";
+export type { UserProps, AssistantProps, SystemProps, ToolResultProps, EventProps, EphemeralProps, GroundingProps, EphemeralPosition, RoleMessageBaseProps, } from "./messages";
+export { UserAction, SystemEvent, StateChange } from "./messages";
+export type { UserActionProps, SystemEventProps, StateChangeProps } from "./messages";
+//# sourceMappingURL=primitives.d.ts.map

package/dist/jsx/components/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../src/jsx/components/primitives.ts"],"names":[],"mappings":"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"}

package/dist/jsx/components/primitives.js

@@ -0,0 +1,83 @@
+import React, { useDebugValue } from "react";
+// Helper for createElement
+const h = React.createElement;
+// Re-export Timeline component from timeline.tsx
+export { Timeline, useTimelineContext } from "./timeline";
+export function Entry(props) {
+    // Use intrinsic "entry" element for react-reconciler compatibility
+    // The reconciler's hostConfig will create a AgentickNode for this
+    // Type assertion needed because React.createElement doesn't handle discriminated unions well
+    return h("entry", props);
+}
+/**
+ * Section primitive component.
+ * When used in JSX: <Section id="..." content="..." />
+ * Returns an intrinsic "section" element for react-reconciler compatibility.
+ */
+export function Section(props) {
+    // Debug value shows section title for React DevTools
+    useDebugValue(`Section: ${props.title ?? props.id ?? "untitled"}`);
+    // Use intrinsic "section" element for react-reconciler compatibility
+    return h("section", props);
+}
+/**
+ * Message primitive component.
+ * Semantic sugar wrapper that wraps Entry with kind="message" for intuitive API.
+ *
+ * Accepts Message objects via spreading, converts to Entry structure.
+ *
+ * Usage:
+ *   <Message role="user">Hello</Message>
+ *   <Message {...messageFromTimeline} tags={['important']} />
+ * Compiles to: <Entry kind="message" message={{ role: 'user', content: [...] }} />
+ */
+export function Message(props) {
+    const { role, content, children, id, metadata, tags, visibility, createdAt, updatedAt, ...rest } = props;
+    // Debug value shows role and content preview for React DevTools
+    const preview = typeof content === "string"
+        ? content.slice(0, 30) + (content.length > 30 ? "..." : "")
+        : children
+            ? "[children]"
+            : "[empty]";
+    useDebugValue(`${role}: ${preview}`);
+    // Convert MessageProps to Message structure for EntryKindMap
+    // If content is already ContentBlock[], use it; otherwise renderer will convert children
+    const message = {
+        role,
+        content: content || [], // Will be converted to ContentBlock[] by renderer if needed
+        id,
+        metadata,
+        createdAt,
+        updatedAt,
+    };
+    return h(Entry, {
+        kind: "message",
+        message,
+        tags, // Entry-level props
+        visibility, // Entry-level props
+        ...rest,
+        children, // Pass children through - renderer will collect them into message.content
+    });
+}
+/**
+ * Tool primitive component.
+ * When used in JSX: <Tool definition={myTool} />
+ */
+export function Tool(props) {
+    // Debug value shows tool name for React DevTools
+    useDebugValue(`Tool: ${props.name ?? "unnamed"}`);
+    // Use intrinsic "tool" element for react-reconciler compatibility
+    return h("tool", props);
+}
+// Re-export Model components
+export { Model, ModelOptions } from "./model";
+// Re-export Markdown component
+export { Markdown } from "./markdown";
+// Re-export semantic primitives
+export { H1, H2, H3, Header, Paragraph, List, ListItem, Table, Row, Column } from "./semantic";
+// Re-export message role components
+export { User, Assistant, System, ToolResult, Event, Ephemeral, Grounding } from "./messages";
+// Re-export event block components
+export { UserAction, SystemEvent, StateChange } from "./messages";
+// Fragment is already exported from jsx-runtime but we can re-export or use <>
+//# sourceMappingURL=primitives.js.map

package/dist/jsx/components/primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../../../src/jsx/components/primitives.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAM7C,2BAA2B;AAC3B,MAAM,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC;AAE9B,iDAAiD;AACjD,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAmE1D,MAAM,UAAU,KAAK,CAAC,KAAiB;IACrC,mEAAmE;IACnE,kEAAkE;IAClE,6FAA6F;IAC7F,OAAO,CAAC,CAAC,OAAO,EAAE,KAAY,CAAC,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,KAA+C;IACrE,qDAAqD;IACrD,aAAa,CAAC,YAAY,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,EAAE,IAAI,UAAU,EAAE,CAAC,CAAC;IACnE,qEAAqE;IACrE,OAAO,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AAC7B,CAAC;AAoBD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,OAAO,CAAC,KAAmB;IACzC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAC9F,KAAK,CAAC;IAER,gEAAgE;IAChE,MAAM,OAAO,GACX,OAAO,OAAO,KAAK,QAAQ;QACzB,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,CAAC,CAAC,QAAQ;YACR,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,SAAS,CAAC;IAClB,aAAa,CAAC,GAAG,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;IAErC,6DAA6D;IAC7D,yFAAyF;IACzF,MAAM,OAAO,GAAY;QACvB,IAAI;QACJ,OAAO,EAAG,OAA8B,IAAI,EAAE,EAAE,4DAA4D;QAC5G,EAAE;QACF,QAAQ;QACR,SAAS;QACT,SAAS;KACV,CAAC;IAEF,OAAO,CAAC,CAAC,KAAK,EAAE;QACd,IAAI,EAAE,SAAS;QACf,OAAO;QACP,IAAI,EAAE,oBAAoB;QAC1B,UAAU,EAAE,oBAAoB;QAChC,GAAG,IAAI;QACP,QAAQ,EAAE,0EAA0E;KACrF,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,IAAI,CAAC,KAA4C;IAC/D,iDAAiD;IACjD,aAAa,CAAC,SAAS,KAAK,CAAC,IAAI,IAAI,SAAS,EAAE,CAAC,CAAC;IAClD,kEAAkE;IAClE,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,6BAA6B;AAC7B,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG9C,+BAA+B;AAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,gCAAgC;AAChC,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAE/F,oCAAoC;AACpC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAa9F,mCAAmC;AACnC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGlE,+EAA+E"}

package/dist/jsx/components/renderer.d.ts

@@ -0,0 +1,24 @@
+import type { JSX } from "react";
+import { type ComponentBaseProps } from "../jsx-types";
+import type { ContentRenderer } from "../../renderers";
+/**
+ * Generic Renderer component.
+ * Wraps children to apply a specific ContentRenderer.
+ *
+ * This is the base component that Markdown, XML, and other renderer
+ * wrappers use internally. You can also use it directly for custom renderers:
+ *
+ * @example
+ * ```tsx
+ * <Renderer instance={new MyCustomRenderer()}>
+ *   <Message>Content</Message>
+ * </Renderer>
+ * ```
+ */
+export interface RendererProps extends ComponentBaseProps {
+    /** The renderer instance to apply to children */
+    instance: ContentRenderer;
+    children?: any;
+}
+export declare function Renderer(props: RendererProps): JSX.Element;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/jsx/components/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../../src/jsx/components/renderer.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAKvD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,aAAc,SAAQ,kBAAkB;IACvD,iDAAiD;IACjD,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,GAAG,CAAC,OAAO,CAK1D"}

package/dist/jsx/components/renderer.js

@@ -0,0 +1,11 @@
+import React from "react";
+import {} from "../jsx-types";
+// Helper for createElement
+const h = React.createElement;
+export function Renderer(props) {
+    // Renderer is a context provider - doesn't render itself
+    // The compiler detects this and applies the renderer to children
+    // We return Fragment but preserve the instance prop for detection
+    return h(React.Fragment, props);
+}
+//# sourceMappingURL=renderer.js.map

package/dist/jsx/components/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../../src/jsx/components/renderer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAA2B,MAAM,cAAc,CAAC;AAGvD,2BAA2B;AAC3B,MAAM,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC;AAsB9B,MAAM,UAAU,QAAQ,CAAC,KAAoB;IAC3C,yDAAyD;IACzD,iEAAiE;IACjE,kEAAkE;IAClE,OAAO,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AAClC,CAAC"}

package/dist/jsx/components/semantic.d.ts

@@ -0,0 +1,155 @@
+import type { JSX } from "react";
+import type { ComponentBaseProps } from "../jsx-types";
+/**
+ * Semantic content primitives for expressive rendering.
+ * These provide semantic meaning to renderers beyond plain text.
+ */
+interface BaseProps extends ComponentBaseProps {
+}
+/**
+ * Generic heading component
+ */
+export interface HeaderProps extends BaseProps {
+    level?: 1 | 2 | 3 | 4 | 5 | 6;
+    children?: any;
+}
+export declare function Header(props: HeaderProps): JSX.Element;
+/**
+ * Heading level 1
+ */
+export interface H1Props extends BaseProps {
+    children?: any;
+}
+export declare function H1(props: H1Props): JSX.Element;
+/**
+ * Heading level 2
+ */
+export interface H2Props extends BaseProps {
+    children?: any;
+}
+export declare function H2(props: H2Props): JSX.Element;
+/**
+ * Heading level 3
+ */
+export interface H3Props extends BaseProps {
+    children?: any;
+}
+export declare function H3(props: H3Props): JSX.Element;
+/**
+ * Paragraph component
+ */
+export interface ParagraphProps extends BaseProps {
+    key?: string;
+    children?: any;
+}
+export declare function Paragraph(props: ParagraphProps): JSX.Element;
+/**
+ * List component
+ *
+ * @example
+ * ```tsx
+ * // List with title
+ * <List title="Shopping List">
+ *   <ListItem>Milk</ListItem>
+ *   <ListItem>Bread</ListItem>
+ * </List>
+ *
+ * // Ordered list
+ * <List title="Steps" ordered>
+ *   <ListItem>First</ListItem>
+ *   <ListItem>Second</ListItem>
+ * </List>
+ *
+ * // Task list (checkboxes)
+ * <List title="Tasks" task>
+ *   <ListItem checked>Done</ListItem>
+ *   <ListItem checked={false}>Not done</ListItem>
+ * </List>
+ * ```
+ */
+export interface ListProps extends BaseProps {
+    /** Optional title/heading for the list */
+    title?: string;
+    /** Render as ordered (numbered) list */
+    ordered?: boolean;
+    /** Render as task list with checkboxes */
+    task?: boolean;
+    children?: any;
+}
+export declare function List(props: ListProps): JSX.Element;
+/**
+ * List item component
+ *
+ * When used inside a task list (`<List task>`), the `checked` prop
+ * controls the checkbox state.
+ */
+export interface ListItemProps extends BaseProps {
+    /**
+     * Checkbox state for task list items.
+     * - `true`: checked (`[x]`)
+     * - `false`: unchecked (`[ ]`)
+     * - `undefined`: no checkbox (only valid if parent List doesn't have `task` prop)
+     */
+    checked?: boolean;
+    children?: any;
+}
+export declare function ListItem(props: ListItemProps): JSX.Element;
+/**
+ * Table content block for displaying tabular data.
+ *
+ * @example
+ * ```tsx
+ * // Simple table with headers and rows props
+ * <Table headers={['Name', 'Age']} rows={[['John', '30'], ['Jane', '25']]} />
+ *
+ * // Table with headers prop and Row/Column children
+ * <Table headers={['Name', 'Age']}>
+ *   <Row>
+ *     <Column>John</Column>
+ *     <Column align="right">30</Column>
+ *   </Row>
+ *   <Row>
+ *     <Column>Jane</Column>
+ *     <Column align="right">25</Column>
+ *   </Row>
+ * </Table>
+ *
+ * // Table with header row defined via Row component
+ * <Table>
+ *   <Row header>
+ *     <Column>Name</Column>
+ *     <Column align="right">Age</Column>
+ *   </Row>
+ *   <Row>
+ *     <Column>John</Column>
+ *     <Column align="right">30</Column>
+ *   </Row>
+ * </Table>
+ * ```
+ */
+export interface TableProps extends BaseProps {
+    children?: any;
+    name?: string;
+    description?: string;
+    headers?: string[];
+    rows?: string[][];
+}
+export declare function Table(props: TableProps): JSX.Element;
+/**
+ * Row content block.
+ */
+export interface RowProps extends BaseProps {
+    children?: any;
+    header?: boolean;
+}
+export declare function Row(props: RowProps): JSX.Element;
+/**
+ * Column content block.
+ */
+export interface ColumnProps extends BaseProps {
+    children?: any;
+    align?: "left" | "center" | "right";
+}
+export declare function Column(props: ColumnProps): JSX.Element;
+export {};
+//# sourceMappingURL=semantic.d.ts.map

package/dist/jsx/components/semantic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../../../src/jsx/components/semantic.tsx"],"names":[],"mappings":"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"}

package/dist/jsx/components/semantic.js

@@ -0,0 +1,39 @@
+import React from "react";
+// Helper for createElement
+const h = React.createElement;
+export function Header(props) {
+    return h(Header, props);
+}
+export function H1(props) {
+    return h(H1, props);
+}
+export function H2(props) {
+    return h(H2, props);
+}
+export function H3(props) {
+    return h(H3, props);
+}
+export function Paragraph(props) {
+    return h(Paragraph, props);
+}
+export function List(props) {
+    return h(List, props);
+}
+export function ListItem(props) {
+    return h(ListItem, props);
+}
+export function Table(props) {
+    return h(Table, props);
+}
+export function Row(props) {
+    props.key ??= `row-${Math.random().toString(36).substring(2, 15)}`;
+    return h(Row, props);
+}
+export function Column(props) {
+    props.align ??= "left";
+    return h(Column, props);
+}
+// Note: For inline text formatting, use lowercase intrinsic elements:
+// <strong>, <b>, <em>, <i>, <code>, <mark>, etc.
+// These work without imports via JSX.IntrinsicElements.
+//# sourceMappingURL=semantic.js.map

package/dist/jsx/components/semantic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.js","sourceRoot":"","sources":["../../../src/jsx/components/semantic.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,2BAA2B;AAC3B,MAAM,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC;AAgB9B,MAAM,UAAU,MAAM,CAAC,KAAkB;IACvC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAC1B,CAAC;AAQD,MAAM,UAAU,EAAE,CAAC,KAAc;IAC/B,OAAO,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;AACtB,CAAC;AAQD,MAAM,UAAU,EAAE,CAAC,KAAc;IAC/B,OAAO,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;AACtB,CAAC;AAQD,MAAM,UAAU,EAAE,CAAC,KAAc;IAC/B,OAAO,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;AACtB,CAAC;AASD,MAAM,UAAU,SAAS,CAAC,KAAqB;IAC7C,OAAO,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AAC7B,CAAC;AAmCD,MAAM,UAAU,IAAI,CAAC,KAAgB;IACnC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACxB,CAAC;AAkBD,MAAM,UAAU,QAAQ,CAAC,KAAoB;IAC3C,OAAO,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AAC5B,CAAC;AA0CD,MAAM,UAAU,KAAK,CAAC,KAAiB;IACrC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACzB,CAAC;AASD,MAAM,UAAU,GAAG,CAAC,KAAe;IACjC,KAAK,CAAC,GAAG,KAAK,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IACnE,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AACvB,CAAC;AASD,MAAM,UAAU,MAAM,CAAC,KAAkB;IACvC,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC;IACvB,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,sEAAsE;AACtE,iDAAiD;AACjD,wDAAwD"}