@audio/spectral 1.0.0

package/LICENSE

@@ -0,0 +1,40 @@
+Kṛṣnized
+
+This is a reminder that, in the absolute sense, all results of work belong to the Supreme.
+
+While software and intellectual property (IP) require a formal license to define authorship,
+responsibilities, or distribution limitations, these are temporary material designations.
+The origin and destination of all ideas, as well as the ultimate owner of all results,
+is the Supreme. The most meaningful action is to dedicate these results to the Supreme.
+This process is known as Karma-Yoga and is described in BG 3.9, BG 12.10 and BG 18.46.
+
+"Work done as a sacrifice for the Supreme must be performed;
+otherwise, work binds one to the material world."
+
+This license does not override or alter the terms specified by the material-level license below.
+
+ॐ
+
+---
+
+MIT License
+
+Copyright (c) Dmitry Iv
+
+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

@@ -0,0 +1,7 @@
+# @audio/spectral
+
+> Spectral features — centroid, spread, flatness, rolloff, flux, slope, crest. All planned.
+
+Also planned: `spectral-mfcc` (librosa parity), `spectral-ltas` (adaptive/match-EQ substrate), `spectral-edit` (time×frequency region editing — Audacity/afftfilt class).
+
+Reference implementations exist in the `audio` package stats (`centroid`, `flatness`, `crest` shipped there — extract, don't rewrite). Parity: FFmpeg `aspectralstats`, MIREX spectral features. LTAS / spectral-stats for the Auto-Chain analyser build on these atoms.

package/index.js

@@ -0,0 +1,16 @@
+// @audio/spectral — spectral features & editing umbrella re-exporting every @audio/spectral-* atom.
+
+export { default as centroid } from '@audio/spectral-centroid'
+export { default as spread } from '@audio/spectral-spread'
+export { default as flatness } from '@audio/spectral-flatness'
+export { default as rolloff } from '@audio/spectral-rolloff'
+export { default as flux } from '@audio/spectral-flux'
+export { default as slope } from '@audio/spectral-slope'
+export { default as crest } from '@audio/spectral-crest'
+export { default as mfcc } from '@audio/spectral-mfcc'
+export { default as ltas } from '@audio/spectral-ltas'
+export { default as edit } from '@audio/spectral-edit'
+export { default as freeze } from '@audio/spectral-freeze'
+export { default as contrast } from '@audio/spectral-contrast'
+export { default as harmonics } from '@audio/spectral-harmonics'
+export { default as cqt } from '@audio/spectral-cqt'

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@audio/spectral",
+  "version": "1.0.0",
+  "type": "module",
+  "sideEffects": false,
+  "description": "Spectral features — umbrella for @audio/spectral-* atoms (centroid, spread, flatness, rolloff, flux, slope, crest)",
+  "workspaces": [
+    "packages/*"
+  ],
+  "keywords": [
+    "audio",
+    "dsp",
+    "spectral",
+    "features",
+    "mir"
+  ],
+  "license": "MIT",
+  "author": "Dmitry Iv. <dfcreative@gmail.com>",
+  "engines": {
+    "node": ">=18"
+  },
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.js"
+  ],
+  "scripts": {
+    "test": "node test.js",
+    "test:all": "npm test --workspaces --if-present && npm test",
+    "publish:all": "npm publish --workspaces && npm publish"
+  },
+  "dependencies": {
+    "@audio/spectral-centroid": "^1.0.0",
+    "@audio/spectral-spread": "^1.0.0",
+    "@audio/spectral-flatness": "^1.0.0",
+    "@audio/spectral-rolloff": "^1.0.0",
+    "@audio/spectral-flux": "^1.0.0",
+    "@audio/spectral-slope": "^1.0.0",
+    "@audio/spectral-crest": "^1.0.0",
+    "@audio/spectral-mfcc": "^1.0.0",
+    "@audio/spectral-ltas": "^1.0.0",
+    "@audio/spectral-edit": "^1.0.0",
+    "@audio/spectral-freeze": "^1.0.0",
+    "@audio/spectral-contrast": "^1.0.0",
+    "@audio/spectral-harmonics": "^1.0.0",
+    "@audio/spectral-cqt": "^1.0.0"
+  },
+  "devDependencies": {
+    "tst": "^9.4.0",
+    "fourier-transform": "^2.2.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}