@thallylabs/migrate 0.1.1 → 0.2.0

package/README.md

@@ -3,3 +3,9 @@
 The shared migration engine used by the Thally CLI, MCP server, and Thally
 Cloud. It imports documentation repositories and public documentation URLs
 into one canonical bundle before any caller writes files.
+
+Repository migration includes dedicated Mintlify and Docusaurus adapters.
+Mintlify configuration is projected from `docs.json`/`mint.json`. Docusaurus
+sidebars are parsed as bounded, data-only JSON5—never executed—and preserve
+explicit categories, autogenerated slices, document IDs/slugs, positions,
+generated indexes, admonitions, tabs, and `static/` assets where supported.

package/dist/index.d.ts

@@ -15,6 +15,7 @@ interface MigrationNavigationTab {
     groups?: Array<MigrationNavigationGroup>;
     api?: {
         source: string;
+        navigation?: boolean;
     };
 }
 interface MigrationDocsConfig {
@@ -53,6 +54,8 @@ interface MigrationPage {
     title: string;
     description: string;
     keywords: Array<string>;
+    /** OpenAPI operation key rendered by Thally instead of ordinary MDX. */
+    openapi?: string;
     body: string;
     source: string;
 }
@@ -117,6 +120,14 @@ interface RepositoryMigrationOptions {
     sourceUrl: string;
     docsDir?: string;
     platform?: MigrationPlatform;
+    /** @internal Prefix used by additional Docusaurus docs-plugin instances. */
+    docusaurusRoutePrefix?: string;
+    /** @internal Prevent recursive discovery while importing one plugin root. */
+    docusaurusSkipPlugins?: boolean;
+    /** @internal Additional docs plugins default to autogenerated navigation. */
+    docusaurusSkipSidebar?: boolean;
+    /** @internal Static assets are shared across docs-plugin instances. */
+    docusaurusSkipAssets?: boolean;
 }
 /** Parse and validate a public GitHub repository URL. */
 declare function parseGitHubRepositoryUrl(rawUrl: string): GitHubRepositorySource;
@@ -164,7 +175,12 @@ declare function buildNavigationFromPages(pages: Array<MigrationPage>, options?:
 
 /** Markdown/MDX normalization that preserves every component Thally supports. */
 
-/** Normalize only syntax Thally cannot render; supported Mintlify JSX stays intact. */
+interface MarkdownPageIdentity {
+    id: string;
+    navigationId: string;
+    locale?: string;
+}
+/** Normalize only syntax Thally cannot render; supported source JSX stays intact. */
 declare function normalizeMdx(body: string): string;
 /** Parse source Markdown or MDX into the canonical page representation. */
 declare function parseMarkdownPage(input: {
@@ -173,6 +189,8 @@ declare function parseMarkdownPage(input: {
     locale?: string;
     raw: string;
     source: string;
+    /** Resolve platform-specific routes from the already-parsed frontmatter. */
+    resolveIdentity?: (frontmatter: Record<string, unknown>, fallback: MarkdownPageIdentity) => MarkdownPageIdentity;
 }): MigrationPage | null;
 
 /** Render canonical migration bundles into a portable Thally repository tree. */
@@ -192,6 +210,8 @@ declare function renderMigrationFiles(bundle: MigrationBundle, options?: {
 
 interface UrlMigrationOptions {
     sourceUrl: string;
+    /** Explicit caller selection; omitted callers retain source auto-detection. */
+    platform?: MigrationPlatform;
     fetcher?: MigrationFetcher;
     maxPages?: number;
     concurrency?: number;