loredata 0.1.0 → 0.3.0

package/README.md

@@ -1,20 +1,51 @@
-# loredata
+<p align="center">
+  <img src="https://raw.githubusercontent.com/orchidfiles/loredata/main/apps/web/static/logo.png" alt="LoreData" width="80" />
+</p>
 
-[![npm version](https://img.shields.io/npm/v/loredata)](https://www.npmjs.com/package/loredata)
-[![npm downloads per month](https://img.shields.io/npm/dm/loredata)](https://www.npmjs.com/package/loredata)
-[![node version](https://img.shields.io/node/v/loredata)](https://nodejs.org)
-[![license](https://img.shields.io/npm/l/loredata)](./LICENSE)
-[![last commit](https://img.shields.io/github/last-commit/orchidfiles/loredata)](https://github.com/orchidfiles/loredata)
+<h3 align="center">LoreData</h3>
 
-Generate fake personas using real characters from pop culture universes. Every field — name, email, address, profession, quote — comes from the same fictional world.
+<p align="center">
+  Generate fake personas using real characters from pop culture universes.<br/>
+  Every field — name, email, address, profession, quote — comes from the same fictional world.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/loredata"><img src="https://img.shields.io/npm/v/loredata" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/loredata"><img src="https://img.shields.io/npm/dm/loredata" alt="npm downloads per month" /></a>
+  <a href="https://nodejs.org"><img src="https://img.shields.io/node/v/loredata" alt="node version" /></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/npm/l/loredata" alt="license" /></a>
+  <a href="https://github.com/orchidfiles/loredata"><img src="https://img.shields.io/github/last-commit/orchidfiles/loredata" alt="last commit" /></a>
+</p>
+
+<img src="https://raw.githubusercontent.com/orchidfiles/loredata/main/apps/web/static/screen.png" alt="LoreData screenshot" />
+
+**Demo:** [loredata.orchidfiles.com](https://loredata.orchidfiles.com)
 
 ```ts
 import { person, group } from 'loredata';
 
 const p = person({ universe: 'breaking-bad' });
-// { firstName: 'Walter', lastName: 'White', email: 'heisenberg@lospollos.com', ... }
+// {
+//   firstName: 'Walter',
+//   lastName: 'White',
+//   username: 'heisenberg',
+//   email: 'blue_sky_cook@lospollos.com',
+//   quote: "I am the one who knocks.",
+//   profession: 'Chemistry teacher',
+//   interests: ['chemistry', 'cooking', 'family'],
+//   address: { street: '308 Negra Arroyo Lane', city: 'Albuquerque', state: 'NM' },
+//   symbol: '☢️',
+//   color: '#4c1d95',
+//   universe: 'breaking-bad',
+//   universeName: 'Breaking Bad'
+// }
 
 const team = group({ universe: 'game-of-thrones', size: 3 });
+// [
+//   { firstName: 'Jon', lastName: 'Snow', username: 'lord_commander', ... },
+//   { firstName: 'Daenerys', lastName: 'Targaryen', username: 'mother_of_dragons', ... },
+//   { firstName: 'Tyrion', lastName: 'Lannister', username: 'halfman', ... },
+// ]
 ```
 
 Works in Node.js, browser, and as a CLI tool.
@@ -22,27 +53,39 @@ Works in Node.js, browser, and as a CLI tool.
 ## Install
 
 ```sh
+# library
 npm install loredata
+
+# CLI
+npm install -g loredata
 ```
 
 ## Universes
 
-Available out of the box: `breaking-bad`, `friends`, `game-of-thrones`, `harry-potter`, `house-md`, `lost`, `fast-and-furious`, `matrix`, `peaky-blinders`, `sherlock`, `the-office`
+25 universes available out of the box:
+
+`breaking-bad`, `sopranos`, `better-call-saul`, `the-office`, `house-md`, `sherlock`, `peaky-blinders`, `game-of-thrones`, `friends`, `south-park`, `star-wars`, `matrix`, `the-walking-dead`, `prison-break`, `westworld`, `supernatural`, `simpsons`, `avengers`, `spider-man`, `lost`, `harry-potter`, `guardians-of-the-galaxy`, `big-bang-theory`, `x-men`, `fast-and-furious`
 
 ```ts
 import { universes } from 'loredata';
 
 universes();
 // [
-//   { id: 'sherlock', name: 'Sherlock', characterCount: 9 },
-//   { id: 'game-of-thrones', name: 'Game of Thrones', characterCount: 15 },
+//   { id: 'sherlock', name: 'Sherlock', genre: ['crime', 'drama', 'mystery'], description: '...' },
+//   { id: 'game-of-thrones', name: 'Game of Thrones', genre: ['fantasy', 'drama', 'action'], description: '...' },
 //   ...
 // ]
 ```
 
 ## Persona fields
 
-Each `Person` includes: `firstName`, `lastName`, `username`, `email`, `password`, `phone`, `address`, `profession`, `interests`, `quote`, `avatar`, `universe`.
+Each `Person` includes:
+
+- `firstName`, `lastName`
+- `username`, `email`
+- `address`, `profession`, `interests`
+- `quote`, `symbol`, `color`
+- `universe`, `universeName`
 
 ## Deterministic output
 
@@ -55,7 +98,10 @@ const p = person({ universe: 'matrix', seed: 42 });
 ## Browser
 
 ```ts
-import { UniverseStore } from 'loredata/browser';
+import { loadUniverse, personFromData } from 'loredata/browser';
+
+const universe = await loadUniverse('breaking-bad');
+const p = personFromData(universe);
 ```
 
 No `fs` or `path` — safe for Vite, webpack, and any browser bundler.
@@ -63,19 +109,24 @@ No `fs` or `path` — safe for Vite, webpack, and any browser bundler.
 ## CLI
 
 ```sh
-npx loredata person --universe breaking-bad
-npx loredata group --universe friends --size 5
-npx loredata universes
+loredata person --universe breaking-bad
+loredata person --universe breaking-bad --format json
+loredata person --interests chemistry,cooking
+loredata person --interests chemistry,cooking --interests-mode and
+loredata person --name walter
+loredata group --universe friends --size 5
+loredata universes
 ```
 
 ## Features
 
-- [x] 11 universes with characters, addresses, domains
+- [x] 25 universes
 - [x] Single persona and group generation
 - [x] Filter characters by interest, name, universe
 - [x] Deterministic output via seed
 - [x] Browser-safe entry point
 - [x] CLI tool
+- [x] Character symbol and color fields
 
 ## Development
 
@@ -94,20 +145,20 @@ pnpm --filter @loredata/dev-kit build
 Build the library:
 
 ```sh
-pnpm run package:build
+pnpm --filter loredata build
 ```
 
-Run the demo app:
+Run the web app:
 
 ```sh
-pnpm run demo:dev
+pnpm --filter @loredata/web dev
 ```
 
 ## Why
 
 Faker.js generates random names and emails. They are internally consistent but meaningless. No shared context, no character identity.
 
-`loredata` generates personas from real fictional characters. Each persona is recognizable and internally consistent, which makes it useful for demos, screenshots, and seed files where the content matters.
+`LoreData` generates personas from real fictional characters. Each persona is recognizable and internally consistent, which makes it useful for demos, screenshots, and seed files where the content matters.
 
 ## License
 

package/data/avengers/addresses.json

@@ -0,0 +1,27 @@
+[
+  {
+    "street": "200 Park Avenue",
+    "city": "New York",
+    "state": "NY",
+    "zip": "10166",
+    "country": "US"
+  },
+  {
+    "city": "Upstate New York",
+    "state": "NY",
+    "country": "US"
+  },
+  {
+    "street": "1327 F Street NW",
+    "city": "Washington",
+    "state": "DC",
+    "zip": "20004",
+    "country": "US"
+  },
+  {
+    "city": "Wakanda"
+  },
+  {
+    "city": "Asgard"
+  }
+]

package/data/avengers/characters.json

@@ -0,0 +1,178 @@
+[
+  {
+    "id": "tony-stark",
+    "firstName": "Tony",
+    "lastName": "Stark",
+    "usernames": ["iron_man", "genius_billionaire", "arc_reactor"],
+    "profession": "Inventor",
+    "interests": ["engineering", "robotics", "racing", "family"],
+    "quotes": [
+      "I am Iron Man.",
+      "And I... am... Iron Man.",
+      "I love you three thousand.",
+      "Genius, billionaire, playboy, philanthropist.",
+      "Part of the journey is the end."
+    ],
+    "gender": "male",
+    "birthYear": 1970,
+    "address": {
+      "street": "200 Park Avenue",
+      "city": "New York",
+      "state": "NY",
+      "country": "US"
+    },
+    "symbol": "⚙️",
+    "color": "#7f1d1d",
+    "emailDomains": ["stark-industries.com", "ironmail.net"]
+  },
+  {
+    "id": "steve-rogers",
+    "firstName": "Steve",
+    "lastName": "Rogers",
+    "usernames": ["i_can_do_this_all_day", "first_avenger", "man_out_of_time"],
+    "profession": "Soldier",
+    "interests": ["art", "history", "fitness", "leadership"],
+    "quotes": [
+      "I can do this all day.",
+      "Avengers, assemble.",
+      "I'm with you till the end of the line.",
+      "I don't want to kill anyone. I don't like bullies; I don't care where they're from.",
+      "The price of freedom is high. It always has been.",
+      "Whatever it takes."
+    ],
+    "gender": "male",
+    "birthYear": 1918,
+    "symbol": "🛡️",
+    "color": "#1e3a5f",
+    "emailDomains": ["shield.gov", "avengers-hq.net"]
+  },
+  {
+    "id": "thor",
+    "firstName": "Thor",
+    "lastName": "Odinson",
+    "usernames": ["god_of_thunder", "son_of_odin", "point_break"],
+    "profession": "King of Asgard",
+    "interests": ["combat", "lightning", "beer", "adventure"],
+    "quotes": [
+      "Bring me Thanos!",
+      "I'm still worthy!",
+      "Another!",
+      "I went for the head.",
+      "He's a friend from work!"
+    ],
+    "gender": "male",
+    "symbol": "⚡",
+    "color": "#166534",
+    "emailDomains": ["asgard-mail.net", "avengers-hq.net"]
+  },
+  {
+    "id": "bruce-banner",
+    "firstName": "Bruce",
+    "lastName": "Banner",
+    "usernames": ["always_angry", "other_guy", "big_green_guy"],
+    "profession": "Physicist",
+    "interests": ["physics", "meditation", "gamma radiation", "biology"],
+    "quotes": [
+      "That's my secret, Captain. I'm always angry.",
+      "I put a bullet in my mouth and the other guy spit it out.",
+      "I don't know how to fly one of these."
+    ],
+    "gender": "male",
+    "symbol": "🟢",
+    "color": "#4c1d95",
+    "emailDomains": ["shield.gov", "gamma-labs.net"]
+  },
+  {
+    "id": "natasha-romanoff",
+    "firstName": "Natasha",
+    "lastName": "Romanoff",
+    "usernames": ["budapest", "red_ledger", "natalia_romanova"],
+    "profession": "Spy",
+    "interests": ["espionage", "martial arts", "languages", "strategy"],
+    "quotes": [
+      "I've got red in my ledger. I'd like to wipe it out.",
+      "We don't wanna kill you. But we will.",
+      "Whatever it takes."
+    ],
+    "gender": "female",
+    "symbol": "🕷️",
+    "color": "#7f1d1d",
+    "emailDomains": ["shield.gov", "red-room.net"]
+  },
+  {
+    "id": "clint-barton",
+    "firstName": "Clint",
+    "lastName": "Barton",
+    "usernames": ["bow_and_arrow", "ronin_blade", "end_of_the_line"],
+    "profession": "Archer",
+    "interests": ["archery", "farming", "family", "woodworking"],
+    "quotes": [
+      "The city is flying, we're fighting an army of robots, and I have a bow and arrow. None of this makes sense.",
+      "You step out that door, you're an Avenger.",
+      "I retire for, what, like five minutes, and it all goes to shit.",
+      "Nobody would know. Nobody. Last I saw him, an Ultron was sitting on him.",
+      "Don't give me hope."
+    ],
+    "gender": "male",
+    "symbol": "🏹",
+    "color": "#4a1942",
+    "emailDomains": ["shield.gov", "avengers-hq.net"]
+  },
+  {
+    "id": "loki",
+    "firstName": "Loki",
+    "lastName": "Laufeyson",
+    "usernames": ["god_of_mischief", "burdened_with_purpose", "puny_god"],
+    "profession": "Trickster",
+    "interests": ["magic", "theater", "deception", "conquest"],
+    "quotes": [
+      "I am Loki, of Asgard, and I am burdened with glorious purpose.",
+      "If it's all the same to you, I'll have that drink now.",
+      "Is not this simpler? Is this not your natural state?",
+      "You... will never be... a god.",
+      "I assure you, brother, the sun will shine on us again."
+    ],
+    "gender": "male",
+    "symbol": "🐍",
+    "color": "#1e3a5f",
+    "emailDomains": ["asgard-mail.net", "tva-nexus.org"]
+  },
+  {
+    "id": "nick-fury",
+    "firstName": "Nick",
+    "lastName": "Fury",
+    "usernames": ["trust_no_one", "helicarrier", "avengers_initiative"],
+    "profession": "Spy director",
+    "interests": ["intelligence", "strategy", "surveillance", "cats"],
+    "quotes": [
+      "I still believe in heroes.",
+      "I recognize the council has made a decision, but given that it's a stupid-ass decision, I've elected to ignore it.",
+      "There was an idea to bring together a group of remarkable people.",
+      "Last time I trusted someone, I lost an eye."
+    ],
+    "gender": "male",
+    "symbol": "🛰️",
+    "color": "#134e4a",
+    "emailDomains": ["shield.gov", "espionage-net.org"]
+  },
+  {
+    "id": "thanos",
+    "firstName": "Thanos",
+    "lastName": "",
+    "usernames": ["mad_titan", "inevitable_one", "balanced_universe"],
+    "profession": "Warlord",
+    "interests": ["philosophy", "conquest", "balance", "farming"],
+    "quotes": [
+      "I am inevitable.",
+      "Reality is often disappointing.",
+      "The hardest choices require the strongest wills.",
+      "You should have gone for the head.",
+      "Dread it. Run from it. Destiny arrives all the same.",
+      "A small price to pay for salvation."
+    ],
+    "gender": "male",
+    "symbol": "🟣",
+    "color": "#854d0e",
+    "emailDomains": ["titan-post.net", "infinity-order.org"]
+  }
+]

package/data/avengers/meta.json

@@ -0,0 +1,13 @@
+{
+  "id": "avengers",
+  "name": "The Avengers",
+  "genre": ["action", "sci-fi", "adventure"],
+  "description": "Earth's mightiest heroes assemble to fight global threats no single hero can face alone.",
+  "tmdbId": 24428,
+  "mediaType": "movie",
+  "year": 2012,
+  "rating": 8,
+  "networks": ["Marvel Studios"],
+  "posterPath": "/RYMX2wcKCBAr24UyPD7xwmjaTn.jpg",
+  "backdropPath": "/9BBTo63ANSmhC4e6r62OJFuK2GL.jpg"
+}

package/data/better-call-saul/addresses.json

@@ -0,0 +1,37 @@
+[
+  {
+    "street": "9800 Montgomery Blvd NE",
+    "city": "Albuquerque",
+    "state": "NM",
+    "zip": "87111",
+    "country": "US"
+  },
+  {
+    "street": "4257 Isleta Blvd SW",
+    "city": "Albuquerque",
+    "state": "NM",
+    "zip": "87105",
+    "country": "US"
+  },
+  {
+    "street": "160 Juan Tabo Blvd NE",
+    "city": "Albuquerque",
+    "state": "NM",
+    "zip": "87123",
+    "country": "US"
+  },
+  {
+    "street": "6501 Montgomery Blvd NE",
+    "city": "Albuquerque",
+    "state": "NM",
+    "zip": "87109",
+    "country": "US"
+  },
+  {
+    "street": "2727 Rio Grande Blvd NW",
+    "city": "Albuquerque",
+    "state": "NM",
+    "zip": "87104",
+    "country": "US"
+  }
+]

package/data/better-call-saul/characters.json

@@ -0,0 +1,156 @@
+[
+  {
+    "id": "jimmy-mcgill",
+    "firstName": "Jimmy",
+    "lastName": "McGill",
+    "usernames": ["slippin_jimmy", "saul_goodman_esq", "better_call_saul", "viktor_with_a_k"],
+    "profession": "Lawyer",
+    "interests": ["law", "scams", "advertising", "elder law", "money"],
+    "quotes": [
+      "I'm the last line of defense for the little guy.",
+      "I just talked you down from a death sentence to six months' probation. I'm the best lawyer ever.",
+      "You don't need a criminal lawyer. You need a criminal lawyer.",
+      "It's all good, man.",
+      "I travel in worlds you can't even imagine.",
+      "The name's McGill. I'm James McGill."
+    ],
+    "gender": "male",
+    "birthYear": 1960,
+    "symbol": "⚖️",
+    "color": "#1e3a5f",
+    "emailDomains": ["saul-goodman.net", "hm-law.com", "abq-bar.org"]
+  },
+  {
+    "id": "mike-ehrmantraut",
+    "firstName": "Mike",
+    "lastName": "Ehrmantraut",
+    "usernames": ["the_fixer", "no_half_measures", "philly_on_the_job", "pimento_guy"],
+    "profession": "Fixer",
+    "interests": ["security", "family", "chess", "surveillance"],
+    "quotes": [
+      "I've known good criminals and bad cops. Bad priests. Honorable thieves. You can be on one side of the law or the other. But if you make a deal with somebody, you keep your word.",
+      "I have spent my whole life trying to work my way back from a mistake I made. And I made it worse.",
+      "We all make our choices. And those choices, they put us on a road.",
+      "Because I know why I'm out here. That's how. I know what it's for.",
+      "Your dad's gonna be okay. Because anyone who goes after him is gonna have to come through me."
+    ],
+    "gender": "male",
+    "symbol": "🧹",
+    "color": "#1d4ed8",
+    "emailDomains": ["abq-mail.net", "ehrmantraut-security.com"]
+  },
+  {
+    "id": "kim-wexler",
+    "firstName": "Kim",
+    "lastName": "Wexler",
+    "usernames": ["giselle_saint_claire", "mesa_verde_kim", "wexler_law"],
+    "profession": "Lawyer",
+    "interests": ["law", "pro bono work", "banking law", "Mesa Verde"],
+    "quotes": [
+      "You don't save me. I save me.",
+      "Either we end this now, or... maybe we get married?",
+      "I don't trust you.",
+      "We are bad for everyone around us. Apart we're okay, but together we're poison.",
+      "I'm glad you're alive."
+    ],
+    "gender": "female",
+    "symbol": "🌊",
+    "color": "#0f4c75",
+    "emailDomains": ["hm-law.com", "abq-bar.org"]
+  },
+  {
+    "id": "gus-fring",
+    "firstName": "Gustavo",
+    "lastName": "Fring",
+    "usernames": ["los_pollos_boss", "chicken_man_abq", "plain_sight_gus"],
+    "profession": "Fast food entrepreneur",
+    "interests": ["business", "philanthropy", "revenge", "chemistry"],
+    "quotes": [
+      "A bullet to the head would have been far too humane.",
+      "I am what I am.",
+      "I understand blood for blood. Hector? Yeah, I kept him alive. Kept him broken.",
+      "This is America. Here, the righteous have no reason to fear.",
+      "I never asked for this. I do not want it."
+    ],
+    "gender": "male",
+    "symbol": "🍗",
+    "color": "#7f1d1d",
+    "emailDomains": ["los-pollos.com", "pollos-hermanos.net"]
+  },
+  {
+    "id": "nacho-varga",
+    "firstName": "Ignacio",
+    "lastName": "Varga",
+    "usernames": ["nacho_varga", "sugar_pill_switch", "not_on_the_cartel_books"],
+    "profession": "Cartel enforcer",
+    "interests": ["family", "cars", "upholstery", "getting out"],
+    "quotes": [
+      "I put you in that chair. Your heart meds? I switched them for sugar pills.",
+      "I opened Lalo's gate, and I would do it again.",
+      "I would have done it for free. Because I hate every last one of you psycho sacks of shit.",
+      "You are screwed. You want the cartel to blame me for Lalo. But if they catch me, and make me talk? That is not good for you.",
+      "My father is a simple man. He is not in the business."
+    ],
+    "gender": "male",
+    "symbol": "🔑",
+    "color": "#166534",
+    "emailDomains": ["abq-mail.net"]
+  },
+  {
+    "id": "lalo-salamanca",
+    "firstName": "Eduardo",
+    "lastName": "Salamanca",
+    "usernames": ["lalo_salamanca", "jorge_de_guzman", "cousin_lalo"],
+    "profession": "Cartel boss",
+    "interests": ["cars", "cooking", "family honor", "revenge"],
+    "quotes": [
+      "You're the guy with a mouth.",
+      "You're nobody! I mean, no offense, but nobody's gonna look twice at you!",
+      "When it's like this... that's when I can think. I get my best ideas when everybody else is asleep.",
+      "Gustavo thought he was building an empire, but all he built himself was a tomb.",
+      "Let them keep believing I'm dead. So much the better."
+    ],
+    "gender": "male",
+    "symbol": "🦂",
+    "color": "#6b2737",
+    "emailDomains": ["cartel-mx.net", "salamanca-family.com"]
+  },
+  {
+    "id": "howard-hamlin",
+    "firstName": "Howard",
+    "lastName": "Hamlin",
+    "usernames": ["hamlin_hhm", "hamlindigo_blue", "howard_at_hhm"],
+    "profession": "Lawyer",
+    "interests": ["law", "tennis", "golf", "firm reputation"],
+    "quotes": [
+      "You've mistaken my kindness for weakness.",
+      "I think you're an asshole.",
+      "You want to know what's weird? It's weird to offer a job to a man, and in return have bowling balls thrown at your car.",
+      "There's proving, and then there's knowing.",
+      "You can't hide who you really are forever."
+    ],
+    "gender": "male",
+    "symbol": "🏛️",
+    "color": "#2d4a7a",
+    "emailDomains": ["hm-law.com"]
+  },
+  {
+    "id": "chuck-mcgill",
+    "firstName": "Charles",
+    "lastName": "McGill",
+    "usernames": ["chuck_mcgill_esq", "the_founding_mcgill", "electromagnetic_chuck"],
+    "profession": "Lawyer",
+    "interests": ["law", "classical music", "reading", "the rule of law"],
+    "quotes": [
+      "Slippin' Jimmy with a law degree is like a chimp with a machine gun!",
+      "The law is sacred! If you abuse that power, people get hurt!",
+      "I know you. I know what you were, what you are. People don't change.",
+      "Let justice be done, though the heavens fall.",
+      "My brother is not a bad person. He has a good heart. It's just he can't help himself."
+    ],
+    "gender": "male",
+    "symbol": "🕯️",
+    "color": "#3d2b1f",
+    "emailDomains": ["hm-law.com", "abq-bar.org"]
+  }
+]

package/data/better-call-saul/meta.json

@@ -0,0 +1,13 @@
+{
+  "id": "better-call-saul",
+  "name": "Better Call Saul",
+  "genre": ["crime", "drama", "thriller"],
+  "description": "A small-time lawyer in Albuquerque transforms into the morally compromised criminal attorney Saul Goodman, drawn step by step into the world of drug cartels and organized crime.",
+  "tmdbId": 60059,
+  "mediaType": "tv",
+  "year": 2015,
+  "rating": 8.7,
+  "networks": ["AMC"],
+  "posterPath": "/zjg4jpK1Wp2kiRvtt5ND0kznako.jpg",
+  "backdropPath": "/t15KHp3iNfHVQBNIaqUGW12xQA4.jpg"
+}

package/data/big-bang-theory/addresses.json

@@ -0,0 +1,31 @@
+[
+  {
+    "street": "2311 North Los Robles Avenue",
+    "city": "Pasadena",
+    "state": "CA",
+    "country": "US"
+  },
+  {
+    "street": "1200 East California Boulevard",
+    "city": "Pasadena",
+    "state": "CA",
+    "country": "US"
+  },
+  {
+    "street": "364 South Lake Avenue",
+    "city": "Pasadena",
+    "state": "CA",
+    "country": "US"
+  },
+  {
+    "street": "215 South Lake Avenue",
+    "city": "Pasadena",
+    "state": "CA",
+    "country": "US"
+  },
+  {
+    "city": "Medford",
+    "state": "TX",
+    "country": "US"
+  }
+]