npm - bsmnt - Versions diffs - 0.1.2 → 0.2.0 - Mend

bsmnt 0.1.2 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (447) hide show

package/docs/fix-studio-hydration.md DELETED Viewed

@@ -1,46 +0,0 @@
-# Fix: Studio Hydration Errors
-## Problem
-`/studio` route produces two critical React hydration mismatch errors:
-1. **`<body>` style attribute mismatch** — Server renders inline `style={{margin: 0}}` on a nested `<body>` tag that conflicts with the root layout's `<body>`.
-2. **`<html>` tag attribute mismatch** — `dir`, `className` attributes differ between server and client because a second `<html>` tag is rendered inside the root layout's `<html>`.
-### Root Cause
-`app/studio/layout.tsx` renders its own `<html>` and `<body>` tags. In Next.js App Router, nested layouts do **not** replace the root layout — they render **inside** it. This creates duplicate `<html>` and `<body>` elements, causing hydration mismatches.
-## Fix
-### File: `app/studio/layout.tsx`
-**Before:**
-```tsx
-export default function StudioLayout({
-  children,
-}: {
-  children: React.ReactNode;
-}) {
-  return (
-    <html lang="en">
-      <body style={{ margin: 0 }}>{children}</body>
-    </html>
-  );
-}
-```
-**After:**
-```tsx
-export default function StudioLayout({
-  children,
-}: {
-  children: React.ReactNode;
-}) {
-  return children;
-}
-```
-## Notes
-- There is also a `motion() is deprecated. Use motion.create() instead.` warning — this is upstream in the `sanity` package's internal use of framer-motion. No action needed on our end.

package/docs/plans/2026-01-29-sanity-smart-merge-design.md DELETED Viewed

