@life-exe/wiki-engine 0.1.0

package/dist/components/CodeBlock.d.ts

@@ -0,0 +1,5 @@
+type PreProps = React.ComponentPropsWithoutRef<"pre"> & {
+    node?: unknown;
+};
+export declare function CodeBlockPre({ children }: PreProps): import("react").JSX.Element;
+export {};

package/dist/components/CommunityLinks.d.ts

@@ -0,0 +1,21 @@
+import type { ReactNode } from "react";
+export declare function YoutubeIcon(): import("react").JSX.Element;
+export declare function GithubIcon(): import("react").JSX.Element;
+export declare function TelegramIcon(): import("react").JSX.Element;
+export declare function ItchIcon(): import("react").JSX.Element;
+export declare function XIcon(): import("react").JSX.Element;
+export declare function PatreonIcon(): import("react").JSX.Element;
+export declare function BoostyIcon(): import("react").JSX.Element;
+export declare function MediumIcon(): import("react").JSX.Element;
+export declare function UdemyIcon(): import("react").JSX.Element;
+export interface CommunityLinkItem {
+    name: string;
+    url: string;
+    icon: ReactNode;
+    tag: string;
+    desc: string;
+}
+export declare const defaultCommunityLinks: CommunityLinkItem[];
+export declare function CommunityLinks({ links }: {
+    links?: CommunityLinkItem[];
+}): import("react").JSX.Element;

package/dist/components/CookieConsent.d.ts

@@ -0,0 +1,2 @@
+export declare function CookieConsent(): import("react").JSX.Element | null;
+export default CookieConsent;

package/dist/components/DocLinkCard.d.ts

@@ -0,0 +1,6 @@
+import { type ReactNode } from "react";
+export declare function extractDocUrls(content: string): Set<string>;
+export declare function DocLinkCard({ href, children }: {
+    href: string;
+    children: ReactNode;
+}): import("react").JSX.Element;

package/dist/components/LecturePageView.d.ts

@@ -0,0 +1,3 @@
+import "highlight.js/styles/vs2015.css";
+export declare function LecturePageView(): import("react").JSX.Element;
+export default LecturePageView;

package/dist/components/MermaidDiagram.d.ts

@@ -0,0 +1,3 @@
+export declare function MermaidDiagram({ code }: {
+    code: string;
+}): import("react").JSX.Element;

package/dist/components/SearchPopup.d.ts

@@ -0,0 +1,6 @@
+interface SearchPopupProps {
+    isOpen: boolean;
+    onClose: () => void;
+}
+export declare function SearchPopup({ isOpen, onClose }: SearchPopupProps): import("react").JSX.Element | null;
+export default SearchPopup;

package/dist/components/WikiApp.d.ts

@@ -0,0 +1,9 @@
+import type { WikiConfig, WikiData } from "../types";
+export interface WikiAppProps {
+    config: WikiConfig;
+    data: WikiData;
+    basename?: string;
+}
+export declare function WikiRoutes(): import("react").JSX.Element;
+export declare function WikiApp({ config, data, basename }: WikiAppProps): import("react").JSX.Element;
+export default WikiApp;

package/dist/components/WikiLayout.d.ts

@@ -0,0 +1,2 @@
+export declare function WikiLayout(): import("react").JSX.Element;
+export default WikiLayout;

package/dist/components/WikiPageView.d.ts

@@ -0,0 +1,6 @@
+import "highlight.js/styles/vs2015.css";
+interface Props {
+    isIndex?: boolean;
+}
+export declare function WikiPageView({ isIndex }: Props): import("react").JSX.Element;
+export default WikiPageView;

package/dist/components/ZoomableImage.d.ts

@@ -0,0 +1,2 @@
+import { type ComponentProps } from "react";
+export declare function ZoomableImage({ src, alt, className, onClick, ...props }: ComponentProps<"img">): import("react").JSX.Element;

package/dist/context/LangContext.d.ts

@@ -0,0 +1,2 @@
+export declare const LangContext: import("react").Context<string>;
+export declare const useLang: () => string;

package/dist/context/WikiContext.d.ts

