docmedown 0.9.3 → 0.9.5

package/dist/types/runtime/bridges/dynamic-component.d.ts

@@ -19,7 +19,7 @@
  *                                             ▼ Svelte application
  */
 import { createElementBridge, registerWebComponent } from "./element-bridge";
-import { createReactBridge, type DmdElementClass } from "./react-bridge";
+import { createReactBridge } from "./react-bridge";
 export type ComponentKind = "svelte" | "react" | "element";
 export interface DynamicComponent {
     kind: ComponentKind;
@@ -32,12 +32,4 @@ export interface DynamicComponent {
  * Detects whether a component or module represents Svelte, React, or a Web Element / Lit.
  */
 export declare function detectComponentKind(componentOrSource: unknown, filename?: string): ComponentKind;
-/**
- * Adapts any component (Svelte, React, or Web Element/Lit) into a registered Custom Element
- * that can be natively rendered in Markdown with <Name ... /> tags.
- */
-export declare function adaptComponent(name: string, component: unknown, kind?: ComponentKind, tag?: string): {
-    tag: string;
-    elementClass?: DmdElementClass;
-};
 export { createElementBridge, createReactBridge, registerWebComponent };

package/dist/types/runtime/home.d.ts

@@ -10,9 +10,6 @@
  * Documentation inside documentation: when an ancestor documentation manifest is
  * reachable, Home links to the original (outermost) documentation home instead.
  */
-export declare const HOME_CANDIDATE_FILES: readonly ["README.md", "PROJECT.md", "ABOUT.md", "INDEX.md"];
-/** How many directory levels upward to probe for an enclosing documentation root. */
-export declare const ORIGINAL_HOME_MAX_ANCESTORS = 3;
 export interface HomeDocumentInput {
     slug?: string;
     path?: string;
@@ -27,7 +24,7 @@ export interface ResolvedHome {
     /** Set when the home was resolved from an enclosing documentation root. */
     via?: "ancestor";
 }
-export interface MinimalFetchResponse {
+interface MinimalFetchResponse {
     ok: boolean;
     json: () => Promise<unknown>;
 }
@@ -45,3 +42,4 @@ export declare function resolveDocumentationHome(docs: HomeDocumentInput[] | nul
 export declare function findOriginalDocumentationHome(fetchImpl: MinimalFetch, options?: {
     levels?: number;
 }): Promise<ResolvedHome | null>;
+export {};

package/dist/types/runtime/markdown/callouts.d.ts

@@ -1,15 +1,3 @@
-export interface CalloutInfo {
-    type: "note" | "tip" | "important" | "warning" | "caution";
-    title: string;
-    content: string;
-}
-export declare const CALLOUT_ICONS: {
-    note: string;
-    tip: string;
-    important: string;
-    warning: string;
-    caution: string;
-};
 /**
  * Transforms GitHub alert blockquotes into DocMeDown callouts
  * e.g. > [!NOTE] or > [!WARNING] Title

package/dist/types/runtime/markdown/highlighter.d.ts

@@ -12,9 +12,7 @@ import "prismjs/components/prism-markup";
 import "prismjs/components/prism-python";
 import { escapeHtml } from "./escape";
 export { escapeHtml };
-export declare function normalizeLanguage(lang: string): string;
 export declare function registerLanguage(name: string, definition: Record<string, unknown>, color?: string): void;
-export declare function highlightCode(code: string, lang?: string): string;
 export declare function renderCodeBlock(code: string, infoString?: string): string;
 /**
  * Parses the `{1,3-5}` line-highlight syntax from a fence info string.
@@ -22,24 +20,3 @@ export declare function renderCodeBlock(code: string, infoString?: string): stri
  * numbers are simply ignored by the wrapper.
  */
 export declare function parseActiveLines(infoString: string): Set<number>;
-/**
- * Wraps highlighted (or escaped) code into per-line `<span>` blocks for line
- * numbers and line highlighting, without breaking Prism's token markup:
- * token spans that cross a line break are closed before it and reopened after,
- * so every `.dmd-code-line` is a single visual line.
- *
- * **Key design choice:** the trailing "\\n" of every source line is *not*
- * included inside its span.  Each `.dmd-code-line` is `display: block` via
- * CSS, which provides visual line separation and — critically — lets the
- * browser insert `\\n` characters between blocks in `innerText` so manual
- * Ctrl+C selections produce clean code.  Programmatic copies (copy button)
- * reconstruct the text by joining each line's `textContent` with `"\\n"`.
- *
- * Leading whitespace (spaces and tabs) on *non-continuation* lines is
- * converted into small visual indicator spans (`dmd-ws-space` dots,
- * `dmd-ws-tab` arrows) so indentation style is visible at a glance.
- * Continuation lines (those inside a multi-line Prism token such as a
- * triple-quoted string or block comment) are left untouched because their
- * whitespace is content, not indentation.
- */
-export declare function wrapCodeLines(html: string, activeLines?: Set<number>): string;

package/dist/types/runtime/markdown/inline-text.d.ts

@@ -6,6 +6,5 @@
  * pipeline as article headings), while search indexing, document titles, and
  * accessibility strings need the readable plain-text form produced here.
  */
-export declare function decodeHtmlEntities(value: string): string;
 /** Reduces a heading's raw Markdown to readable plain text. */
 export declare function inlineHeadingToPlainText(raw: string): string;

package/dist/types/runtime/markdown/parser.d.ts

@@ -13,5 +13,4 @@ export declare function extractFrontmatter(rawMarkdown: string): {
     content: string;
 };
 export declare function slugifyHeading(text: string): string;
-export declare function calculateReadingTime(text: string): number;
 export declare function parseMarkdown(rawContent: string, currentSlug?: string): ParsedMarkdown;

package/dist/types/runtime/markdown/tables.d.ts

@@ -19,7 +19,7 @@ export interface TableData {
     rows: string[][];
     aligns: TableAlign[];
 }
-export declare const TABLE_COPY_FORMATS: readonly [{
+declare const TABLE_COPY_FORMATS: readonly [{
     readonly id: "markdown";
     readonly label: "Markdown";
     readonly badge: "MD";
@@ -42,8 +42,6 @@ export declare function renderTableBlock(options: {
     rows: TableCell[][];
     caption?: string;
 }): string;
-/** Resolves a `delimiter=` option (`;`, `tab`, `pipe`, …). */
-export declare function resolveDelimiter(value: string | undefined, fallback: string): string;
 /** Picks the most frequent candidate delimiter on the first non-empty line. */
 export declare function detectDelimiter(text: string): string;
 /**
@@ -66,3 +64,4 @@ export declare function tableToHtml(data: TableData): string;
 export declare function formatTable(data: TableData, format: TableCopyFormat): string;
 /** Reads plain-text table data back out of a rendered `.dmd-table-block`. */
 export declare function readTableData(table: HTMLTableElement): TableData;
+export {};

package/dist/types/runtime/media.d.ts

@@ -3,9 +3,6 @@
  * for DocMeDown's <Media /> component and offline distributables.
  */
 export type MediaCategory = "image" | "vector" | "video" | "audio" | "unknown";
-export declare const MEDIA_MIME_TYPES: Record<string, string>;
-/** Extracts extension without dot, query params or hash fragments. */
-export declare function extractExtension(urlOrPath: string): string;
 /** Determines MIME type from file extension or explicit type hint. */
 export declare function resolveMimeType(urlOrPath: string, explicitType?: string): string;
 /**

package/dist/types/runtime/offline-export.d.ts

@@ -1,8 +1,7 @@
 import { type SplashOptions } from "./splash";
 import type { DocManifest } from "./types";
 export declare const OFFLINE_FORMAT_VERSION = 2;
-export declare const OFFLINE_RUNTIME_SCRIPT_ATTRIBUTE = "data-docmedown-runtime";
-export interface OfflineDocumentationData {
+interface OfflineDocumentationData {
     manifest: DocManifest;
     docs: Record<string, string>;
     componentsSource?: string;
@@ -56,3 +55,4 @@ export declare function matchEmbeddedNestedSite(href: string, sites: Record<stri
  * relative link is ever required.
  */
 export declare function openEmbeddedNestedSite(siteKey: string, href?: string): Promise<void>;
+export {};

package/dist/types/runtime/splash.d.ts

@@ -33,8 +33,6 @@ export declare const SPLASH_ACTIVE_CLASS = "dmd-splash-active";
 export declare const SPLASH_START_KEY = "__DOCMEDOWN_SPLASH_START__";
 /** Minimum brand time before the splash may be dismissed, in milliseconds. */
 export declare const SPLASH_MIN_DURATION_MS = 950;
-/** Must match the `#dmd-splash` transition duration in the stylesheet below. */
-export declare const SPLASH_EXIT_MS = 450;
 export interface SplashOptions {
     /** Documentation name rendered in the top-bar brand lockup. */
     name?: string;

package/dist/types/runtime/svelte-compiler-loader.d.ts

@@ -9,6 +9,5 @@ export interface SvelteCompilerEngine {
     compile: typeof import("svelte/compiler").compile;
 }
 export declare function configureCompilerEngine(basePath?: string): void;
-export declare function loadExternalCompilerEngine(): Promise<SvelteCompilerEngine>;
 /** Resolves the Svelte compiler engine once, from the external bundle or a dynamic import. */
 export declare function loadCompilerEngine(): Promise<SvelteCompilerEngine>;

package/dist/types/runtime/svelte-runtime.d.ts

@@ -1,28 +1,10 @@
 import { ensureCustomElementTag } from "./svelte-tag";
 export { ensureCustomElementTag };
-export interface CompiledSvelteResult {
-    js: string;
-    css?: string;
-    tag: string;
-}
 /**
  * Rewrites bare `svelte` and `svelte/internal/client` ESM imports to use the
  * globally exposed Svelte 5 runtime primitives when evaluated as a Blob module.
  */
 export declare function linkSveltePrimitives(jsCode: string): string;
-/**
- * Compiles a raw `.svelte` source string into client JavaScript with custom element registration.
- */
-export declare function compileSvelteComponent(source: string, options: {
-    name: string;
-    tag?: string;
-    filename?: string;
-}): Promise<CompiledSvelteResult>;
-/**
- * Evaluates compiled Svelte 5 component JavaScript in the browser as a Blob module.
- * The module automatically invokes `customElements.define()` upon execution.
- */
-export declare function evaluateCompiledSvelte(jsCode: string): Promise<unknown>;
 /**
  * Fetches, compiles, and registers a remote or local `.svelte` component on the fly.
  */

package/dist/types/runtime/svelte-tag.d.ts

@@ -1,4 +1,3 @@
-export declare function toKebab(name: string): string;
 /** Canonical custom element tag for a component name: "CounterWidget" → "dmd-counter-widget". */
 export declare function dmdTag(name: string): string;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docmedown",
-  "version": "0.9.3",
+  "version": "0.9.5",
   "description": "The simplest MarkDown documenter yet. CLI, web script, and static-site compiler with AI-native distribution.",
   "author": "Gabriel M. P. da Silva",
   "license": "Apache-2.0",

package/templates/getting-started.md

@@ -19,7 +19,7 @@ You can initialize a brand new documentation site with a single command:
 npx docmedown ./docs
 ```
 
-This scaffolds your documentation directory, creates starter Markdown guides, and starts a live preview server!
+This scaffolds your documentation directory, automatically links any root `*.md` files (like `README.md`, `CONTRIBUTING.md`, `CHANGELOG.md`) alongside your `./docs/` folder without an artificial subdivision, and starts a live preview server!
 
 ---