@thallylabs/migrate 0.2.4 → 0.2.5

package/README.md

@@ -19,3 +19,28 @@ Docusaurus sidebars are parsed as bounded, data-only JSON5—never executed—an
 preserve explicit categories, autogenerated slices, document IDs/slugs,
 positions, generated indexes, admonitions, tabs, and `static/` assets where
 supported.
+
+## Mintlify compatibility
+
+Repository imports preserve named/default local JSX and TSX components and
+their bounded, static local dependency graph in `src/mdx/migrated/`. Components
+are registered through the customer-owned `src/mdx/custom-components.tsx`;
+existing object-literal registries are merged rather than replaced. Repeated
+imports of the same registry are idempotent. Registry shapes that cannot be
+merged safely stop materialization with an actionable error.
+Component output is namespaced by repository and documentation root, so
+separate imports can preserve components with identical source filenames.
+
+The importer creates a root redirect to the first available page in source
+navigation when no root introduction exists, while retaining a separate custom
+homepage and explicit redirects. Locale tags and recognized locale-prefixed
+sections are normalized without discarding original URL redirects.
+
+Simple interactive HTML blocks in MDX are extracted into client components.
+The Mintlify `search-bar-entry` click trigger is mapped to Thally's search
+shortcut. Markdown mixed inside interactive JSX, computed imports, namespace
+imports, and external packages that require installation are reported for
+manual review. Unsupported source is preserved, not replaced with empty stubs.
+File paths cannot escape the documentation root; symlinks and oversized graphs
+are rejected. This is compatibility analysis, **not a code sandbox**: imported
+JavaScript executes when the developer builds or runs the resulting site.

package/dist/index.d.ts

@@ -57,6 +57,9 @@ interface MigrationFooterConfig {
     }>;
 }
 interface MigrationDocsConfig {
+    markdown?: {
+        enabled?: boolean;
+    };
     tabs: Array<MigrationNavigationTab>;
     navigation?: {
         /** How sibling documentation collections are presented to readers. */
@@ -141,6 +144,8 @@ interface MigrationBundle {
     platform: MigrationPlatform;
     pages: Array<MigrationPage>;
     assets: Array<MigrationAsset>;
+    /** Customer-owned component source and registry; paths are repository-relative. */
+    componentFiles?: Array<RenderedMigrationFile>;
     docsConfig: MigrationDocsConfig;
     site?: {
         name?: string;
@@ -276,6 +281,7 @@ declare function mergeMigrationConfig(existing: MigrationDocsConfig, incoming: M
 /** Materialize every canonical page, asset, and config as repository file changes. */
 declare function renderMigrationFiles(bundle: MigrationBundle, options?: {
     existingConfig?: MigrationDocsConfig;
+    existingComponentRegistry?: string;
 }): Array<RenderedMigrationFile>;
 
 /**