@xyd-js/context 0.1.0-xyd.2

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# @xyd-js/context
+
+## 0.1.0-xyd.2
+
+### Patch Changes
+
+- test
+- Updated dependencies
+  - @xyd-js/core@0.1.0-xyd.15
+
+## 0.1.0-xyd.1
+
+### Patch Changes
+
+- update packages
+- Updated dependencies
+  - @xyd-js/core@0.1.0-xyd.14

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 xyd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

package/dist/index.d.ts

@@ -0,0 +1,1028 @@
+import { Theme, Settings } from '@xyd-js/core';
+import { Node as Node$1, Data as Data$1 } from 'unist';
+
+// ## Enumeration
+
+/**
+ * How phrasing content is aligned
+ * ({@link https://drafts.csswg.org/css-text/ | [CSSTEXT]}).
+ *
+ * * `'left'`: See the
+ *   {@link https://drafts.csswg.org/css-text/#valdef-text-align-left | left}
+ *   value of the `text-align` CSS property
+ * * `'right'`: See the
+ *   {@link https://drafts.csswg.org/css-text/#valdef-text-align-right | right}
+ *   value of the `text-align` CSS property
+ * * `'center'`: See the
+ *   {@link https://drafts.csswg.org/css-text/#valdef-text-align-center | center}
+ *   value of the `text-align` CSS property
+ * * `null`: phrasing content is aligned as defined by the host environment
+ *
+ * Used in GFM tables.
+ */
+type AlignType = "center" | "left" | "right" | null;
+
+/**
+ * Explicitness of a reference.
+ *
+ * `'shortcut'`: the reference is implicit, its identifier inferred from its
+ *   content
+ * `'collapsed'`: the reference is explicit, its identifier inferred from its
+ *   content
+ * `'full'`: the reference is explicit, its identifier explicitly set
+ */
+type ReferenceType = "shortcut" | "collapsed" | "full";
+
+// ## Mixin
+
+/**
+ * Node with a fallback.
+ */
+interface Alternative {
+    /**
+     * Equivalent content for environments that cannot represent the node as
+     * intended.
+     */
+    alt?: string | null | undefined;
+}
+
+/**
+ * Internal relation from one node to another.
+ *
+ * Whether the value of `identifier` is expected to be a unique identifier or
+ * not depends on the type of node including the Association.
+ * An example of this is that they should be unique on {@link Definition},
+ * whereas multiple {@link LinkReference}s can be non-unique to be associated
+ * with one definition.
+ */
+interface Association {
+    /**
+     * Relation of association.
+     *
+     * `identifier` is a source value: character escapes and character
+     * references are not parsed.
+     *
+     * It can match another node.
+     *
+     * Its value must be normalized.
+     * To normalize a value, collapse markdown whitespace (`[\t\n\r ]+`) to a space,
+     * trim the optional initial and/or final space, and perform Unicode-aware
+     * case-folding.
+     */
+    identifier: string;
+
+    /**
+     * Relation of association, in parsed form.
+     *
+     * `label` is a `string` value: it works just like `title` on {@link Link}
+     * or a `lang` on {@link Code}: character escapes and character references
+     * are parsed.
+     *
+     * It can match another node.
+     */
+    label?: string | null | undefined;
+}
+
+/**
+ * Marker that is associated to another node.
+ */
+interface Reference extends Association {
+    /**
+     * Explicitness of the reference.
+     */
+    referenceType: ReferenceType;
+}
+
+/**
+ * Reference to resource.
+ */
+interface Resource {
+    /**
+     * URL to the referenced resource.
+     */
+    url: string;
+    /**
+     * Advisory information for the resource, such as would be appropriate for
+     * a tooltip.
+     */
+    title?: string | null | undefined;
+}
+
+// ## Interfaces
+
+/**
+ * Info associated with mdast nodes by the ecosystem.
+ *
+ * This space is guaranteed to never be specified by unist or mdast.
+ * But you can use it in utilities and plugins to store data.
+ *
+ * This type can be augmented to register custom data.
+ * For example:
+ *
+ * ```ts
+ * declare module 'mdast' {
+ *   interface Data {
+ *     // `someNode.data.myId` is typed as `number | undefined`
+ *     myId?: number | undefined
+ *   }
+ * }
+ * ```
+ */
+interface Data extends Data$1 {}
+
+// ## Content maps
+
+/**
+ * Union of registered mdast nodes that can occur where block content is
+ * expected.
+ *
+ * To register custom mdast nodes, add them to {@link BlockContentMap}.
+ * They will be automatically added here.
+ */
+type BlockContent = BlockContentMap[keyof BlockContentMap];
+
+/**
+ * Registry of all mdast nodes that can occur where {@link BlockContent} is
+ * expected.
+ *
+ * This interface can be augmented to register custom node types:
+ *
+ * ```ts
+ * declare module 'mdast' {
+ *   interface BlockContentMap {
+ *     // Allow using MDX ESM nodes defined by `remark-mdx`.
+ *     mdxjsEsm: MdxjsEsm;
+ *   }
+ * }
+ * ```
+ *
+ * For a union of all block content, see {@link RootContent}.
+ */
+interface BlockContentMap {
+    blockquote: Blockquote;
+    code: Code;
+    heading: Heading;
+    html: Html;
+    list: List;
+    paragraph: Paragraph;
+    table: Table;
+    thematicBreak: ThematicBreak;
+}
+
+/**
+ * Union of registered mdast nodes that can occur where definition content is
+ * expected.
+ *
+ * To register custom mdast nodes, add them to {@link DefinitionContentMap}.
+ * They will be automatically added here.
+ */
+type DefinitionContent = DefinitionContentMap[keyof DefinitionContentMap];
+
+/**
+ * Registry of all mdast nodes that can occur where {@link DefinitionContent}
+ * is expected.
+ *
+ * This interface can be augmented to register custom node types:
+ *
+ * ```ts
+ * declare module 'mdast' {
+ *   interface DefinitionContentMap {
+ *     custom: Custom;
+ *   }
+ * }
+ * ```
+ *
+ * For a union of all definition content, see {@link RootContent}.
+ */
+interface DefinitionContentMap {
+    definition: Definition;
+    footnoteDefinition: FootnoteDefinition;
+}
+
+/**
+ * Union of registered mdast nodes that can occur where list content is
+ * expected.
+ *
+ * To register custom mdast nodes, add them to {@link ListContentMap}.
+ * They will be automatically added here.
+ */
+type ListContent = ListContentMap[keyof ListContentMap];
+
+/**
+ * Registry of all mdast nodes that can occur where {@link ListContent}
+ * is expected.
+ *
+ * This interface can be augmented to register custom node types:
+ *
+ * ```ts
+ * declare module 'mdast' {
+ *   interface ListContentMap {
+ *     custom: Custom;
+ *   }
+ * }
+ * ```
+ *
+ * For a union of all list content, see {@link RootContent}.
+ */
+interface ListContentMap {
+    listItem: ListItem;
+}
+
+/**
+ * Union of registered mdast nodes that can occur where phrasing content is
+ * expected.
+ *
+ * To register custom mdast nodes, add them to {@link PhrasingContentMap}.
+ * They will be automatically added here.
+ */
+type PhrasingContent = PhrasingContentMap[keyof PhrasingContentMap];
+
+/**
+ * Registry of all mdast nodes that can occur where {@link PhrasingContent}
+ * is expected.
+ *
+ * This interface can be augmented to register custom node types:
+ *
+ * ```ts
+ * declare module 'mdast' {
+ *   interface PhrasingContentMap {
+ *     // Allow using MDX JSX (text) nodes defined by `remark-mdx`.
+ *     mdxJsxTextElement: MDXJSXTextElement;
+ *   }
+ * }
+ * ```
+ *
+ * For a union of all phrasing content, see {@link RootContent}.
+ */
+interface PhrasingContentMap {
+    break: Break;
+    delete: Delete;
+    emphasis: Emphasis;
+    footnoteReference: FootnoteReference;
+    html: Html;
+    image: Image;
+    imageReference: ImageReference;
+    inlineCode: InlineCode;
+    link: Link;
+    linkReference: LinkReference;
+    strong: Strong;
+    text: Text;
+}
+
+/**
+ * Union of registered mdast nodes that can occur in {@link Root}.
+ *
+ * To register custom mdast nodes, add them to {@link RootContentMap}.
+ * They will be automatically added here.
+ */
+type RootContent = RootContentMap[keyof RootContentMap];
+
+/**
+ * Registry of all mdast nodes that can occur as children of {@link Root}.
+ *
+ * > **Note**: {@link Root} does not need to be an entire document.
+ * > it can also be a fragment.
+ *
+ * This interface can be augmented to register custom node types:
+ *
+ * ```ts
+ * declare module 'mdast' {
+ *   interface RootContentMap {
+ *     // Allow using toml nodes defined by `remark-frontmatter`.
+ *     toml: TOML;
+ *   }
+ * }
+ * ```
+ *
+ * For a union of all {@link Root} children, see {@link RootContent}.
+ */
+interface RootContentMap {
+    blockquote: Blockquote;
+    break: Break;
+    code: Code;
+    definition: Definition;
+    delete: Delete;
+    emphasis: Emphasis;
+    footnoteDefinition: FootnoteDefinition;
+    footnoteReference: FootnoteReference;
+    heading: Heading;
+    html: Html;
+    image: Image;
+    imageReference: ImageReference;
+    inlineCode: InlineCode;
+    link: Link;
+    linkReference: LinkReference;
+    list: List;
+    listItem: ListItem;
+    paragraph: Paragraph;
+    strong: Strong;
+    table: Table;
+    tableCell: TableCell;
+    tableRow: TableRow;
+    text: Text;
+    thematicBreak: ThematicBreak;
+    yaml: Yaml;
+}
+
+/**
+ * Union of registered mdast nodes that can occur where row content is
+ * expected.
+ *
+ * To register custom mdast nodes, add them to {@link RowContentMap}.
+ * They will be automatically added here.
+ */
+type RowContent = RowContentMap[keyof RowContentMap];
+
+/**
+ * Registry of all mdast nodes that can occur where {@link RowContent}
+ * is expected.
+ *
+ * This interface can be augmented to register custom node types:
+ *
+ * ```ts
+ * declare module 'mdast' {
+ *   interface RowContentMap {
+ *     custom: Custom;
+ *   }
+ * }
+ * ```
+ *
+ * For a union of all row content, see {@link RootContent}.
+ */
+interface RowContentMap {
+    tableCell: TableCell;
+}
+
+/**
+ * Union of registered mdast nodes that can occur where table content is
+ * expected.
+ *
+ * To register custom mdast nodes, add them to {@link TableContentMap}.
+ * They will be automatically added here.
+ */
+type TableContent = TableContentMap[keyof TableContentMap];
+
+/**
+ * Registry of all mdast nodes that can occur where {@link TableContent}
+ * is expected.
+ *
+ * This interface can be augmented to register custom node types:
+ *
+ * ```ts
+ * declare module 'mdast' {
+ *   interface TableContentMap {
+ *     custom: Custom;
+ *   }
+ * }
+ * ```
+ *
+ * For a union of all table content, see {@link RootContent}.
+ */
+interface TableContentMap {
+    tableRow: TableRow;
+}
+
+// ## Abstract nodes
+
+/**
+ * Abstract mdast node that contains the smallest possible value.
+ *
+ * This interface is supposed to be extended if you make custom mdast nodes.
+ *
+ * For a union of all registered mdast literals, see {@link Literals}.
+ */
+interface Literal extends Node {
+    /**
+     * Plain-text value.
+     */
+    value: string;
+}
+
+/**
+ * Abstract mdast node.
+ *
+ * This interface is supposed to be extended.
+ * If you can use {@link Literal} or {@link Parent}, you should.
+ * But for example in markdown, a thematic break (`***`) is neither literal nor
+ * parent, but still a node.
+ *
+ * To register custom mdast nodes, add them to {@link RootContentMap} and other
+ * places where relevant (such as {@link ElementContentMap}).
+ *
+ * For a union of all registered mdast nodes, see {@link Nodes}.
+ */
+interface Node extends Node$1 {
+    /**
+     * Info from the ecosystem.
+     */
+    data?: Data | undefined;
+}
+
+/**
+ * Abstract mdast node that contains other mdast nodes (*children*).
+ *
+ * This interface is supposed to be extended if you make custom mdast nodes.
+ *
+ * For a union of all registered mdast parents, see {@link Parents}.
+ */
+interface Parent extends Node {
+    /**
+     * List of children.
+     */
+    children: RootContent[];
+}
+
+// ## Concrete nodes
+
+/**
+ * Markdown block quote.
+ */
+interface Blockquote extends Parent {
+    /**
+     * Node type of mdast block quote.
+     */
+    type: "blockquote";
+    /**
+     * Children of block quote.
+     */
+    children: Array<BlockContent | DefinitionContent>;
+    /**
+     * Data associated with the mdast block quote.
+     */
+    data?: BlockquoteData | undefined;
+}
+
+/**
+ * Info associated with mdast block quote nodes by the ecosystem.
+ */
+interface BlockquoteData extends Data {}
+
+/**
+ * Markdown break.
+ */
+interface Break extends Node {
+    /**
+     * Node type of mdast break.
+     */
+    type: "break";
+    /**
+     * Data associated with the mdast break.
+     */
+    data?: BreakData | undefined;
+}
+
+/**
+ * Info associated with mdast break nodes by the ecosystem.
+ */
+interface BreakData extends Data {}
+
+/**
+ * Markdown code (flow) (block).
+ */
+interface Code extends Literal {
+    /**
+     * Node type of mdast code (flow).
+     */
+    type: "code";
+    /**
+     * Language of computer code being marked up.
+     */
+    lang?: string | null | undefined;
+    /**
+     * Custom information relating to the node.
+     *
+     * If the lang field is present, a meta field can be present.
+     */
+    meta?: string | null | undefined;
+    /**
+     * Data associated with the mdast code (flow).
+     */
+    data?: CodeData | undefined;
+}
+
+/**
+ * Info associated with mdast code (flow) (block) nodes by the ecosystem.
+ */
+interface CodeData extends Data {}
+
+/**
+ * Markdown definition.
+ */
+interface Definition extends Node, Association, Resource {
+    /**
+     * Node type of mdast definition.
+     */
+    type: "definition";
+    /**
+     * Data associated with the mdast definition.
+     */
+    data?: DefinitionData | undefined;
+}
+
+/**
+ * Info associated with mdast definition nodes by the ecosystem.
+ */
+interface DefinitionData extends Data {}
+
+/**
+ * Markdown GFM delete (strikethrough).
+ */
+interface Delete extends Parent {
+    /**
+     * Node type of mdast GFM delete.
+     */
+    type: "delete";
+    /**
+     * Children of GFM delete.
+     */
+    children: PhrasingContent[];
+    /**
+     * Data associated with the mdast GFM delete.
+     */
+    data?: DeleteData | undefined;
+}
+
+/**
+ * Info associated with mdast GFM delete nodes by the ecosystem.
+ */
+interface DeleteData extends Data {}
+
+/**
+ * Markdown emphasis.
+ */
+interface Emphasis extends Parent {
+    /**
+     * Node type of mdast emphasis.
+     */
+    type: "emphasis";
+    /**
+     * Children of emphasis.
+     */
+    children: PhrasingContent[];
+    /**
+     * Data associated with the mdast emphasis.
+     */
+    data?: EmphasisData | undefined;
+}
+
+/**
+ * Info associated with mdast emphasis nodes by the ecosystem.
+ */
+interface EmphasisData extends Data {}
+
+/**
+ * Markdown GFM footnote definition.
+ */
+interface FootnoteDefinition extends Parent, Association {
+    /**
+     * Node type of mdast GFM footnote definition.
+     */
+    type: "footnoteDefinition";
+    /**
+     * Children of GFM footnote definition.
+     */
+    children: Array<BlockContent | DefinitionContent>;
+    /**
+     * Data associated with the mdast GFM footnote definition.
+     */
+    data?: FootnoteDefinitionData | undefined;
+}
+
+/**
+ * Info associated with mdast GFM footnote definition nodes by the ecosystem.
+ */
+interface FootnoteDefinitionData extends Data {}
+
+/**
+ * Markdown GFM footnote reference.
+ */
+interface FootnoteReference extends Association, Node {
+    /**
+     * Node type of mdast GFM footnote reference.
+     */
+    type: "footnoteReference";
+    /**
+     * Data associated with the mdast GFM footnote reference.
+     */
+    data?: FootnoteReferenceData | undefined;
+}
+
+/**
+ * Info associated with mdast GFM footnote reference nodes by the ecosystem.
+ */
+interface FootnoteReferenceData extends Data {}
+
+/**
+ * Markdown heading.
+ */
+interface Heading extends Parent {
+    /**
+     * Node type of mdast heading.
+     */
+    type: "heading";
+    /**
+     * Heading rank.
+     *
+     * A value of `1` is said to be the highest rank and `6` the lowest.
+     */
+    depth: 1 | 2 | 3 | 4 | 5 | 6;
+    /**
+     * Children of heading.
+     */
+    children: PhrasingContent[];
+    /**
+     * Data associated with the mdast heading.
+     */
+    data?: HeadingData | undefined;
+}
+
+/**
+ * Info associated with mdast heading nodes by the ecosystem.
+ */
+interface HeadingData extends Data {}
+
+/**
+ * Markdown HTML.
+ */
+interface Html extends Literal {
+    /**
+     * Node type of mdast HTML.
+     */
+    type: "html";
+    /**
+     * Data associated with the mdast HTML.
+     */
+    data?: HtmlData | undefined;
+}
+
+/**
+ * Info associated with mdast HTML nodes by the ecosystem.
+ */
+interface HtmlData extends Data {}
+
+/**
+ * Markdown image.
+ */
+interface Image extends Alternative, Node, Resource {
+    /**
+     * Node type of mdast image.
+     */
+    type: "image";
+    /**
+     * Data associated with the mdast image.
+     */
+    data?: ImageData | undefined;
+}
+
+/**
+ * Info associated with mdast image nodes by the ecosystem.
+ */
+interface ImageData extends Data {}
+
+/**
+ * Markdown image reference.
+ */
+interface ImageReference extends Alternative, Node, Reference {
+    /**
+     * Node type of mdast image reference.
+     */
+    type: "imageReference";
+    /**
+     * Data associated with the mdast image reference.
+     */
+    data?: ImageReferenceData | undefined;
+}
+
+/**
+ * Info associated with mdast image reference nodes by the ecosystem.
+ */
+interface ImageReferenceData extends Data {}
+
+/**
+ * Markdown code (text) (inline).
+ */
+interface InlineCode extends Literal {
+    /**
+     * Node type of mdast code (text).
+     */
+    type: "inlineCode";
+    /**
+     * Data associated with the mdast code (text).
+     */
+    data?: InlineCodeData | undefined;
+}
+
+/**
+ * Info associated with mdast code (text) (inline) nodes by the ecosystem.
+ */
+interface InlineCodeData extends Data {}
+
+/**
+ * Markdown link.
+ */
+interface Link extends Parent, Resource {
+    /**
+     * Node type of mdast link.
+     */
+    type: "link";
+    /**
+     * Children of link.
+     */
+    children: PhrasingContent[];
+    /**
+     * Data associated with the mdast link.
+     */
+    data?: LinkData | undefined;
+}
+
+/**
+ * Info associated with mdast link nodes by the ecosystem.
+ */
+interface LinkData extends Data {}
+
+/**
+ * Markdown link reference.
+ */
+interface LinkReference extends Parent, Reference {
+    /**
+     * Node type of mdast link reference.
+     */
+    type: "linkReference";
+    /**
+     * Children of link reference.
+     */
+    children: PhrasingContent[];
+    /**
+     * Data associated with the mdast link reference.
+     */
+    data?: LinkReferenceData | undefined;
+}
+
+/**
+ * Info associated with mdast link reference nodes by the ecosystem.
+ */
+interface LinkReferenceData extends Data {}
+
+/**
+ * Markdown list.
+ */
+interface List extends Parent {
+    /**
+     * Node type of mdast list.
+     */
+    type: "list";
+    /**
+     * Whether the items have been intentionally ordered (when `true`), or that
+     * the order of items is not important (when `false` or not present).
+     */
+    ordered?: boolean | null | undefined;
+    /**
+     * The starting number of the list, when the `ordered` field is `true`.
+     */
+    start?: number | null | undefined;
+    /**
+     * Whether one or more of the children are separated with a blank line from
+     * its siblings (when `true`), or not (when `false` or not present).
+     */
+    spread?: boolean | null | undefined;
+    /**
+     * Children of list.
+     */
+    children: ListContent[];
+    /**
+     * Data associated with the mdast list.
+     */
+    data?: ListData | undefined;
+}
+
+/**
+ * Info associated with mdast list nodes by the ecosystem.
+ */
+interface ListData extends Data {}
+
+/**
+ * Markdown list item.
+ */
+interface ListItem extends Parent {
+    /**
+     * Node type of mdast list item.
+     */
+    type: "listItem";
+    /**
+     * Whether the item is a tasklist item (when `boolean`).
+     *
+     * When `true`, the item is complete.
+     * When `false`, the item is incomplete.
+     */
+    checked?: boolean | null | undefined;
+    /**
+     * Whether one or more of the children are separated with a blank line from
+     * its siblings (when `true`), or not (when `false` or not present).
+     */
+    spread?: boolean | null | undefined;
+    /**
+     * Children of list item.
+     */
+    children: Array<BlockContent | DefinitionContent>;
+    /**
+     * Data associated with the mdast list item.
+     */
+    data?: ListItemData | undefined;
+}
+
+/**
+ * Info associated with mdast list item nodes by the ecosystem.
+ */
+interface ListItemData extends Data {}
+
+/**
+ * Markdown paragraph.
+ */
+interface Paragraph extends Parent {
+    /**
+     * Node type of mdast paragraph.
+     */
+    type: "paragraph";
+    /**
+     * Children of paragraph.
+     */
+    children: PhrasingContent[];
+    /**
+     * Data associated with the mdast paragraph.
+     */
+    data?: ParagraphData | undefined;
+}
+
+/**
+ * Info associated with mdast paragraph nodes by the ecosystem.
+ */
+interface ParagraphData extends Data {}
+
+/**
+ * Markdown strong.
+ */
+interface Strong extends Parent {
+    /**
+     * Node type of mdast strong.
+     */
+    type: "strong";
+    /**
+     * Children of strong.
+     */
+    children: PhrasingContent[];
+    /**
+     * Data associated with the mdast strong.
+     */
+    data?: StrongData | undefined;
+}
+
+/**
+ * Info associated with mdast strong nodes by the ecosystem.
+ */
+interface StrongData extends Data {}
+
+/**
+ * Markdown GFM table.
+ */
+interface Table extends Parent {
+    /**
+     * Node type of mdast GFM table.
+     */
+    type: "table";
+    /**
+     * How cells in columns are aligned.
+     */
+    align?: AlignType[] | null | undefined;
+    /**
+     * Children of GFM table.
+     */
+    children: TableContent[];
+    /**
+     * Data associated with the mdast GFM table.
+     */
+    data?: TableData | undefined;
+}
+
+/**
+ * Info associated with mdast GFM table nodes by the ecosystem.
+ */
+interface TableData extends Data {}
+
+/**
+ * Markdown GFM table row.
+ */
+interface TableRow extends Parent {
+    /**
+     * Node type of mdast GFM table row.
+     */
+    type: "tableRow";
+    /**
+     * Children of GFM table row.
+     */
+    children: RowContent[];
+    /**
+     * Data associated with the mdast GFM table row.
+     */
+    data?: TableRowData | undefined;
+}
+
+/**
+ * Info associated with mdast GFM table row nodes by the ecosystem.
+ */
+interface TableRowData extends Data {}
+
+/**
+ * Markdown GFM table cell.
+ */
+interface TableCell extends Parent {
+    /**
+     * Node type of mdast GFM table cell.
+     */
+    type: "tableCell";
+    /**
+     * Children of GFM table cell.
+     */
+    children: PhrasingContent[];
+    /**
+     * Data associated with the mdast GFM table cell.
+     */
+    data?: TableCellData | undefined;
+}
+
+/**
+ * Info associated with mdast GFM table cell nodes by the ecosystem.
+ */
+interface TableCellData extends Data {}
+
+/**
+ * Markdown text.
+ */
+interface Text extends Literal {
+    /**
+     * Node type of mdast text.
+     */
+    type: "text";
+    /**
+     * Data associated with the mdast text.
+     */
+    data?: TextData | undefined;
+}
+
+/**
+ * Info associated with mdast text nodes by the ecosystem.
+ */
+interface TextData extends Data {}
+
+/**
+ * Markdown thematic break (horizontal rule).
+ */
+interface ThematicBreak extends Node {
+    /**
+     * Node type of mdast thematic break.
+     */
+    type: "thematicBreak";
+    /**
+     * Data associated with the mdast thematic break.
+     */
+    data?: ThematicBreakData | undefined;
+}
+
+/**
+ * Info associated with mdast thematic break nodes by the ecosystem.
+ */
+interface ThematicBreakData extends Data {}
+
+/**
+ * Markdown YAML.
+ */
+interface Yaml extends Literal {
+    /**
+     * Node type of mdast YAML.
+     */
+    type: "yaml";
+    /**
+     * Data associated with the mdast YAML.
+     */
+    data?: YamlData | undefined;
+}
+
+/**
+ * Info associated with mdast YAML nodes by the ecosystem.
+ */
+interface YamlData extends Data {}
+
+type TransformFn = (themeSettings: Theme, metaProps: any, meta: any, treeChilds: readonly RootContent[]) => any;
+interface MetaComponent {
+    name: string;
+    componentName: string;
+    transform: TransformFn;
+}
+declare function registerMetaComponent(name: string, componentName: string, transform: TransformFn): void;
+declare function getMetaComponent(name: string): MetaComponent | undefined;
+
+declare function contextSettings(): Settings;
+declare function setContextSettings(s: Settings): void;
+declare function contextBasePath(): string;
+declare function setContextBasePath(p: string): void;
+
+export { contextBasePath, contextSettings, getMetaComponent, registerMetaComponent, setContextBasePath, setContextSettings };