@@ -0,0 +1,18 @@
+import { type ReactNode } from "react";
+import type { WikiConfig, WikiData } from "../types";
+import { type Theme } from "../hooks/useTheme";
+export interface WikiContextValue {
+    config: WikiConfig;
+    data: WikiData;
+    lang: string;
+    setLang: (lang: string) => void;
+    theme: Theme;
+    toggleTheme: () => void;
+}
+export declare const WikiContext: import("react").Context<WikiContextValue | null>;
+export declare function useWiki(): WikiContextValue;
+export declare function WikiProvider({ config, data, children, }: {
+    config: WikiConfig;
+    data: WikiData;
+    children: ReactNode;
+}): import("react").JSX.Element;

package/dist/data.d.ts

@@ -0,0 +1,8 @@
+import type { RawWikiSources, WikiData, Lecture, LecturePage } from "./types";
+export declare function parseTitle(content: string): string;
+export declare function stripFrontmatter(content: string): string;
+export declare function hasProseLines(content: string): boolean;
+export declare function isSidebarStub(ruContent: string, enContent: string): boolean;
+export declare function fileSlug(filePath: string): string;
+export declare function parseLectures(sectionSlug: string, content: string, contentEn: string | null, lectureByNum: Map<string, LecturePage>): Lecture[];
+export declare function createWikiData(sources: RawWikiSources): WikiData;

package/dist/hooks/useLanguage.d.ts

@@ -0,0 +1,4 @@
+export declare function useLanguage(defaultLang?: string): {
+    lang: string;
+    setLang: import("react").Dispatch<import("react").SetStateAction<string>>;
+};

package/dist/hooks/useTheme.d.ts

@@ -0,0 +1,5 @@
+export type Theme = "light" | "dark";
+export declare function useTheme(): {
+    theme: Theme;
+    toggle: () => void;
+};

package/dist/hooks/useWiki.d.ts

@@ -0,0 +1,2 @@
+export { useWiki } from "../context/WikiContext";
+export type { WikiContextValue } from "../context/WikiContext";

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+export { WikiApp, WikiRoutes } from "./components/WikiApp";
+export type { WikiAppProps } from "./components/WikiApp";
+export { WikiLayout } from "./components/WikiLayout";
+export { WikiPageView } from "./components/WikiPageView";
+export { LecturePageView } from "./components/LecturePageView";
+export { SearchPopup } from "./components/SearchPopup";
+export { CodeBlockPre } from "./components/CodeBlock";
+export { MermaidDiagram } from "./components/MermaidDiagram";
+export { ZoomableImage } from "./components/ZoomableImage";
+export { DocLinkCard, extractDocUrls } from "./components/DocLinkCard";
+export { CommunityLinks, defaultCommunityLinks, YoutubeIcon, GithubIcon, TelegramIcon, ItchIcon, XIcon, PatreonIcon, BoostyIcon, MediumIcon, UdemyIcon, } from "./components/CommunityLinks";
+export type { CommunityLinkItem } from "./components/CommunityLinks";
+export { CookieConsent } from "./components/CookieConsent";
+export { WikiProvider, WikiContext, useWiki } from "./context/WikiContext";
+export type { WikiContextValue } from "./context/WikiContext";
+export { LangContext, useLang } from "./context/LangContext";
+export { useLanguage } from "./hooks/useLanguage";
+export { useTheme } from "./hooks/useTheme";
+export type { Theme } from "./hooks/useTheme";
+export { initGA, updateConsentState, trackPageView, AnalyticsTracker } from "./analytics";
+export { createWikiData, parseTitle, stripFrontmatter, hasProseLines, isSidebarStub, fileSlug, parseLectures, } from "./data";
+import type { WikiConfig } from "./types";
+export declare function defineWikiConfig(config: WikiConfig): WikiConfig;
+export type { LecturePage, Lecture, WikiPage, RawWikiSources, WikiData, WikiBrandConfig, WikiCategoryConfig, WikiSocialLink, WikiAnalyticsConfig, WikiCookieConsentConfig, WikiConfig, } from "./types";

package/dist/index.js

