@citestyle/styles 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Proximify
+
+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,113 @@
+# @citestyle/styles
+
+Pre-compiled popular CSL styles, ready to use. Each style is ~3-5KB and imports shared helpers from `@citestyle/core`.
+
+## Installation
+
+```bash
+npm install @citestyle/styles
+```
+
+## Available Styles
+
+| Import path | Style |
+|---|---|
+| `@citestyle/styles/apa` | American Psychological Association 7th edition |
+| `@citestyle/styles/mla` | Modern Language Association 9th edition |
+| `@citestyle/styles/chicago-author-date` | Chicago Manual of Style 17th edition (author-date) |
+| `@citestyle/styles/ieee` | IEEE |
+| `@citestyle/styles/vancouver` | Vancouver |
+| `@citestyle/styles/harvard` | Harvard (Cite Them Right) |
+| `@citestyle/styles/ama` | American Medical Association 11th edition |
+| `@citestyle/styles/turabian` | Turabian 9th edition |
+| `@citestyle/styles/nature` | Nature |
+| `@citestyle/styles/science` | Science |
+
+## Usage
+
+### Direct (without registry)
+
+```js
+import * as apa from '@citestyle/styles/apa'
+
+const item = {
+  id: '1',
+  type: 'article-journal',
+  title: 'A theory of everything',
+  author: [{ family: 'Einstein', given: 'Albert' }],
+  issued: { 'date-parts': [[2024]] },
+  'container-title': 'Physical Review Letters',
+  volume: '130',
+  page: '1-10',
+  DOI: '10.1103/example',
+}
+
+const entry = apa.bibliography(item)
+console.log(entry.text)
+console.log(entry.html)
+```
+
+### With registry (recommended for documents)
+
+```js
+import * as ieee from '@citestyle/styles/ieee'
+import { createRegistry } from '@citestyle/registry'
+
+const registry = createRegistry(ieee)
+registry.addItems([item1, item2, item3])
+
+const citation = registry.cite([{ id: '1' }])
+console.log(citation.text) // [1]
+
+const bibliography = registry.getBibliography()
+bibliography.forEach(e => console.log(e.html))
+```
+
+### Style metadata
+
+Every style exports a `meta` object:
+
+```js
+import * as apa from '@citestyle/styles/apa'
+
+console.log(apa.meta.id)    // "apa"
+console.log(apa.meta.title) // "American Psychological Association 7th edition"
+console.log(apa.meta.class) // "in-text"
+```
+
+## Custom Styles
+
+For styles not included here, compile any CSL file with `@citestyle/compiler`:
+
+```bash
+npm install @citestyle/compiler
+citestyle compile my-style.csl -o my-style.js
+```
+
+Then import the output module the same way:
+
+```js
+import * as myStyle from './my-style.js'
+```
+
+## Output Format
+
+Every `bibliography(item)` call returns:
+
+```js
+{
+  text: '...',   // Plain text
+  html: '...',   // Semantic HTML with CSS classes and linked DOIs
+  parts: {...},  // Decomposed fields for custom layouts
+  links: {...},  // Extracted DOI, URL, PDF links
+}
+```
+
+Every `citation(cites)` call returns:
+
+```js
+{
+  text: '...',   // Plain text (e.g., "(Smith, 2024)")
+  html: '...',   // HTML with <span class="csl-citation">
+}
+```

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@citestyle/styles",
+  "version": "0.0.2",
+  "description": "Pre-compiled popular CSL styles (~3-5KB each)",
+  "type": "module",
+  "exports": {
+    "./apa": "./apa.js",
+    "./mla": "./mla.js",
+    "./chicago-author-date": "./chicago-author-date.js",
+    "./ieee": "./ieee.js",
+    "./vancouver": "./vancouver.js",
+    "./harvard": "./harvard.js",
+    "./ama": "./ama.js",
+    "./turabian": "./turabian.js",
+    "./nature": "./nature.js",
+    "./science": "./science.js"
+  },
+  "typesVersions": {
+    "*": {
+      "*": [
+        "./types.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "*.js",
+    "types.d.ts",
+    "README.md"
+  ],
+  "dependencies": {
+    "@citestyle/core": "0.0.2"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "echo 'TODO: compile styles from CSL sources'"
+  }
+}

package/types.d.ts

@@ -0,0 +1,4 @@
+import type { CompiledStyle } from '@citestyle/types'
+
+declare const style: CompiledStyle
+export = style