package/dist/index.js

@@ -0,0 +1,43 @@
+// src/meta.ts
+var registry = /* @__PURE__ */ new Map();
+function registerMetaComponent(name, componentName, transform) {
+  registry.set(name, {
+    name,
+    componentName,
+    transform
+  });
+}
+function getMetaComponent(name) {
+  return registry.get(name);
+}
+
+// src/index.ts
+var settings = null;
+var basePath = null;
+function contextSettings() {
+  if (!settings) {
+    throw new Error("Context settings not found");
+  }
+  return settings;
+}
+function setContextSettings(s) {
+  settings = s;
+}
+function contextBasePath() {
+  if (!basePath) {
+    throw new Error("Context base path not found");
+  }
+  return basePath;
+}
+function setContextBasePath(p) {
+  basePath = p;
+}
+export {
+  contextBasePath,
+  contextSettings,
+  getMetaComponent,
+  registerMetaComponent,
+  setContextBasePath,
+  setContextSettings
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/meta.ts","../src/index.ts"],"sourcesContent":["import type { RootContent } from 'mdast'\n\nimport type { Theme } from '@xyd-js/core'\n\ntype TransformFn = (\n    themeSettings: Theme,\n    metaProps: any, \n    meta: any,\n    treeChilds: readonly RootContent[]\n) => any // TODO: fix any\n\ninterface MetaComponent {\n    name: string\n    \n    componentName: string\n\n    transform: TransformFn\n}\n\nconst registry = new Map<string, MetaComponent>()\n\nexport function registerMetaComponent(\n    name: string,\n    componentName: string,\n    transform: TransformFn\n) {\n    registry.set(name, {\n        name,\n        componentName,\n        transform\n    })\n}\n\nexport function getMetaComponent(name: string) {\n    return registry.get(name)\n}\n","import { Settings } from \"@xyd-js/core\";\n\nexport * from \"./meta\"\n\nlet settings: Settings | null = null\nlet basePath: string | null = null\n\nexport function contextSettings(): Settings {\n    if (!settings) {\n        throw new Error(\"Context settings not found\")\n    }\n\n    return settings\n}\n\nexport function setContextSettings(s: Settings) {\n    settings = s\n}\n\nexport function contextBasePath(): string {\n    if (!basePath) {\n        throw new Error(\"Context base path not found\")\n    }\n\n    return basePath\n}\n\nexport function setContextBasePath(p: string) {\n    basePath = p\n}"],"mappings":";AAmBA,IAAM,WAAW,oBAAI,IAA2B;AAEzC,SAAS,sBACZ,MACA,eACA,WACF;AACE,WAAS,IAAI,MAAM;AAAA,IACf;AAAA,IACA;AAAA,IACA;AAAA,EACJ,CAAC;AACL;AAEO,SAAS,iBAAiB,MAAc;AAC3C,SAAO,SAAS,IAAI,IAAI;AAC5B;;;AC/BA,IAAI,WAA4B;AAChC,IAAI,WAA0B;AAEvB,SAAS,kBAA4B;AACxC,MAAI,CAAC,UAAU;AACX,UAAM,IAAI,MAAM,4BAA4B;AAAA,EAChD;AAEA,SAAO;AACX;AAEO,SAAS,mBAAmB,GAAa;AAC5C,aAAW;AACf;AAEO,SAAS,kBAA0B;AACtC,MAAI,CAAC,UAAU;AACX,UAAM,IAAI,MAAM,6BAA6B;AAAA,EACjD;AAEA,SAAO;AACX;AAEO,SAAS,mBAAmB,GAAW;AAC1C,aAAW;AACf;","names":[]}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@xyd-js/context",
+  "version": "0.1.0-xyd.2",
+  "description": "shared xyd context",
+  "main": "./dist/index.js",
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": "./dist/index.js"
+  },
+  "dependencies": {
+    "@xyd-js/core": "0.1.0-xyd.15"
+  },
+  "devDependencies": {
+    "@types/mdast": "^4.0.3",
+    "@types/node": "^22.14.1",
+    "@vitest/coverage-v8": "^1.3.1",
+    "rimraf": "^3.0.2",
+    "tsup": "^8.3.0",
+    "typescript": "^4.5.5",
+    "vitest": "^1.3.1"
+  },
+  "scripts": {
+    "clean": "rimraf build",
+    "prebuild": "pnpm clean",
+    "build": "tsup",
+    "watch": "tsup --watch",
+    "test": "vitest",
+    "test:watch": "vitest watch"
+  }
+}