@@ -0,0 +1,45 @@
+import { cc as s, cd as e, ce as i, cf as o, cg as t, ch as n, ci as r, cj as u, ck as k, cl as m, cm as g, cn as I, co as d, cp as C, cq as L, cr as l, cs as p, ct as P, cu as W, cv as y, cw as f, cx as h, cy as b, cz as x, cA as D, cB as S, cC as w, cD as A, cE as T, cF as B, cG as G, cH as M, cI as V, cJ as v, cK as F, cL as R, cM as U, cN as j, cO as q, cP as z, cQ as E, cR as H } from "./chunks/index-f7Uzykhj.js";
+export {
+  s as AnalyticsTracker,
+  e as BoostyIcon,
+  i as CodeBlockPre,
+  o as CommunityLinks,
+  t as CookieConsent,
+  n as DocLinkCard,
+  r as GithubIcon,
+  u as ItchIcon,
+  k as LangContext,
+  m as LecturePageView,
+  g as MediumIcon,
+  I as MermaidDiagram,
+  d as PatreonIcon,
+  C as SearchPopup,
+  L as TelegramIcon,
+  l as UdemyIcon,
+  p as WikiApp,
+  P as WikiContext,
+  W as WikiLayout,
+  y as WikiPageView,
+  f as WikiProvider,
+  h as WikiRoutes,
+  b as XIcon,
+  x as YoutubeIcon,
+  D as ZoomableImage,
+  S as createWikiData,
+  w as defaultCommunityLinks,
+  A as defineWikiConfig,
+  T as extractDocUrls,
+  B as fileSlug,
+  G as hasProseLines,
+  M as initGA,
+  V as isSidebarStub,
+  v as parseLectures,
+  F as parseTitle,
+  R as stripFrontmatter,
+  U as trackPageView,
+  j as updateConsentState,
+  q as useLang,
+  z as useLanguage,
+  E as useTheme,
+  H as useWiki
+};

package/dist/languages/ue-cpp.d.ts

@@ -0,0 +1,7 @@
+import type { HLJSApi, Language } from "highlight.js";
+export declare const ueC: (hljs: HLJSApi) => Language;
+export declare const ueCpp: (hljs: HLJSApi) => Language;
+export declare const ueLangs: {
+    c: (hljs: HLJSApi) => Language;
+    cpp: (hljs: HLJSApi) => Language;
+};

package/dist/languages/ue-cpp.js

@@ -0,0 +1,21 @@
+import { g as o } from "../chunks/common-BJ4q25wy.js";
+const s = "public protected private virtual override final UCLASS UPROPERTY UFUNCTION UPARAM UINTERFACE UENUM USTRUCT GENERATED_BODY GENERATED_UCLASS_BODY GENERATED_UINTERFACE_BODY GENERATED_USTRUCT_BODY DECLARE_DELEGATE DECLARE_DELEGATE_OneParam DECLARE_DELEGATE_TwoParams DECLARE_MULTICAST_DELEGATE DECLARE_MULTICAST_DELEGATE_OneParam DECLARE_DYNAMIC_MULTICAST_DELEGATE DECLARE_DYNAMIC_MULTICAST_DELEGATE_OneParam DECLARE_DYNAMIC_DELEGATE DECLARE_DYNAMIC_DELEGATE_RetVal TEXT LOCTEXT NSLOCTEXT", C = "int8 int16 int32 int64 uint8 uint16 uint32 uint64 FString FName FText FStringView FVector FVector2D FVector4 FIntVector FIntPoint FRotator FQuat FTransform FMatrix FColor FLinearColor FHitResult FActorSpawnParameters FTimerHandle FTimerDelegate TArray TMap TSet TMultiMap TQueue TOptional TPair TSharedPtr TSharedRef TWeakPtr TUniquePtr TObjectPtr TWeakObjectPtr TSoftObjectPtr TSoftClassPtr TSubclassOf TEnumAsByte TDelegate TMulticastDelegate AActor UObject UActorComponent USceneComponent APawn ACharacter AController APlayerController APlayerState AGameMode AGameModeBase AGameState AGameStateBase UWorld ULevel UGameInstance ULocalPlayer UUserWidget UWidgetComponent UTextBlock UImage UButton UStaticMeshComponent USkeletalMeshComponent UCameraComponent UCharacterMovementComponent UCapsuleComponent", c = s.trim().split(/\s+/), E = C.trim().split(/\s+/), a = [...c, ...E];
+function T(t, r) {
+  Array.isArray(t) && t.push(...r);
+}
+function A(t, r) {
+  if (!t)
+    return { keywords: { keyword: a, type: E }, contains: [] };
+  const e = t(r);
+  if (e.keywords && typeof e.keywords == "object" && !Array.isArray(e.keywords)) {
+    const n = e.keywords;
+    T(n.keyword, a), T(n.type, E);
+  }
+  return e;
+}
+const i = o.c, U = o.cpp, D = (t) => A(i, t), _ = (t) => A(U, t), l = { ...o, c: D, cpp: _ };
+export {
+  D as ueC,
+  _ as ueCpp,
+  l as ueLangs
+};

