@terrafirmagreg-team/kit 0.1.0 → 1.2.0

package/src/lib/mdx/references.ts

@@ -1,56 +0,0 @@
-type MdastNode = {
-  type: string;
-  value?: string;
-  url?: string;
-  children?: MdastNode[];
-};
-
-const ISSUE_REF = /^#\d+$/;
-const USER_REF = /^@[a-zA-Z\d](?:[a-zA-Z\d-]{0,37}[a-zA-Z\d])?$/;
-const AUTO_REF = /(\B#\d+\b|\B@[a-zA-Z\d](?:[a-zA-Z\d-]{0,37}[a-zA-Z\d])?)/g;
-const SKIP = new Set([
-  'link',
-  'linkReference',
-  'image',
-  'imageReference',
-  'code',
-  'inlineCode',
-  'html',
-]);
-
-const CHANGELOG_PATH = /[/\\]changelog[/\\]([^/\\]+)[/\\]/;
-
-export function remarkChangelogReferences(options: { datasetConfig?: Record<string, { repo?: string }> } = {}) {
-  const datasetConfig = options.datasetConfig ?? {};
-  return (tree: MdastNode, file: { path?: string }) => {
-    const pack = CHANGELOG_PATH.exec(file.path ?? '')?.[1];
-    const repo = pack ? datasetConfig[pack]?.repo : undefined;
-    if (!repo) return;
-    const repoUrl = `https://github.com/${repo}`;
-    const visit = (node: MdastNode) => {
-      if (SKIP.has(node.type) || !node.children) return;
-      node.children = node.children.flatMap((child): MdastNode[] => {
-        if (child.type !== 'text') {
-          visit(child);
-          return [child];
-        }
-        return (child.value ?? '').split(AUTO_REF).map((part) =>
-          ISSUE_REF.test(part)
-            ? {
-                type: 'link',
-                url: `${repoUrl}/issues/${part.slice(1)}`,
-                children: [{ type: 'text', value: part }],
-              }
-            : USER_REF.test(part)
-              ? {
-                  type: 'link',
-                  url: `https://github.com/${part.slice(1)}`,
-                  children: [{ type: 'text', value: part }],
-                }
-              : { type: 'text', value: part },
-        );
-      });
-    };
-    visit(tree);
-  };
-}

package/src/lib/mdx/tabs.ts

@@ -1,80 +0,0 @@
-import {
-  estreeStringArray,
-  extractLeafLabel,
-  jsxExpression,
-  toJsxAttributes,
-  walkContainers,
-  type DirectiveNode,
-  type JsxElement,
-  type MdastNode,
-} from './directive-utils.ts';
-
-
-export function remarkTabs() {
-  return (tree: MdastNode) => {
-    walkContainers(tree, (directive) => {
-      if (directive.name !== 'tabs') return;
-      toTabs(directive);
-      return false;
-    });
-  };
-}
-
-
-function escapeValue(value: string): string {
-  return value.toLowerCase().replace(/\s/, '-');
-}
-
-
-function toTabs(node: DirectiveNode): void {
-  const items: string[] = [];
-  const tabs: JsxElement[] = [];
-  let current: JsxElement | undefined;
-
-  for (const item of node.children ?? []) {
-    if (item.type === 'leafDirective' && (item as { name?: string }).name === 'tab') {
-      const label = extractLeafLabel(item);
-      items.push(label);
-      current = {
-        type: 'mdxJsxFlowElement',
-        name: 'Tab',
-        attributes: [
-          {
-            type: 'mdxJsxAttribute',
-            name: 'value',
-            value: escapeValue(label),
-          },
-        ],
-        children: [],
-      };
-      tabs.push(current);
-      continue;
-    }
-
-    current?.children.push(item);
-  }
-
-  const attributes = toJsxAttributes(node).map((attribute) =>
-    attribute.name === 'default'
-      ? {
-          type: 'mdxJsxAttribute' as const,
-          name: 'defaultValue',
-          value: escapeValue(String(attribute.value)),
-        }
-      : attribute,
-  );
-  attributes.unshift({
-    type: 'mdxJsxAttribute',
-    name: 'items',
-    value: jsxExpression(estreeStringArray(items)),
-  });
-
-  Object.assign(node, {
-    type: 'mdxJsxFlowElement',
-    name: 'Tabs',
-    attributes,
-    children: tabs,
-  });
-}
-
-

package/src/lib/mdx-components.tsx

@@ -1,139 +0,0 @@
-import {
-  Tab,
-  Tabs,
-  TabsContent,
-  TabsList,
-  TabsTrigger,
-} from '@terrafirmagreg-team/ui/components/mdx/tabs';
-import {
-  Accordion,
-  Accordions,
-} from '@terrafirmagreg-team/ui/components/mdx/accordion';
-import { Step, Steps } from '@terrafirmagreg-team/ui/components/mdx/steps';
-import {
-  File,
-  Folder,
-  Files,
-} from '@terrafirmagreg-team/ui/components/mdx/files';
-import { ImageZoom } from '@terrafirmagreg-team/ui/components/mdx/image-zoom';
-import { Banner } from '@terrafirmagreg-team/ui/components/mdx/banner';
-import { TypeTable } from '@terrafirmagreg-team/ui/components/mdx/type-table';
-import { Card, Cards } from '@terrafirmagreg-team/ui/components/mdx/card';
-import { Table } from '@terrafirmagreg-team/ui/components/mdx/table';
-import {
-  CalloutDescription,
-  CalloutTitle,
-} from '@terrafirmagreg-team/ui/components/mdx/callout';
-import {
-  CodeBlock,
-  CodeBlockTab,
-  CodeBlockTabs,
-  CodeBlockTabsList,
-  CodeBlockTabsTrigger,
-  Pre,
-} from '@terrafirmagreg-team/ui/components/mdx/codeblock';
-import { Heading } from '@terrafirmagreg-team/ui/components/blocks/page/heading';
-import * as Twoslash from 'fumadocs-twoslash/ui';
-import { Mermaid } from '@terrafirmagreg-team/ui/components/mdx/mermaid';
-import { Callout, CalloutContainer } from '@terrafirmagreg-team/ui/components/mdx/callout';
-import { Input, Output, Preview } from '@terrafirmagreg-team/ui/components/mdx/preview';
-import { DocsImage } from '@terrafirmagreg-team/kit/components/docs-image';
-import { Multiblock } from '@terrafirmagreg-team/ui/components/mdx/multiblock';
-import { GradientText } from '@terrafirmagreg-team/ui/components/mdx/gradient-text';
-import { GlowHeader } from '@terrafirmagreg-team/ui/components/mdx/glow-header';
-import { LinkPreview } from '@terrafirmagreg-team/ui/components/blocks/link/link-preview';
-import type { MDXComponents } from 'mdx/types';
-import type { ComponentProps, HTMLAttributes } from 'react';
-
-const extras: MDXComponents = {};
-
-export function registerMdxComponents(map: MDXComponents): void {
-  Object.assign(extras, map);
-}
-
-export function getMDXComponents(components?: MDXComponents) {
-  return {
-    ...extras,
-    CodeBlockTab,
-    CodeBlockTabs,
-    CodeBlockTabsList,
-    CodeBlockTabsTrigger,
-    Tab,
-    Tabs,
-    TabsContent,
-    TabsList,
-    TabsTrigger,
-    ...Twoslash,
-    Accordion,
-    Accordions,
-    Step,
-    Steps,
-    File,
-    Folder,
-    Files,
-    Mermaid,
-    Banner,
-    TypeTable,
-    Card,
-    Cards,
-    Callout,
-    CalloutContainer,
-    CalloutTitle,
-    CalloutDescription,
-    Preview,
-    Input,
-    Output,
-    DocsImage,
-    Multiblock,
-    GradientText,
-    GlowHeader,
-    a: LinkPreview,
-    pre: (props: HTMLAttributes<HTMLPreElement>) => (
-      <CodeBlock {...props}>
-        <Pre>{props.children}</Pre>
-      </CodeBlock>
-    ),
-    h1: (props: HTMLAttributes<HTMLHeadingElement>) => (
-      <Heading as="h1" {...props} />
-    ),
-    h2: (props: HTMLAttributes<HTMLHeadingElement>) => (
-      <Heading as="h2" {...props} />
-    ),
-    h3: (props: HTMLAttributes<HTMLHeadingElement>) => (
-      <Heading as="h3" {...props} />
-    ),
-    h4: (props: HTMLAttributes<HTMLHeadingElement>) => (
-      <Heading as="h4" {...props} />
-    ),
-    h5: (props: HTMLAttributes<HTMLHeadingElement>) => (
-      <Heading as="h5" {...props} />
-    ),
-    h6: (props: HTMLAttributes<HTMLHeadingElement>) => (
-      <Heading as="h6" {...props} />
-    ),
-    table: Table,
-    img: (props: ComponentProps<'img'>) => {
-      if (typeof props.src !== 'string' || /^https?:\/\//i.test(props.src)) {
-        // eslint-disable-next-line @next/next/no-img-element
-        return <img {...props} alt={props.alt ?? ''} />;
-      }
-      const width = Number(props.width) || undefined;
-      const height = Number(props.height) || undefined;
-      return (
-        <ImageZoom
-          src={props.src}
-          alt={props.alt ?? ''}
-          width={width ?? 960}
-          height={height ?? 540}
-          sizes={props.sizes as string | undefined}
-          className={props.className}
-        />
-      );
-    },
-    ...components,
-  } as MDXComponents;
-}
-
-declare global {
-  type MDXProvidedComponents = ReturnType<typeof getMDXComponents>;
-}

package/src/lib/pack-assets.ts

@@ -1,45 +0,0 @@
-import type { DocsImageProps } from '@terrafirmagreg-team/kit/types/mdx';
-
-export function packPublicUrl(pack: string, ...segments: string[]): string {
-  const rel = segments
-    .map((s) => s.replace(/^\/+/, '').replaceAll('\\', '/'))
-    .filter(Boolean)
-    .join('/');
-  return rel ? `/${pack}/${rel}` : `/${pack}`;
-}
-
-export function assetUrl(
-  pack: string,
-  modId: string,
-  ...pathSegments: string[]
-): string {
-  return packPublicUrl(pack, 'assets', modId, ...pathSegments);
-}
-
-export function resolveSrc(
-  props: Pick<DocsImageProps, 'src' | 'pack' | 'mod' | 'path'>,
-  packFallback?: string,
-): string | null {
-  if (props.src) {
-    const s = props.src.trim();
-    if (
-      s.startsWith('/') ||
-      s.startsWith('http://') ||
-      s.startsWith('https://')
-    ) {
-      return s;
-    }
-    return `/${s.replace(/^\/+/, '')}`;
-  }
-
-  const pack = props.pack ?? packFallback;
-  if (!pack) return null;
-
-  if (props.mod && props.path) {
-    return assetUrl(pack, props.mod, props.path);
-  }
-  if (props.path) {
-    return packPublicUrl(pack, props.path);
-  }
-  return null;
-}

package/src/lib/preview/index.ts

@@ -1,8 +0,0 @@
-export {
-  loadClientPreviews,
-  registerPreviewResolver,
-  resolveLinkPreview,
-  type PreviewResolver,
-  type PreviewResolverCtx,
-  type PreviewResolverOptions,
-} from './resolvers';

package/src/lib/preview/og.tsx

@@ -1,115 +0,0 @@
-import { ImageResponse } from 'next/og';
-import type { ReactNode } from 'react';
-import type { ImageResponseOptions } from 'next/dist/compiled/@vercel/og/types';
-
-interface GenerateProps {
-  title: ReactNode;
-  description?: ReactNode;
-  icon?: ReactNode;
-  primaryColor?: string;
-  primaryTextColor?: string;
-  site?: ReactNode;
-}
-
-export function generateOGImage(options: GenerateProps & ImageResponseOptions): ImageResponse {
-  const { title, description, icon, site, primaryColor, primaryTextColor, ...rest } = options;
-
-  return new ImageResponse(
-    generate({
-      title,
-      description,
-      icon,
-      site,
-      primaryTextColor,
-      primaryColor,
-    }),
-    {
-      width: 1200,
-      height: 630,
-      ...rest,
-    },
-  );
-}
-
-export function generate({
-  primaryColor = 'rgba(255,150,255,0.3)',
-  primaryTextColor = 'rgb(255,150,255)',
-  icon = (
-    <svg
-      xmlns="http://www.w3.org/2000/svg"
-      width="56"
-      height="56"
-      viewBox="0 0 24 24"
-      fill="none"
-      stroke="currentColor"
-      strokeWidth="2"
-      strokeLinecap="round"
-      strokeLinejoin="round"
-      className="lucide lucide-book-icon lucide-book"
-    >
-      <circle cx="12" cy="12" r="11" stroke={primaryTextColor} strokeWidth="2" />
-    </svg>
-  ),
-  ...props
-}: GenerateProps) {
-  return (
-    <div
-      style={{
-        display: 'flex',
-        flexDirection: 'column',
-        width: '100%',
-        height: '100%',
-        color: 'white',
-        padding: '4rem',
-        backgroundColor: '#0c0c0c',
-        borderBottom: `18px solid ${primaryColor}`,
-      }}
-    >
-      <p
-        style={{
-          fontWeight: 800,
-          fontSize: '82px',
-          margin: 0,
-        }}
-      >
-        {props.title}
-      </p>
-      <p
-        style={{
-          fontSize: '52px',
-          color: 'rgba(240,240,240,0.8)',
-          margin: 0,
-          marginTop: '16px',
-          paddingBottom: '28px',
-          borderBottom: `10px dashed ${primaryColor}`,
-        }}
-      >
-        {props.description}
-      </p>
-
-      <div
-        style={{
-          display: 'flex',
-          flexDirection: 'row',
-          alignItems: 'center',
-          gap: '20px',
-          marginTop: 'auto',
-          color: primaryTextColor,
-        }}
-      >
-        {icon}
-        {props.site && (
-          <p
-            style={{
-              fontSize: '56px',
-              fontWeight: 600,
-              margin: 0,
-            }}
-          >
-            {props.site}
-          </p>
-        )}
-      </div>
-    </div>
-  );
-}

package/src/lib/preview/resolvers.ts

@@ -1,98 +0,0 @@
-import type { Lang } from '@terrafirmagreg-team/translate/types/locale';
-import type { PagePreviewData } from '@terrafirmagreg-team/ui/types/preview';
-
-export interface PreviewResolverCtx {
-
-  parts: string[];
-  query: URLSearchParams;
-  lang: Lang;
-  langMap: Record<string, string>;
-}
-
-export type PreviewResolver = (
-  ctx: PreviewResolverCtx,
-) => Promise<PagePreviewData | undefined>;
-
-export interface PreviewResolverOptions {
-
-  langMap?: (dataset: string, lang: Lang) => Promise<Record<string, string>>;
-}
-
-const resolvers = new Map<
-  string,
-  { resolve: PreviewResolver; langMap?: PreviewResolverOptions['langMap'] }
->();
-
-export function registerPreviewResolver(
-  section: string,
-  resolve: PreviewResolver,
-  options?: PreviewResolverOptions,
-): void {
-  resolvers.set(section, { resolve, langMap: options?.langMap });
-}
-
-function parseHref(href: string | undefined) {
-  if (!href || /^(https?:|mailto:|\/\/|#)/i.test(href)) return undefined;
-  const [withoutHash] = href.split('#');
-  const [pathname, qs] = withoutHash.split('?');
-  if (!pathname.startsWith('/')) return undefined;
-  return {
-    withoutHash,
-    query: new URLSearchParams(qs),
-    parts: pathname.split('/').filter(Boolean),
-  };
-}
-
-export async function resolveLinkPreview(
-  href: string,
-  lang?: string,
-): Promise<PagePreviewData | undefined> {
-  const parsed = parseHref(href);
-  if (!parsed) return undefined;
-  const resolvedLang = (parsed.query.get('lang') ?? lang) as Lang | undefined;
-  const entry = resolvers.get(parsed.parts[0] ?? '');
-  if (entry && resolvedLang) {
-    const dataset = parsed.parts[1];
-    if (!dataset) return undefined;
-    const langMap = entry.langMap
-      ? await entry.langMap(dataset, resolvedLang)
-      : {};
-    return entry.resolve({
-      parts: parsed.parts,
-      query: parsed.query,
-      lang: resolvedLang,
-      langMap,
-    });
-  }
-  const res = await fetch(
-    `/api/preview?href=${encodeURIComponent(parsed.withoutHash)}${
-      resolvedLang ? `&lang=${encodeURIComponent(resolvedLang)}` : ''
-    }`,
-  );
-  if (!res.ok) return undefined;
-  return ((await res.json()) ?? undefined) as PagePreviewData | undefined;
-}
-
-export async function loadClientPreviews(
-  lang: Lang,
-  langMap: Record<string, string>,
-  hrefs: Iterable<string>,
-): Promise<Record<string, PagePreviewData>> {
-  const out: Record<string, PagePreviewData> = {};
-  await Promise.all(
-    [...hrefs].map(async (href) => {
-      const parsed = parseHref(href);
-      if (!parsed) return;
-      const entry = resolvers.get(parsed.parts[0] ?? '');
-      if (!entry) return;
-      const preview = await entry.resolve({
-        parts: parsed.parts,
-        query: parsed.query,
-        lang,
-        langMap,
-      });
-      if (preview) out[href] = preview;
-    }),
-  );
-  return out;
-}

package/src/lib/search/config.ts

@@ -1,13 +0,0 @@
-import type { LangConfig } from '@terrafirmagreg-team/translate/lang';
-import { createConfig } from '@terrafirmagreg-team/kit/lib/config';
-import type { LocalizedIndex } from './indexes';
-
-export interface SearchConfig {
-
-  indexes(): Promise<LocalizedIndex[]>;
-
-  i18n(): LangConfig;
-}
-
-export const { register: registerSearchConfig, get: searchConfig } =
-  createConfig<SearchConfig>('Search');

package/src/lib/search/filters.ts

@@ -1,22 +0,0 @@
-import type { SortedResult } from '@terrafirmagreg-team/ui/types/search';
-
-export type SearchHitFilter = (hit: SortedResult) => boolean;
-export type SearchHitFilterFactory = (
-  params: URLSearchParams,
-) => SearchHitFilter | undefined;
-
-const hitFilters = new Map<string, SearchHitFilterFactory>();
-
-export function registerSearchHitFilter(
-  section: string,
-  factory: SearchHitFilterFactory,
-): void {
-  hitFilters.set(section, factory);
-}
-
-export function searchHitFilter(
-  section: string,
-  params: URLSearchParams,
-): SearchHitFilter | undefined {
-  return hitFilters.get(section)?.(params);
-}

package/src/lib/search/index.ts

@@ -1,19 +0,0 @@
-export { mergeClients } from './merge';
-export { pageStructuredData } from './structured';
-export {
-  buildSearchIndexes,
-  type LocalizedIndex,
-  type SearchIndexPage,
-  type SearchPageSource,
-} from './indexes';
-export {
-  registerSearchConfig,
-  searchConfig,
-  type SearchConfig,
-} from './config';
-export {
-  registerSearchHitFilter,
-  searchHitFilter,
-  type SearchHitFilter,
-  type SearchHitFilterFactory,
-} from './filters';

package/src/lib/search/indexes.ts

@@ -1,43 +0,0 @@
-import type { AdvancedIndex } from 'fumadocs-core/search/server';
-import { stripLangFromUrl } from '@terrafirmagreg-team/translate/lib/slug';
-import { pageStructuredData } from './structured';
-
-export type LocalizedIndex = AdvancedIndex & { locale: string };
-
-export interface SearchIndexPage {
-  slugs: string[];
-  url: string;
-  data: { title?: string; description?: string };
-}
-
-export interface SearchPageSource {
-  source: { getPages(): SearchIndexPage[] };
-}
-
-export async function buildSearchIndexes(
-  sources: Record<string, SearchPageSource | undefined>,
-  languages: readonly string[],
-): Promise<LocalizedIndex[]> {
-  const rows = (
-    await Promise.all(
-      Object.entries(sources).flatMap(([section, entry]) =>
-        entry?.source.getPages().map(async (page) => {
-          const [dataset, lang] = page.slugs;
-          if (!dataset || !lang) return null;
-          return {
-            title: page.data.title ?? page.url,
-            description: page.data.description,
-            url: stripLangFromUrl(page.url, [...languages]),
-            id: page.url,
-            tag: `${section}:${dataset}`,
-            locale: lang,
-            structuredData: await pageStructuredData(
-              page.data as Record<string, unknown>,
-            ),
-          } satisfies LocalizedIndex;
-        }) ?? [],
-      ),
-    )
-  ).filter((index) => index !== null);
-  return rows;
-}

package/src/lib/search/merge.ts

@@ -1,22 +0,0 @@
-import type { SearchClient } from 'fumadocs-core/search/client';
-
-export function mergeClients(...clients: SearchClient[]): SearchClient {
-  return {
-    deps: clients.flatMap((client) => client.deps ?? []),
-    async search(query) {
-      const lists = await Promise.all(
-        clients.map((client) => client.search(query)),
-      );
-      const seen = new Set<string>();
-      const out = [];
-      for (const list of lists) {
-        for (const hit of list) {
-          if (seen.has(hit.id)) continue;
-          seen.add(hit.id);
-          out.push(hit);
-        }
-      }
-      return out;
-    },
-  };
-}

package/src/lib/search/server.ts

@@ -1,18 +0,0 @@
-import 'server-only';
-import { createI18nSearchAPI } from 'fumadocs-core/search/server';
-import { searchConfig } from './config';
-
-async function createSearchApi() {
-  const config = searchConfig();
-  return createI18nSearchAPI('advanced', {
-    i18n: config.i18n(),
-    indexes: await config.indexes(),
-  });
-}
-
-let cached: ReturnType<typeof createSearchApi> | undefined;
-
-export function loadSearchApi() {
-  cached ??= createSearchApi();
-  return cached;
-}