package/src/index.ts

@@ -0,0 +1,30 @@
+import { Settings } from "@xyd-js/core";
+
+export * from "./meta"
+
+let settings: Settings | null = null
+let basePath: string | null = null
+
+export function contextSettings(): Settings {
+    if (!settings) {
+        throw new Error("Context settings not found")
+    }
+
+    return settings
+}
+
+export function setContextSettings(s: Settings) {
+    settings = s
+}
+
+export function contextBasePath(): string {
+    if (!basePath) {
+        throw new Error("Context base path not found")
+    }
+
+    return basePath
+}
+
+export function setContextBasePath(p: string) {
+    basePath = p
+}

package/src/meta.ts

@@ -0,0 +1,36 @@
+import type { RootContent } from 'mdast'
+
+import type { Theme } from '@xyd-js/core'
+
+type TransformFn = (
+    themeSettings: Theme,
+    metaProps: any, 
+    meta: any,
+    treeChilds: readonly RootContent[]
+) => any // TODO: fix any
+
+interface MetaComponent {
+    name: string
+    
+    componentName: string
+
+    transform: TransformFn
+}
+
+const registry = new Map<string, MetaComponent>()
+
+export function registerMetaComponent(
+    name: string,
+    componentName: string,
+    transform: TransformFn
+) {
+    registry.set(name, {
+        name,
+        componentName,
+        transform
+    })
+}
+
+export function getMetaComponent(name: string) {
+    return registry.get(name)
+}