@@ -1,196 +0,0 @@
-# Sanity Smart Merge Integration Design
-> Date: 2026-01-29
-> Status: Approved for implementation
-## Problem
-The current Sanity integration uses `tiged` to overlay files directly onto the selected template. This causes template-specific code to be completely overwritten, losing:
-- Template-specific providers and imports in `app/layout.tsx`
-- Template-specific sitemap entries in `app/sitemap.ts`
-- Other integration checks in `lib/integrations/check-integration.ts`
-## Solution
-Replace the blind file overlay with a **smart merge system** that:
-1. Copies additive files directly (new directories/files)
-2. Intelligently merges files that exist in both template and integration
-## Architecture
-### Current Flow (Broken)
-```
-1. Clone template via tiged
-2. Overlay integration via tiged (OVERWRITES files)
-3. Hydrate package.json
-```
-### New Flow (Smart Merge)
-```
-1. Clone template via tiged → targetDir
-2. Clone integration to TEMP directory (not targetDir)
-3. Process integration files:
-   a. ADDITIVE files → copy directly to targetDir
-   b. MERGE files → read both versions, merge, write result
-4. Clean up temp directory
-5. Hydrate package.json
-```
-## File Classification
-### Files Requiring Smart Merge
-| File | Merge Strategy |
-|------|----------------|
-| `app/layout.tsx` | Add imports, variables, and Sanity components after `{children}` |
-| `app/sitemap.ts` | Add imports and Sanity page/article fetching to return array |
-| `lib/integrations/check-integration.ts` | Append `isSanityConfigured()` function |
-### Additive Files (Direct Copy)
-- `lib/integrations/sanity/` — entire directory
-- `components/ui/sanity-image/` — new component
-- `app/api/draft-mode/` — new API routes
-- `lib/utils/metadata.ts` — new utility
-- `lib/scripts/generate-page.ts` — new script
-## New File Structure
-```
-src/
-├── commands/create.js          # Updated to use new merge logic
-├── mergers/                    # NEW: Smart merge functions
-│   ├── index.js               # Orchestrates merging
-│   ├── config.js              # File classification config
-│   ├── layout-merger.js       # Merges app/layout.tsx
-│   ├── sitemap-merger.js      # Merges app/sitemap.ts
-│   └── check-integration-merger.js  # Merges check-integration.ts
-└── utils/
-    └── file-utils.js          # Helper for reading/writing files
-```
-## Merge Strategies
-### Layout Merger (`app/layout.tsx`)
-**Injected imports:**
-```tsx
-import { draftMode } from 'next/headers'
-import { Suspense } from 'react'
-import { VisualEditing } from 'next-sanity'
-import { SanityLive } from '@/lib/integrations/sanity/live'
-import { isSanityConfigured } from '@/lib/integrations/check-integration'
-```
-**Injected variables (before return):**
-```tsx
-const isDraftMode = (await draftMode()).isEnabled
-const sanityConfigured = isSanityConfigured()
-```
-**Injected components (after {children}):**
-```tsx
-{sanityConfigured && isDraftMode && (
-  <Suspense fallback={null}>
-    <VisualEditing />
-    <SanityLive />
-  </Suspense>
-)}
-```
-### Sitemap Merger (`app/sitemap.ts`)
-**Injected imports:**
-```ts
-import { isSanityConfigured } from '@/lib/integrations/check-integration'
-import { client } from '@/lib/integrations/sanity/client'
-import { ALL_PAGES_SLUGS_QUERY, ALL_ARTICLES_SLUGS_QUERY } from '@/lib/integrations/sanity/queries'
-```
-**Injected fetch logic (before return):**
-```ts
-let sanityPages: MetadataRoute.Sitemap = []
-if (isSanityConfigured() && client) {
-  const [pages, articles] = await Promise.all([
-    client.fetch(ALL_PAGES_SLUGS_QUERY),
-    client.fetch(ALL_ARTICLES_SLUGS_QUERY),
-  ])
-  sanityPages = [
-    ...pages.map((page) => ({
-      url: `${baseUrl}/${page.slug}`,
-      lastModified: new Date(page._updatedAt),
-    })),
-    ...articles.map((article) => ({
-      url: `${baseUrl}/blog/${article.slug}`,
-      lastModified: new Date(article._updatedAt),
-    })),
-  ]
-}
-```
-**Modified return:**
-```ts
-return [
-  ...existingEntries,
-  ...sanityPages,
-]
-```
-### Check-Integration Merger
-**Appended function:**
-```ts
-export function isSanityConfigured(): boolean {
-  return Boolean(
-    process.env.NEXT_PUBLIC_SANITY_PROJECT_ID &&
-    process.env.NEXT_PUBLIC_SANITY_DATASET
-  )
-}
-```
-## Error Handling
-| Scenario | Handling |
-|----------|----------|
-| Template file doesn't exist | Copy from integration instead |
-| Integration file doesn't exist | Skip merge, continue |
-| `{children}` not found in layout | Fallback: append to end of body |
-| No `return` in sitemap | Create new sitemap structure |
-| `isSanityConfigured` already exists | Skip adding function |
-| Template uses different layout function name | Search for default export function |
-## Dependencies
-Add to CLI's `package.json`:
-```json
-{
-  "dependencies": {
-    "ts-morph": "^24.0.0"
-  }
-}
-```
-## User Feedback
-After merging, display:
-```
-✓ Sanity integration added:
-  ✓ Merged: app/layout.tsx
-  ✓ Merged: app/sitemap.ts
-  ✓ Merged: lib/integrations/check-integration.ts
-  ✓ Added: lib/integrations/sanity/ (14 files)
-  ✓ Added: components/ui/sanity-image/
-  ✓ Added: app/api/draft-mode/
-```
-## Implementation Tasks
-1. Create `src/mergers/` directory structure
-2. Implement `config.js` with file classifications
-3. Implement `layout-merger.js`
-4. Implement `sitemap-merger.js`
-5. Implement `check-integration-merger.js`
-6. Implement `index.js` orchestrator with error handling
-7. Update `src/commands/create.js` to use new merge system
-8. Add `ts-morph` dependency
-9. Test with all 4 templates (default, webgl, webgpu, experiment)