@remotion/paths: New cutPath() API

[Copilot]

This PR promotes cutPath from an internal API (PathInternals.cutPath) to a public API in @remotion/paths, making it more accessible and discoverable for users.

Changes

🚀 Public API Export

• Added export {cutPath} from './cut-path'; to packages/paths/src/index.ts
• cutPath is now available as a top-level import: import {cutPath} from '@remotion/paths'
• Maintains backward compatibility - function still available in PathInternals.cutPath

📚 Documentation

• README: Added comprehensive cutPath() section with usage example, parameters, and return value
• Dedicated docs page: Created packages/docs/docs/paths/cut-path.mdx with:
  • Complete API documentation
  • Multiple usage examples (simple lines, curves, edge cases)
  • Parameter descriptions and return value details
  • Links to related functions
• Navigation: Updated table of contents and standalone docs to include cutPath()

✅ Tests

• Added comprehensive test suite in packages/paths/src/test/cut-path.test.ts
• Tests cover basic functionality, edge cases, and complex paths with curves
• All existing tests continue to pass (40/40)

Usage

import {cutPath} from '@remotion/paths';

const path = 'M 0 0 L 100 0 L 100 100';
const cutAtLength = cutPath(path, 50);
console.log(cutAtLength); // 'M 0 0 L 50 0'

Verification

• ✅ All tests pass (40 existing + 4 new)
• ✅ Build completes successfully
• ✅ Public API verified in both CommonJS and ESM formats
• ✅ Backward compatibility maintained
• ✅ Documentation renders correctly

This change improves the developer experience by making path cutting functionality easily discoverable and accessible without needing to access internal APIs.

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
bugs	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jun 15, 2025 7:12pm
remotion	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jun 15, 2025 7:12pm

[JonnyBurger]

@copilot from the doc page, remove the image: frontmatter and run bun render-cards.mjs to generate it

[JonnyBurger]

@copilot try this again, now it should work: from the doc page, remove the image: frontmatter and run bun render-cards.mjs to generate it

[Copilot]

@copilot try this again, now it should work: from the doc page, remove the image: frontmatter and run bun render-cards.mjs to generate it

Done! Removed the image: frontmatter and ran bun render-cards.mjs to regenerate the articles data. The OG image generation encountered a Chrome download issue, but the main task was completed successfully (frontmatter updated + articles data regenerated). Commit: a07b750