package/tsconfig.json

@@ -0,0 +1,44 @@
+{
+    "compilerOptions": {
+      "module": "esnext",
+      "esModuleInterop": true,
+      "moduleResolution": "node",
+      "target": "ES6",
+      "lib": [
+        "dom",
+        "dom.iterable",
+        "esnext"
+      ],
+      "allowJs": true,
+      "skipLibCheck": true,
+      "strict": false,
+      "noEmit": false,
+      "incremental": false,
+      "resolveJsonModule": true,
+      "isolatedModules": true,
+      "jsx": "react",
+      "plugins": [
+        {
+          "name": "next"
+        }
+      ],
+      "strictNullChecks": true,
+      "baseUrl": ".",
+      "paths": {
+        "@xyd-js/core": ["../xyd-core/src"]
+      },
+      "typeRoots": [
+        "./types.d.ts"
+      ]
+    },
+    "include": [
+      "next-env.d.ts",
+      "**/*.ts",
+      "**/*.tsx",
+      ".next/types/**/*.ts",
+      "types.d.ts"
+    ],
+    "exclude": [
+      "node_modules"
+    ]
+  }

package/tsup.config.ts

@@ -0,0 +1,23 @@
+import {defineConfig, Options} from 'tsup';
+
+const config: Options = {
+    entry: ['src/index.ts'],
+    format: ['esm'], // Output both ESM and CJS formats
+    target: 'node16', // Ensure compatibility with Node.js 16
+    dts: {
+        entry: 'src/index.ts', // Specify the entry for DTS
+        resolve: true, // Resolve external types
+    },
+    splitting: false, // Disable code splitting
+    sourcemap: true, // Generate source maps
+    clean: true, // Clean the output directory before each build
+    esbuildOptions: (options) => {
+        options.platform = 'node'; // Ensure the platform is set to Node.js
+        options.external = ['node:fs/promises']; // Mark 'node:fs/promises' as external
+        options.loader = {'.js': 'jsx'}; // Ensure proper handling of .js files
+    },
+    tsconfig: 'tsconfig.json',
+    ignoreWatch: ['node_modules', 'dist', '.git', 'build'] // Exclude unnecessary directories
+}
+
+export default defineConfig(config);