{"_id":"@codexcommunion/liturgical-theme","_rev":"2-843c36ea2d7a72e035e5933ca55d563a","name":"@codexcommunion/liturgical-theme","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@codexcommunion/liturgical-theme","version":"1.0.0","keywords":["catholic","liturgical","theming","css","calendar","romcal","colors","seasons","framework-agnostic","lightweight","docusaurus","bootstrap","mantine","tailwind"],"author":{"name":"CodexCommunion"},"license":"MIT","_id":"@codexcommunion/liturgical-theme@1.0.0","maintainers":[{"name":"codexcommunion","email":"codexcommunion@gmail.com"}],"homepage":"https://github.com/codexcommunion/liturgical-theme#readme","bugs":{"url":"https://github.com/codexcommunion/liturgical-theme/issues"},"dist":{"shasum":"a8338dcdcbafb0e74bb36c41b37acfefe7852bbf","tarball":"https://registry.npmjs.org/@codexcommunion/liturgical-theme/-/liturgical-theme-1.0.0.tgz","fileCount":8,"integrity":"sha512-n1ZUhMmI1FeN5pwQGKpXMt/LIZW5R0PrLqvJt7nuwIIQKjJHlLeYI86wOhRJgGHH6aPUlZNqNerSmuJ1L/D99w==","signatures":[{"sig":"MEQCICVDwmT6a0OEdy8mQFs1pKIhzaGLSd6ZnAmXczvM99KFAiBe4qTqCNpz8guFuyY5CAWZGU3MZk6GUAqOkVPmKE4RWw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":59498},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"8e1ea38627a96c539797705f0b25ff4192c565f9","scripts":{"dev":"tsc --watch","lint":"eslint src --ext .ts,.tsx","test":"jest","build":"tsc","format":"prettier --write src/**/*.{ts,tsx}","prepare":"npm run build"},"_npmUser":{"name":"codexcommunion","email":"codexcommunion@gmail.com"},"repository":{"url":"git+https://github.com/codexcommunion/liturgical-theme.git","type":"git"},"_npmVersion":"10.8.2","description":"A lightweight, framework-agnostic liturgical theming package for Catholic websites, combining Catholic CSS variables with liturgical calendar calculations","directories":{},"_nodeVersion":"20.19.3","dependencies":{"romcal":"^1.3.0","catholic-css":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.0.0","eslint":"^8.0.0","ts-jest":"^29.4.0","prettier":"^3.0.0","typescript":"^5.0.0","@types/jest":"^29.0.0","@types/node":"^20.0.0","@types/react":"^18.0.0","@types/react-dom":"^18.0.0","@typescript-eslint/parser":"^6.0.0","@typescript-eslint/eslint-plugin":"^6.0.0"},"peerDependencies":{"react":">=16.8.0","react-dom":">=16.8.0"},"peerDependenciesMeta":{"react":{"optional":true},"react-dom":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/liturgical-theme_1.0.0_1752631605906_0.607655704209328","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@codexcommunion/liturgical-theme","version":"1.0.1","description":"A lightweight, framework-agnostic liturgical theming package for Catholic websites, combining Catholic CSS variables with liturgical calendar calculations","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc","dev":"tsc --watch","prepare":"npm run build","test":"jest","lint":"eslint src --ext .ts,.tsx","format":"prettier --write src/**/*.{ts,tsx}"},"keywords":["catholic","liturgical","theming","css","calendar","romcal","colors","seasons","framework-agnostic","lightweight","docusaurus","bootstrap","mantine","tailwind"],"author":{"name":"CodexCommunion"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/codexcommunion/liturgical-theme.git"},"bugs":{"url":"https://github.com/codexcommunion/liturgical-theme/issues"},"homepage":"https://github.com/codexcommunion/liturgical-theme#readme","dependencies":{"catholic-css":"^1.0.4","romcal":"^1.3.0"},"devDependencies":{"@types/jest":"^29.0.0","@types/node":"^20.0.0","@types/react":"^18.0.0","@types/react-dom":"^18.0.0","@typescript-eslint/eslint-plugin":"^6.0.0","@typescript-eslint/parser":"^6.0.0","eslint":"^8.0.0","jest":"^29.0.0","prettier":"^3.0.0","ts-jest":"^29.4.0","typescript":"^5.0.0"},"peerDependencies":{"react":">=16.8.0","react-dom":">=16.8.0"},"peerDependenciesMeta":{"react":{"optional":true},"react-dom":{"optional":true}},"_id":"@codexcommunion/liturgical-theme@1.0.1","gitHead":"daaff2cecb1282da1fbdf9db361f7476d039370c","_nodeVersion":"20.19.3","_npmVersion":"10.8.2","dist":{"integrity":"sha512-14VOYKgDZGnJCgpyU3L7fNn/b/9QleO2Gia2VBn5cMea61js41x+7cf1YHjVkTO8BB97eaeQ8fKMWVb/cAl4ZQ==","shasum":"e014ad4d0a24bc174b68cc9dc69e245320aeda8c","tarball":"https://registry.npmjs.org/@codexcommunion/liturgical-theme/-/liturgical-theme-1.0.1.tgz","fileCount":8,"unpackedSize":39216,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDM6/MtSXZCfu52mx9+cWu3jpKvBfVwszxZl6UkgDokrQIgSTJoNGbaPpyvdptECDLoatZIvOAzeT2GWcQWpqY9ziY="}]},"_npmUser":{"name":"codexcommunion","email":"codexcommunion@gmail.com"},"directories":{},"maintainers":[{"name":"codexcommunion","email":"codexcommunion@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/liturgical-theme_1.0.1_1752672450977_0.08587107551799322"},"_hasShrinkwrap":false}},"time":{"created":"2025-07-16T02:06:45.776Z","modified":"2025-07-16T13:27:31.384Z","1.0.0":"2025-07-16T02:06:46.086Z","1.0.1":"2025-07-16T13:27:31.179Z"},"bugs":{"url":"https://github.com/codexcommunion/liturgical-theme/issues"},"author":{"name":"CodexCommunion"},"license":"MIT","homepage":"https://github.com/codexcommunion/liturgical-theme#readme","keywords":["catholic","liturgical","theming","css","calendar","romcal","colors","seasons","framework-agnostic","lightweight","docusaurus","bootstrap","mantine","tailwind"],"repository":{"type":"git","url":"git+https://github.com/codexcommunion/liturgical-theme.git"},"description":"A lightweight, framework-agnostic liturgical theming package for Catholic websites, combining Catholic CSS variables with liturgical calendar calculations","maintainers":[{"name":"codexcommunion","email":"codexcommunion@gmail.com"}],"readme":"# @codexcommunion/liturgical-theme\n\nA lightweight, framework-agnostic theming package for Catholic websites. It provides CSS variables tied to the liturgical calendar via `romcal` and integrates seamlessly with the `catholic-css` color palette.\n\n---\n\n## Features\n\n- **Framework Agnostic**: Works with any JS environment\n- **Tree-Shakeable**: Import only what you use\n- **Authentic Liturgical Colors**: Powered by [`catholic-css`](https://github.com/codexcommunion/catholic-css)\n- **Liturgical Calendar Integration**: Uses [`romcal`](https://github.com/romcal/romcal)\n- **Multiple Framework Support**: Theme transformers for Docusaurus, Tailwind, Bootstrap, Mantine, and generic CSS-in-JS\n- **Typed & Lightweight**: TypeScript support included; \\~2-6KB depending on usage\n\n---\n\n## Installation\n\n```bash\nnpm install @codexcommunion/liturgical-theme catholic-css romcal\n```\n\n---\n\n## Usage Overview\n\n### Core Function\n\n```ts\ngetLiturgicalColorVariables(date?: Date): string[]\n```\n\nReturns an array of CSS variable names (e.g. `--color-liturgical-green-500`) for the given date.\n\n### Framework Transformers\n\n- `getDocusaurusTheme(date?)`\n- `getTailwindTheme(date?)`\n- `getBootstrapTheme(date?)`\n- `getMantineTheme(date?)`\n- `getGenericCSSTheme(date?)`\n\nEach returns a theme object using CSS variables from `catholic-css` mapped to the liturgical color for that date.\n\n---\n\n## Examples\n\n### Basic\n\n```ts\nimport { getLiturgicalColorVariables } from '@codexcommunion/liturgical-theme';\nconst vars = getLiturgicalColorVariables();\n```\n\n### Docusaurus\n\n```ts\nimport { getDocusaurusTheme } from '@codexcommunion/liturgical-theme';\nconst theme = getDocusaurusTheme();\n```\n\n### Tailwind\n\n```ts\nimport { getTailwindTheme } from '@codexcommunion/liturgical-theme';\nmodule.exports = { theme: { extend: getTailwindTheme() } };\n```\n\n### Mantine\n\n```tsx\n<MantineProvider theme={getMantineTheme()}>\n  {/* Your app */}\n</MantineProvider>\n```\n\n### Plain JavaScript\n\n```js\nconst theme = getGenericCSSTheme();\ndocument.documentElement.style.cssText += Object.entries(theme)\n  .map(([k,v]) => `${k}: ${v};`).join(' ');\n```\n\n---\n\n## API Reference\n\n### getLiturgicalColorVariables(date?)\n\nReturns an array of variable names like `--color-liturgical-green-500`.\n\n### get\\*Theme(date?)\n\nEach transformer maps the color of the day into your framework’s theming format.\n\n---\n\n## CSS Variables by Color\n\nExample (Green):\n\n```css\n--color-liturgical-green-50\n--color-liturgical-green-100\n...\n--color-liturgical-green-950\n```\n\nThese are sourced from the `catholic-css` palette:\n\n```css\n@import 'catholic-css/dist/catholic-palette.css';\n```\n\n---\n\n## Supported Liturgical Colors\n\n- **Green**: Ordinary Time\n- **Purple**: Advent, Lent\n- **White**: Christmas, Easter\n- **Red**: Martyrs, Pentecost\n- **Rose**: Gaudete / Laetare Sundays\n- **Gold**: Major Feasts (optional alternate)\n\n---\n\n## Performance & Bundle Size\n\n- **Core only**: \\~2KB\n- **With transformers**: \\~4-6KB\n- Supports all major bundlers: Webpack, Vite, Rollup, Parcel, esbuild\n\n---\n\n## Related Projects\n\n- [`catholic-css`](https://github.com/codexcommunion/catholic-css): CSS palette\n- [`romcal`](https://github.com/romcal/romcal): Liturgical calendar engine\n\n---\n\n## License\n\nMIT License\n\n---\n\n**Made with ❤️ for the Catholic web development community**\n\n","readmeFilename":"README.md"}