package/dist/types.d.ts

@@ -0,0 +1,119 @@
+import type { ReactNode, ComponentType } from "react";
+export interface LecturePage {
+    sectionSlug: string;
+    slug: string;
+    title: string;
+    titleEn: string;
+    content: string;
+    contentEn: string | null;
+}
+export interface Lecture {
+    number: string;
+    title: string;
+    titleEn: string;
+    anchorSlug: string;
+    page: LecturePage | null;
+}
+export interface WikiPage {
+    slug: string;
+    title: string;
+    titleEn: string;
+    content: string;
+    contentEn: string | null;
+    lectures: Lecture[];
+}
+export interface RawWikiSources {
+    /** Map of RU section file paths to content (e.g. from import.meta.glob) */
+    sectionsRu?: Record<string, string>;
+    /** Map of EN section file paths to content */
+    sectionsEn?: Record<string, string>;
+    /** Map of RU lecture file paths to content */
+    lecturesRu?: Record<string, string>;
+    /** Map of EN lecture file paths to content */
+    lecturesEn?: Record<string, string>;
+    /** Map of image paths to resolved URLs */
+    images?: Record<string, string>;
+    /**
+     * Alternatively, a unified glob of all markdown files.
+     * e.g. import.meta.glob("./wiki/**\/*.md", { query: "?raw", import: "default", eager: true })
+     */
+    rawDocs?: Record<string, string>;
+}
+export interface WikiData {
+    wikiPages: WikiPage[];
+    wikiIndex?: WikiPage;
+    wikiSections: WikiPage[];
+    lecturePages: Map<string, LecturePage>;
+    lectureByNum: Map<string, LecturePage>;
+    wikiImages: Record<string, string>;
+    getLecturePage: (sectionSlug: string, lectureSlug: string) => LecturePage | undefined;
+}
+export interface WikiBrandConfig {
+    /**
+     * Title displayed in the sidebar header.
+     * Can be a string, a localized object { ru, en }, or a render function.
+     */
+    title: ReactNode | {
+        ru?: ReactNode;
+        en?: ReactNode;
+        [key: string]: ReactNode;
+    };
+    /** Subtitle or second line if applicable */
+    subtitle?: ReactNode | {
+        ru?: ReactNode;
+        en?: ReactNode;
+        [key: string]: ReactNode;
+    };
+    /** Custom logo */
+    logo?: ReactNode;
+    /** Link when clicking header title. Default is "/" */
+    homeLink?: string;
+}
+export interface WikiCategoryConfig {
+    id?: string;
+    label: string | {
+        ru?: string;
+        en?: string;
+        [key: string]: string | undefined;
+    };
+    /** Range of numeric section prefixes (e.g. from "01" to "01", from "02" to "12") */
+    from?: string;
+    to?: string;
+    /** Regex pattern to match section slugs */
+    pattern?: RegExp;
+    /** Custom filter function */
+    filter?: (page: WikiPage) => boolean;
+}
+export interface WikiSocialLink {
+    name: string;
+    url: string;
+    icon?: ReactNode;
+}
+export interface WikiAnalyticsConfig {
+    googleAnalyticsId?: string;
+    linkerDomains?: string[];
+}
+export interface WikiCookieConsentConfig {
+    enabled?: boolean;
+    privacyPolicyUrl?: string;
+    message?: {
+        ru?: string;
+        en?: string;
+    };
+    onConsentChange?: (granted: boolean) => void;
+}
+export interface WikiConfig {
+    brand: WikiBrandConfig;
+    defaultLanguage?: "ru" | "en" | string;
+    supportedLanguages?: ("ru" | "en" | string)[];
+    categories?: WikiCategoryConfig[];
+    socialLinks?: WikiSocialLink[];
+    /** Custom components for markdown rendering (e.g. <community-links />) */
+    customComponents?: Record<string, ComponentType<any>>;
+    /** Custom syntax highlighting languages for lowlight / highlight.js */
+    syntaxLanguages?: Record<string, any>;
+    analytics?: WikiAnalyticsConfig;
+    cookieConsent?: WikiCookieConsentConfig;
+    enableSearch?: boolean;
+    enableThemeToggle?: boolean;
+}

