media-remux 0.0.0-stage → 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-PRESENT ntnyq <https://github.com/ntnyq>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,81 @@
-# Temporary Holding Version
+# media-remux
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![CI](https://github.com/ntnyq/media-remux/workflows/CI/badge.svg)](https://github.com/ntnyq/media-remux/actions)
+[![NPM VERSION](https://img.shields.io/npm/v/media-remux.svg)](https://www.npmjs.com/package/media-remux)
+[![NPM DOWNLOADS](https://img.shields.io/npm/dy/media-remux.svg)](https://www.npmjs.com/package/media-remux)
+[![LICENSE](https://img.shields.io/github/license/ntnyq/media-remux.svg)](https://github.com/ntnyq/media-remux/blob/main/LICENSE)
+
+Disk-backed media remuxing, track combining, and segment concatenation for browsers without re-encoding.
+
+## Status
+
+Early development. This repository currently contains the package scaffold, ESM build, TypeScript declaration output, and development tooling. No media-processing API is implemented or exported yet.
+
+The implementation will be extracted from a browser extension. The Mediabunny patch and storage adapters have not been migrated into this package yet.
+
+## Planned scope
+
+- Combine separate MP4 video and audio inputs into fragmented MP4.
+- Remux an AAC track from an MP4 input into fragmented M4A.
+- Remux H.264/AAC FLV inputs into fragmented MP4.
+- Concatenate compatible FLV or MP4 segments in order, with explicit timeline and codec-configuration checks.
+- Use the Origin Private File System (OPFS) for temporary media, sample metadata, and fragment indexes to reduce memory growth when processing large files.
+- Run media processing in a dedicated Worker with progress reporting, cancellation, and temporary-file cleanup.
+
+The package is intended to work with media inputs independently of any website or extension framework. Site-specific APIs, authentication, quality selection, manifest parsing, and downloading remain the caller's responsibility.
+
+Re-encoding, filters, DRM handling, and arbitrary frame-accurate editing are outside the initial scope. Disk-backed processing does not imply constant memory usage: individual encoded packets, source caches, and codec metadata still consume memory.
+
+## Architecture
+
+- **Media core:** encoded-packet reading, track selection, timelines, remuxing, track combining, and segment concatenation.
+- **Storage adapters:** positioned temporary-file reads and writes, starting with OPFS.
+- **Browser execution:** Worker orchestration, progress, cancellation, and output-file lifecycle.
+
+The initial target is modern browsers with OPFS and Worker support. WXT, Vue, and site-specific types will stay outside the package. Node.js media processing requires a separate storage adapter and validation.
+
+Large-file support depends on changes to Mediabunny internals. Before an npm release, those changes must be delivered through upstream support or a versioned patched dependency, with the required third-party license notices. A wrapper around unmodified Mediabunny alone will not provide these capabilities.
+
+## Installation
+
+The intended package name is `media-remux`. After the first npm release:
+
+```sh
+pnpm add media-remux
+```
+
+Usage examples will be added when the public API is implemented and validated.
+
+## Development
+
+Use Node.js `^22.18.0 || ^24.11.0 || >=26.0.0` and the pnpm version pinned in `package.json`.
+
+```sh
+pnpm install
+pnpm dev
+```
+
+| Command               | Description                                                         |
+| --------------------- | ------------------------------------------------------------------- |
+| `pnpm dev`            | Build in watch mode                                                 |
+| `pnpm build`          | Build ESM and TypeScript declarations into `dist/`                  |
+| `pnpm format:check`   | Check formatting                                                    |
+| `pnpm lint`           | Run Oxlint                                                          |
+| `pnpm typecheck`      | Check TypeScript types                                              |
+| `pnpm test`           | Run Vitest; currently allows an empty test suite during scaffolding |
+| `pnpm release:check`  | Run formatting, lint, type, and test checks                         |
+| `pnpm pack --dry-run` | Inspect package contents without creating a tarball                 |
+
+The package publishes `dist/` alongside the README, license, and package metadata. The root entry is reserved for the future public API; `media-remux/package.json` exposes package metadata.
+
+Before submitting changes:
+
+```sh
+pnpm release:check
+pnpm build
+pnpm pack --dry-run
+```
+
+## License
+
+[MIT](./LICENSE) License © 2026-PRESENT [ntnyq](https://github.com/ntnyq)

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {}

package/package.json

@@ -1,6 +1,85 @@
 {
   "name": "media-remux",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.0",
+  "description": "Disk-backed media remuxing, track combining, and segment concatenation for browsers without re-encoding.",
+  "keywords": [
+    "audio",
+    "browser",
+    "flv",
+    "fmp4",
+    "m4a",
+    "media",
+    "mediabunny",
+    "mp4",
+    "opfs",
+    "remux",
+    "video",
+    "web-worker"
+  ],
+  "homepage": "https://github.com/ntnyq/media-remux#readme",
+  "bugs": {
+    "url": "https://github.com/ntnyq/media-remux/issues"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "ntnyq",
+    "email": "ntnyq13@gmail.com",
+    "url": "https://github.com/ntnyq"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ntnyq/media-remux.git"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "format": "oxfmt",
+    "format:check": "oxfmt --check",
+    "lint": "oxlint",
+    "prepare": "husky",
+    "prepublishOnly": "pnpm run build",
+    "release": "run-s release:check release:version",
+    "release:check": "run-s format:check lint typecheck test",
+    "release:version": "bumpp",
+    "test": "vitest --passWithNoTests",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@ntnyq/tsconfig": "^3.1.0",
+    "@types/node": "^26.6.6",
+    "bumpp": "^12.3.0",
+    "husky": "^9.1.7",
+    "nano-staged": "^1.0.2",
+    "npm-run-all2": "^9.0.4",
+    "oxfmt": "^0.75.0",
+    "oxlint": "^1.90.0",
+    "tsdown": "^0.23.4",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.5"
+  },
+  "nano-staged": {
+    "*.{js,ts,mjs,tsx}": "oxlint --fix --no-error-on-unmatched-pattern",
+    "*": "oxfmt --no-error-on-unmatched-pattern"
+  },
+  "engines": {
+    "node": "^22.18.0 || ^24.11.0 || >=26.0.0"
+  },
+  "packageManager": "pnpm@12.16.1"
+}