{"_id":"@demi-valerith/yard-material-coverage-data","_rev":"3-aa3b35d0a8e34c4ceeafd2840bc2143c","name":"@demi-valerith/yard-material-coverage-data","dist-tags":{"latest":"1.3.0"},"versions":{"1.1.0":{"name":"@demi-valerith/yard-material-coverage-data","version":"1.1.0","keywords":["landscaping","yard-calculator","cubic-yards","gravel","topsoil","mulch","open-data"],"license":"CC-BY-4.0","_id":"@demi-valerith/yard-material-coverage-data@1.1.0","maintainers":[{"name":"demi-valerith","email":"demi@aix4u.com"}],"homepage":"https://yardmaterialtools.com/material-coverage-chart","bugs":{"url":"https://github.com/demi-valerith/yard-material-coverage-data/issues"},"dist":{"shasum":"cdef9d5e9a3a29935328105fc505eef382a82a6b","tarball":"https://registry.npmjs.org/@demi-valerith/yard-material-coverage-data/-/yard-material-coverage-data-1.1.0.tgz","fileCount":12,"integrity":"sha512-kXYqWyB4An13OgzzjW6WTD1PCCdiaEZeBFZJpKiyqLdnEp95sUchbGKu72x3cZu6cuFqPJr95P8IGq/w3g9bJw==","signatures":[{"sig":"MEQCIEnUcDtvtpu4NgoAryKExQPIQzit2+muA+TdrUVoeHPMAiBzOmA3HC3Pdtcl9vxDoJXUoN7WdtgXFpPrGxxAGr68hA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":13040},"main":"./index.js","type":"module","types":"./index.d.ts","engines":{"node":">=20.10"},"exports":{".":{"types":"./index.d.ts","import":"./index.js","default":"./index.js"},"./coverage.json":"./coverage.json"},"gitHead":"2fe1204f076c5d8c2b98bd15d6de2e4520b1df48","scripts":{"test":"node --test"},"_npmUser":{"name":"demi-valerith","email":"demi@aix4u.com"},"repository":{"url":"git+https://github.com/demi-valerith/yard-material-coverage-data.git","type":"git"},"_npmVersion":"10.9.8","description":"Open cubic-yard coverage, material density, and bag conversion data for landscape planning.","directories":{},"sideEffects":false,"_nodeVersion":"22.22.3","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/yard-material-coverage-data_1.1.0_1784531814376_0.4225097279630716","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@demi-valerith/yard-material-coverage-data","version":"1.2.0","keywords":["landscaping","yard-calculator","cubic-yards","gravel","topsoil","mulch","open-data"],"license":"CC-BY-4.0","_id":"@demi-valerith/yard-material-coverage-data@1.2.0","maintainers":[{"name":"demi-valerith","email":"demi@aix4u.com"}],"homepage":"https://yardmaterialtools.com/material-coverage-chart","bugs":{"url":"https://github.com/demi-valerith/yard-material-coverage-data/issues"},"dist":{"shasum":"e59fc42cb9c505d06108d4f2f8856a6bebb10bfe","tarball":"https://registry.npmjs.org/@demi-valerith/yard-material-coverage-data/-/yard-material-coverage-data-1.2.0.tgz","fileCount":14,"integrity":"sha512-FlnYlYWXCrEHfQVId8nhYYwCt6zMXHbBPF0q0MxlbQOEm5TDMZ3/21o80clBfr1O1boGfatTP8+N81kKAqjHfw==","signatures":[{"sig":"MEUCIGk9MMIN6txJboJts/bkKAbMtpJD7BsgDdl881mBgqrYAiEAy6o5KJ0G66ZkQWmKI/CPV0ZWy6MpYVvJeNuivTaxr/o=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@demi-valerith%2fyard-material-coverage-data@1.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":22580},"main":"./index.js","type":"module","types":"./index.d.ts","engines":{"node":">=20.10"},"exports":{".":{"types":"./index.d.ts","import":"./index.js","default":"./index.js"},"./widget":{"types":"./widget.d.ts","import":"./widget.js","default":"./widget.js"},"./coverage.json":"./coverage.json"},"gitHead":"80ca8d5cc37b9286b68f2553e64a474f809617a2","scripts":{"test":"node --test"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:959e5ded-4742-4164-b931-7ede32a482c3"}},"repository":{"url":"git+https://github.com/demi-valerith/yard-material-coverage-data.git","type":"git"},"_npmVersion":"11.16.0","description":"Open cubic-yard coverage, material density, and bag conversion data for landscape planning.","directories":{},"sideEffects":["./widget.js"],"_nodeVersion":"24.18.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/yard-material-coverage-data_1.2.0_1784532638180_0.39540330900201215","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"@demi-valerith/yard-material-coverage-data","version":"1.3.0","description":"Open cubic-yard coverage, material density, and bag conversion data for landscape planning.","type":"module","main":"./index.js","types":"./index.d.ts","exports":{".":{"types":"./index.d.ts","import":"./index.js","default":"./index.js"},"./coverage.json":"./coverage.json","./widget":{"types":"./widget.d.ts","import":"./widget.js","default":"./widget.js"}},"scripts":{"test":"node --test"},"engines":{"node":">=20.10"},"sideEffects":["./widget.js"],"license":"SEE LICENSE IN LICENSE.md","repository":{"type":"git","url":"git+https://github.com/demi-valerith/yard-material-coverage-data.git"},"homepage":"https://yardmaterialtools.com/material-coverage-chart","bugs":{"url":"https://github.com/demi-valerith/yard-material-coverage-data/issues"},"keywords":["landscaping","yard-calculator","cubic-yards","gravel","topsoil","mulch","open-data"],"publishConfig":{"access":"public"},"gitHead":"5128ac294597d9368a9220b337bdabe12975fd65","_id":"@demi-valerith/yard-material-coverage-data@1.3.0","_nodeVersion":"24.18.0","_npmVersion":"11.16.0","dist":{"integrity":"sha512-0FtLe3TteUxnK8yCBfm/ur/I+2+bsbXGeJS18FR3cfqV/hznN22rEiL2v1zqAet4ou+CnqGHd1whk4KZjzzQEw==","shasum":"61ae15f582c68b60667bfbf39fb6d86efb26fd79","tarball":"https://registry.npmjs.org/@demi-valerith/yard-material-coverage-data/-/yard-material-coverage-data-1.3.0.tgz","fileCount":19,"unpackedSize":31706,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@demi-valerith%2fyard-material-coverage-data@1.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCnu07kaq4LBzRvSbsrSdOo7VrdJ1SH3lX5xs/UImSQPQIhAIfpSOYOlZEGIG4Cn4Rmz3D0AskiqNRdZznrvr5wLO+2"}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:959e5ded-4742-4164-b931-7ede32a482c3"}},"directories":{},"maintainers":[{"name":"demi-valerith","email":"demi@aix4u.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/yard-material-coverage-data_1.3.0_1784822691417_0.5300876764660676"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-20T07:16:54.190Z","modified":"2026-07-23T16:04:51.973Z","1.1.0":"2026-07-20T07:16:54.503Z","1.2.0":"2026-07-20T07:30:38.308Z","1.3.0":"2026-07-23T16:04:51.624Z"},"bugs":{"url":"https://github.com/demi-valerith/yard-material-coverage-data/issues"},"license":"SEE LICENSE IN LICENSE.md","homepage":"https://yardmaterialtools.com/material-coverage-chart","keywords":["landscaping","yard-calculator","cubic-yards","gravel","topsoil","mulch","open-data"],"repository":{"type":"git","url":"git+https://github.com/demi-valerith/yard-material-coverage-data.git"},"description":"Open cubic-yard coverage, material density, and bag conversion data for landscape planning.","maintainers":[{"name":"demi-valerith","email":"demi@aix4u.com"}],"readme":"# Yard Material Coverage Data\n\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.21370505.svg)](https://doi.org/10.5281/zenodo.21370505)\n\nDataset version 1.1.0. Package and widget version 1.3.0.\n\nOpen planning data for common yard and landscape materials:\n\n- square feet covered by one cubic yard at common depths;\n- typical tons per cubic yard by material;\n- common bag counts per cubic yard.\n\nThe files are intended for calculators, supplier resource pages, garden-planning\nworksheets, and educational examples. Values are planning estimates; moisture,\ngradation, compaction, bag fill, and supplier measurements vary.\n\n## Install\n\n```sh\nnpm install @demi-valerith/yard-material-coverage-data\n```\n\n```js\nimport coverageData, {\n  cubicYardsRequired,\n  findMaterialDensity,\n  squareFeetPerCubicYard,\n} from \"@demi-valerith/yard-material-coverage-data\";\n\nsquareFeetPerCubicYard(3); // 108\ncubicYardsRequired(500, 3); // 4.6296...\nfindMaterialDensity(\"pea gravel\"); // { minimum: 1.25, maximum: 1.4, ... }\nconsole.log(coverageData.bagsPerCubicYard);\n```\n\nThe package is an ESM module and includes TypeScript declarations. The versioned\nJSON file is also available without installation from jsDelivr:\n\n<https://cdn.jsdelivr.net/npm/@demi-valerith/yard-material-coverage-data@1.1.0/coverage.json>\n\n## Embeddable coverage widget\n\nAdd the calculator to a supplier resource page, landscaping article, or project guide:\n\n```html\n<script\n  type=\"module\"\n  src=\"https://cdn.jsdelivr.net/npm/@demi-valerith/yard-material-coverage-data@1.3.0/widget.js\"\n></script>\n<yard-material-coverage\n  material=\"Pea gravel\"\n  materials=\"Pea gravel,Crushed stone,River rock\"\n  area=\"500\"\n  depth=\"3\"\n  unit=\"imperial\"\n  accent=\"#ab4c29\"\n  attribution=\"visible\"\n  utm-source=\"supplier_site\"\n  utm-campaign=\"coverage_widget\"\n></yard-material-coverage>\n```\n\nThe widget is responsive, dependency-free, and supports:\n\n- `material`: initial material name or hyphenated slug;\n- `materials`: comma-separated material allowlist;\n- `area` and `depth`: initial positive numeric values;\n- `unit`: `imperial` for square feet, inches, cubic yards, and short tons, or\n  `metric` for square meters, centimeters, cubic meters, and metric tonnes;\n- `accent`: six-digit hexadecimal result accent color;\n- `attribution`: `visible` by default or `hidden`;\n- `utm-source` and `utm-campaign`: bounded identifiers added to the optional\n  source link.\n\nSee the runnable [plain HTML, React, Astro, and WordPress examples](examples/).\n\n### Privacy and attribution\n\nThe package performs no analytics, storage, cookies, or background network\nrequests. When attribution is visible, UTM parameters are transmitted only if a\nvisitor clicks the source link.\n\nThe source link is optional for the MIT-licensed widget code. Republishing the\nCC BY 4.0 dataset or its documentation still requires appropriate credit and a\nlink to the source chart. The WordPress plugin keeps public attribution opt-in\nto comply with WordPress.org directory rules.\n\n## Files\n\n- [`coverage.json`](coverage.json) - structured coverage, density, and bag-size data\n- [`coverage.csv`](coverage.csv) - cubic-yard coverage by depth\n- [`material-density.csv`](material-density.csv) - typical tons-per-cubic-yard planning ranges\n- [`bag-conversions.csv`](bag-conversions.csv) - common bag counts per cubic yard\n- [`DATA_DICTIONARY.md`](DATA_DICTIONARY.md) - field definitions and units\n- [`METHODOLOGY.md`](METHODOLOGY.md) - formulas, provenance, rounding, and limitations\n- [`CHECKSUMS.txt`](CHECKSUMS.txt) - SHA-256 checksums for release files\n- [`index.html`](index.html) - public reference page for GitHub Pages\n\n## Formula\n\n```text\nsquare feet covered by 1 cubic yard = 324 / depth in inches\ncubic yards required = square feet * depth in inches / 324\n```\n\n## Source and calculators\n\nFull tables, printable assets, assumptions, and project calculators are available\nfrom the [Yard Material Coverage Chart](https://yardmaterialtools.com/material-coverage-chart).\n\nUseful project tools:\n\n- [Gravel calculator](https://yardmaterialtools.com/gravel-calculator)\n- [Topsoil calculator](https://yardmaterialtools.com/top-soil-calculator)\n- [Mulch calculator](https://yardmaterialtools.com/mulch-calculator)\n- [Cubic yards to tons calculator](https://yardmaterialtools.com/cubic-yards-to-tons-calculator)\n\n## License\n\nData and documentation are available under CC BY 4.0. JavaScript, TypeScript\ndeclarations, tests, and examples are available under MIT. See [LICENSE.md](LICENSE.md).\n\n## Citation\n\nUse the repository's [`CITATION.cff`](CITATION.cff) metadata when citing a specific\nrelease.\n\n- Version 1.1.0 DOI: <https://doi.org/10.5281/zenodo.21370505>\n- All-version concept DOI: <https://doi.org/10.5281/zenodo.21370504>\n\nSuggested citation:\n\n> Yard Material Tools. (2026). Yard Material Coverage Data (Version 1.1.0)\n> [Data set]. Zenodo. https://doi.org/10.5281/zenodo.21370505\n","readmeFilename":"README.md"}