package/dist/wiki-engine.css

@@ -0,0 +1 @@
+pre code.hljs{display:block;overflow-x:auto;padding:1em}code.hljs{padding:3px 5px}.hljs{background:#1e1e1e;color:#dcdcdc}.hljs-keyword,.hljs-literal,.hljs-symbol,.hljs-name{color:#569cd6}.hljs-link{color:#569cd6;text-decoration:underline}.hljs-built_in,.hljs-type{color:#4ec9b0}.hljs-number,.hljs-class{color:#b8d7a3}.hljs-string,.hljs-meta .hljs-string{color:#d69d85}.hljs-regexp,.hljs-template-tag{color:#9a5334}.hljs-subst,.hljs-function,.hljs-title,.hljs-params,.hljs-formula{color:#dcdcdc}.hljs-comment,.hljs-quote{color:#57a64a;font-style:italic}.hljs-doctag{color:#608b4e}.hljs-meta,.hljs-meta .hljs-keyword,.hljs-tag{color:#9b9b9b}.hljs-variable,.hljs-template-variable{color:#bd63c5}.hljs-attr,.hljs-attribute{color:#9cdcfe}.hljs-section{color:gold}.hljs-emphasis{font-style:italic}.hljs-strong{font-weight:700}.hljs-bullet,.hljs-selector-tag,.hljs-selector-id,.hljs-selector-class,.hljs-selector-attr,.hljs-selector-pseudo{color:#d7ba7d}.hljs-addition{background-color:#144212;display:inline-block;width:100%}.hljs-deletion{background-color:#600;display:inline-block;width:100%}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@life-exe/wiki-engine",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Modern, multilingual documentation and wiki engine built with React, Vite, and Tailwind CSS",
+  "author": "Yuri Popov <life-exe>",
+  "license": "MIT",
+  "keywords": [
+    "wiki",
+    "documentation",
+    "docs",
+    "markdown",
+    "react",
+    "vite",
+    "multilingual",
+    "search",
+    "knowledge-base"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/life-exe/wiki-engine.git"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./languages/ue-cpp": {
+      "types": "./dist/languages/ue-cpp.d.ts",
+      "import": "./dist/languages/ue-cpp.js"
+    },
+    "./style.css": "./dist/wiki-engine.css",
+    "./wiki-engine.css": "./dist/wiki-engine.css"
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0",
+    "react-router-dom": ">=6.0.0"
+  },
+  "dependencies": {
+    "clsx": "^2.1.1",
+    "highlight.js": "^11.11.1",
+    "lowlight": "^3.3.0",
+    "lucide-react": "^0.475.0",
+    "mermaid": "^11.15.0",
+    "react-markdown": "^10.1.0",
+    "rehype-highlight": "^7.0.2",
+    "rehype-raw": "^7.0.0",
+    "remark-gfm": "^4.0.1",
+    "tailwind-merge": "^3.0.1"
+  },
+  "devDependencies": {
+    "@types/hast": "^3.0.4",
+    "@types/node": "^25.3.1",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^4.3.4",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "react-router-dom": "^7.14.2",
+    "typescript": "~5.7.2",
+    "vite": "^6.0.5"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build && tsc --emitDeclarationOnly",
+    "typecheck": "tsc --noEmit",
+    "lint": "tsc --noEmit"
+  }
+}