loredata 0.1.0 → 0.2.0

package/README.md

@@ -8,11 +8,26 @@
 
 Generate fake personas using real characters from pop culture universes. Every field — name, email, address, profession, quote — comes from the same fictional world.
 
+**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 });
 ```
@@ -34,15 +49,21 @@ 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`, `password`, `phone`
+- `address`, `profession`, `interests`
+- `quote`, `symbol`, `color`
+- `universe`, `universeName`
 
 ## Deterministic output
 
@@ -55,7 +76,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.
@@ -64,6 +88,9 @@ No `fs` or `path` — safe for Vite, webpack, and any browser bundler.
 
 ```sh
 npx loredata person --universe breaking-bad
+npx loredata person --universe breaking-bad --format json
+npx loredata person --interests chemistry,cooking
+npx loredata person --name walter
 npx loredata group --universe friends --size 5
 npx loredata universes
 ```
@@ -76,6 +103,7 @@ npx loredata universes
 - [x] Deterministic output via seed
 - [x] Browser-safe entry point
 - [x] CLI tool
+- [x] Character symbol and color fields
 
 ## Development
 

package/data/breaking-bad/characters.json

@@ -15,7 +15,14 @@
     ],
     "gender": "male",
     "birthYear": 1959,
-    "address": { "street": "308 Negra Arroyo Lane", "city": "Albuquerque", "state": "NM", "country": "US" }
+    "address": {
+      "street": "308 Negra Arroyo Lane",
+      "city": "Albuquerque",
+      "state": "NM",
+      "country": "US"
+    },
+    "symbol": "☢️",
+    "color": "#4c1d95"
   },
   {
     "id": "jesse-pinkman",
@@ -32,7 +39,9 @@
       "Maybe. But some people are just... broken."
     ],
     "gender": "male",
-    "birthYear": 1984
+    "birthYear": 1984,
+    "symbol": "🎨",
+    "color": "#0c4a6e"
   },
   {
     "id": "saul-goodman",
@@ -49,7 +58,14 @@
       "I fight for you, Albuquerque!"
     ],
     "gender": "male",
-    "address": { "street": "160 Juan Tabo Blvd NE", "city": "Albuquerque", "state": "NM", "country": "US" }
+    "address": {
+      "street": "160 Juan Tabo Blvd NE",
+      "city": "Albuquerque",
+      "state": "NM",
+      "country": "US"
+    },
+    "symbol": "⚖️",
+    "color": "#4a1942"
   },
   {
     "id": "skyler-white",
@@ -65,7 +81,9 @@
       "I don't know what to do.",
       "You've lied to me, manipulated me."
     ],
-    "gender": "female"
+    "gender": "female",
+    "symbol": "💼",
+    "color": "#134e4a"
   },
   {
     "id": "hank-schrader",
@@ -81,7 +99,9 @@
       "This is my chance to catch the big one.",
       "Minerals, not rocks."
     ],
-    "gender": "male"
+    "gender": "male",
+    "symbol": "🔍",
+    "color": "#3b1f0a"
   },
   {
     "id": "gustavo-fring",
@@ -99,7 +119,14 @@
     ],
     "gender": "male",
     "birthYear": 1958,
-    "address": { "street": "4257 Isleta Blvd SW", "city": "Albuquerque", "state": "NM", "country": "US" }
+    "address": {
+      "street": "4257 Isleta Blvd SW",
+      "city": "Albuquerque",
+      "state": "NM",
+      "country": "US"
+    },
+    "symbol": "🍗",
+    "color": "#1e3a5f"
   },
   {
     "id": "mike-ehrmantraut",
@@ -115,6 +142,8 @@
       "Everyone sounds like Meryl Streep with a gun to their head.",
       "You talk too much."
     ],
-    "gender": "male"
+    "gender": "male",
+    "symbol": "🧹",
+    "color": "#9333ea"
   }
 ]

package/data/breaking-bad/meta.json

@@ -1,4 +1,6 @@
 {
   "id": "breaking-bad",
-  "name": "Breaking Bad"
+  "name": "Breaking Bad",
+  "genre": ["crime", "drama", "thriller"],
+  "description": "A high school chemistry teacher turned methamphetamine manufacturer navigates the criminal underworld of Albuquerque, New Mexico."
 }

package/data/fast-and-furious/characters.json

@@ -14,7 +14,14 @@
       "Nobody makes me do anything I don't want to."
     ],
     "gender": "male",
-    "address": {"street": "1327 East Adams Boulevard", "city": "Los Angeles", "state": "CA", "country": "US"}
+    "address": {
+      "street": "1327 East Adams Boulevard",
+      "city": "Los Angeles",
+      "state": "CA",
+      "country": "US"
+    },
+    "symbol": "🏁",
+    "color": "#2563eb"
   },
   {
     "id": "brian-oconner",
@@ -30,7 +37,9 @@
       "You almost had me? You never had me.",
       "See you around, Dom."
     ],
-    "gender": "male"
+    "gender": "male",
+    "symbol": "🚓",
+    "color": "#7c3aed"
   },
   {
     "id": "letty-ortiz",
@@ -46,7 +55,9 @@
       "You want me? You're gonna have to catch me first.",
       "This is who I am."
     ],
-    "gender": "female"
+    "gender": "female",
+    "symbol": "🔧",
+    "color": "#083344"
   },
   {
     "id": "roman-pearce",
@@ -62,7 +73,9 @@
       "You know what I say? I say we take the money, we take the car, and we go.",
       "This is crazy. This is absolutely crazy."
     ],
-    "gender": "male"
+    "gender": "male",
+    "symbol": "💸",
+    "color": "#083344"
   },
   {
     "id": "tej-parker",
@@ -78,7 +91,9 @@
       "I just need to reroute the transponder through the auxiliary grid.",
       "Money ain't a thing."
     ],
-    "gender": "male"
+    "gender": "male",
+    "symbol": "💻",
+    "color": "#083344"
   },
   {
     "id": "han-lue",
@@ -94,7 +109,9 @@
       "Chaos, yeah. You know what that is? It's everything. It's your life.",
       "I have to try things for myself. That's just who I am."
     ],
-    "gender": "male"
+    "gender": "male",
+    "symbol": "🍿",
+    "color": "#083344"
   },
   {
     "id": "hobbs",
@@ -110,6 +127,8 @@
       "You just earned yourself a dance with the devil, boy.",
       "I will beat you like a Cherokee drum."
     ],
-    "gender": "male"
+    "gender": "male",
+    "symbol": "💪",
+    "color": "#7f1d1d"
   }
 ]

package/data/fast-and-furious/meta.json

@@ -1,4 +1,6 @@
 {
   "id": "fast-and-furious",
-  "name": "Fast & Furious"
+  "name": "Fast & Furious",
+  "genre": ["action", "thriller"],
+  "description": "A crew of street racers and ex-convicts take on increasingly dangerous heists and missions around the world."
 }

package/data/friends/characters.json

@@ -3,7 +3,13 @@
     "id": "ross-geller",
     "firstName": "Ross",
     "lastName": "Geller",
-    "usernames": ["we_were_on_a_break", "divorcemaster_phd", "cookie_duuude", "pivot_guy", "homo_sapiens_are_people"],
+    "usernames": [
+      "we_were_on_a_break",
+      "divorcemaster_phd",
+      "cookie_duuude",
+      "pivot_guy",
+      "homo_sapiens_are_people"
+    ],
     "profession": "Paleontologist",
     "interests": ["dinosaurs", "paleontology", "archaeology", "coffee", "academia", "sci-fi"],
     "quotes": [
@@ -15,13 +21,21 @@
       "I'm going to be happy this year. I'm going to make myself happy."
     ],
     "gender": "male",
-    "address": {"city": "New York", "state": "NY", "country": "US"}
+    "address": { "city": "New York", "state": "NY", "country": "US" },
+    "symbol": "🦕",
+    "color": "#3b1f0a"
   },
   {
     "id": "rachel-green",
     "firstName": "Rachel",
     "lastName": "Green",
-    "usernames": ["got_off_the_plane", "who_is_fica", "steamed_milk_life", "not_a_library_card", "green_with_style"],
+    "usernames": [
+      "got_off_the_plane",
+      "who_is_fica",
+      "steamed_milk_life",
+      "not_a_library_card",
+      "green_with_style"
+    ],
     "profession": "Fashion Executive",
     "interests": ["fashion", "shopping", "coffee", "relationships", "style", "fitness"],
     "quotes": [
@@ -32,13 +46,26 @@
       "It's not that common, it doesn't happen to every guy, and it is a big deal!"
     ],
     "gender": "female",
-    "address": {"street": "90 Bedford Street", "city": "New York", "state": "NY", "country": "US"}
+    "address": {
+      "street": "90 Bedford Street",
+      "city": "New York",
+      "state": "NY",
+      "country": "US"
+    },
+    "symbol": "👗",
+    "color": "#7f1d1d"
   },
   {
     "id": "chandler-bing",
     "firstName": "Chandler",
     "lastName": "Bing",
-    "usernames": ["jokes_when_uncomfortable", "the_nubbin", "could_i_be_more_sarcastic", "transponster", "bing_no_first_name"],
+    "usernames": [
+      "jokes_when_uncomfortable",
+      "the_nubbin",
+      "could_i_be_more_sarcastic",
+      "transponster",
+      "bing_no_first_name"
+    ],
     "profession": "Statistical Analysis and Data Reconfiguration",
     "interests": ["TV", "sarcasm", "foosball", "comedy", "movies", "video games"],
     "quotes": [
@@ -50,13 +77,21 @@
       "I thought this was going to be the most difficult thing I ever had to do. But when I saw you walking down that aisle, I realized how simple it was. I love you."
     ],
     "gender": "male",
-    "address": {"city": "New York", "state": "NY", "country": "US"}
+    "address": { "city": "New York", "state": "NY", "country": "US" },
+    "symbol": "😬",
+    "color": "#4a1942"
   },
   {
     "id": "monica-geller",
     "firstName": "Monica",
     "lastName": "Geller",
-    "usernames": ["big_fat_goalie", "chef_mode_on", "eleven_towel_categories", "competitive_cook", "seven_erogenous_zones"],
+    "usernames": [
+      "big_fat_goalie",
+      "chef_mode_on",
+      "eleven_towel_categories",
+      "competitive_cook",
+      "seven_erogenous_zones"
+    ],
     "profession": "Chef",
     "interests": ["cooking", "cleaning", "competition", "catering", "organizing", "sports"],
     "quotes": [
@@ -67,15 +102,36 @@
       "I want a marriage."
     ],
     "gender": "female",
-    "address": {"street": "90 Bedford Street", "city": "New York", "state": "NY", "country": "US"}
+    "address": {
+      "street": "90 Bedford Street",
+      "city": "New York",
+      "state": "NY",
+      "country": "US"
+    },
+    "symbol": "👨‍🍳",
+    "color": "#312e81"
   },
   {
     "id": "joey-tribbiani",
     "firstName": "Joey",
     "lastName": "Tribbiani",
-    "usernames": ["how_you_doin", "joey_no_share_food", "drake_ramoray_md", "baby_kangaroo", "sandwich_first"],
+    "usernames": [
+      "how_you_doin",
+      "joey_no_share_food",
+      "drake_ramoray_md",
+      "baby_kangaroo",
+      "sandwich_first"
+    ],
     "profession": "Actor",
-    "interests": ["food", "acting", "women", "sandwiches", "Days of Our Lives", "foosball", "sports"],
+    "interests": [
+      "food",
+      "acting",
+      "women",
+      "sandwiches",
+      "Days of Our Lives",
+      "foosball",
+      "sports"
+    ],
     "quotes": [
       "JOEY DOESN'T SHARE FOOD.",
       "No, I had sex in high school.",
@@ -85,15 +141,31 @@
       "I want girls on bread!"
     ],
     "gender": "male",
-    "address": {"city": "New York", "state": "NY", "country": "US"}
+    "address": { "city": "New York", "state": "NY", "country": "US" },
+    "symbol": "🍕",
+    "color": "#059669"
   },
   {
     "id": "phoebe-buffay",
     "firstName": "Phoebe",
     "lastName": "Buffay",
-    "usernames": ["smelly_cat_official", "princess_consuela", "buried_alive_tombstone", "not_so_much_evolution", "stabbed_a_cop"],
+    "usernames": [
+      "smelly_cat_official",
+      "princess_consuela",
+      "buried_alive_tombstone",
+      "not_so_much_evolution",
+      "stabbed_a_cop"
+    ],
     "profession": "Masseuse / Singer-Songwriter",
-    "interests": ["music", "massage", "spirituality", "the paranormal", "vegetarianism", "cats", "knitting"],
+    "interests": [
+      "music",
+      "massage",
+      "spirituality",
+      "the paranormal",
+      "vegetarianism",
+      "cats",
+      "knitting"
+    ],
     "quotes": [
       "Hello, teeny embryos. I'm Phoebe Buffay. I'm hoping to be your uterus for the next nine months.",
       "I don't believe in evolution.",
@@ -103,13 +175,21 @@
       "For 99 cents, I'd eat you."
     ],
     "gender": "female",
-    "address": {"city": "New York", "state": "NY", "country": "US"}
+    "address": { "city": "New York", "state": "NY", "country": "US" },
+    "symbol": "🎸",
+    "color": "#083344"
   },
   {
     "id": "gunther",
     "firstName": "Gunther",
     "lastName": "",
-    "usernames": ["always_staring_at_rachel", "central_perk_forever", "ill_take_it_all", "blonde_barista", "unrequited_gunther"],
+    "usernames": [
+      "always_staring_at_rachel",
+      "central_perk_forever",
+      "ill_take_it_all",
+      "blonde_barista",
+      "unrequited_gunther"
+    ],
     "profession": "Barista / Coffee Shop Manager",
     "interests": ["Rachel Green", "coffee", "Central Perk", "Swedish culture"],
     "quotes": [
@@ -120,13 +200,21 @@
       "You don't have to fill these silences."
     ],
     "gender": "male",
-    "address": {"city": "New York", "state": "NY", "country": "US"}
+    "address": { "city": "New York", "state": "NY", "country": "US" },
+    "symbol": "☕",
+    "color": "#0c4a6e"
   },
   {
     "id": "janice-litman-goralnik",
     "firstName": "Janice",
     "lastName": "Litman-Goralnik",
-    "usernames": ["oh_my_god_janice", "the_chandler_magnet", "janice_is_back", "never_fully_gone", "nasal_queen_nyc"],
+    "usernames": [
+      "oh_my_god_janice",
+      "the_chandler_magnet",
+      "janice_is_back",
+      "never_fully_gone",
+      "nasal_queen_nyc"
+    ],
     "profession": "Unknown",
     "interests": ["Chandler Bing", "shopping", "New York", "surprises"],
     "quotes": [
@@ -137,13 +225,21 @@
       "You got 'hate' from that?"
     ],
     "gender": "female",
-    "address": {"city": "New York", "state": "NY", "country": "US"}
+    "address": { "city": "New York", "state": "NY", "country": "US" },
+    "symbol": "😱",
+    "color": "#1e3a5f"
   },
   {
     "id": "richard-burke",
     "firstName": "Richard",
     "lastName": "Burke",
-    "usernames": ["the_mustache_guy", "dr_burke_ophthalmologist", "too_old_for_monica", "eye_doctor_nyc", "richard_with_mustache"],
+    "usernames": [
+      "the_mustache_guy",
+      "dr_burke_ophthalmologist",
+      "too_old_for_monica",
+      "eye_doctor_nyc",
+      "richard_with_mustache"
+    ],
     "profession": "Ophthalmologist",
     "interests": ["Monica Geller", "baseball", "ophthalmology", "cigars", "cooking"],
     "quotes": [
@@ -154,13 +250,21 @@
       "You're with Chandler, a guy I really like. And if you say he's straight, I'll believe you."
     ],
     "gender": "male",
-    "address": {"city": "New York", "state": "NY", "country": "US"}
+    "address": { "city": "New York", "state": "NY", "country": "US" },
+    "symbol": "👨‍⚕️",
+    "color": "#2563eb"
   },
   {
     "id": "mike-hannigan",
     "firstName": "Mike",
     "lastName": "Hannigan",
-    "usernames": ["crap_bag_hannigan", "buffay_hannigan", "piano_mike", "phoebe_plus_one", "mike_not_vtox"],
+    "usernames": [
+      "crap_bag_hannigan",
+      "buffay_hannigan",
+      "piano_mike",
+      "phoebe_plus_one",
+      "mike_not_vtox"
+    ],
     "profession": "Lawyer / Pianist",
     "interests": ["piano", "Phoebe Buffay", "ping pong", "law", "crosswords"],
     "quotes": [
@@ -171,6 +275,8 @@
       "It's a speedo!"
     ],
     "gender": "male",
-    "address": {"city": "New York", "state": "NY", "country": "US"}
+    "address": { "city": "New York", "state": "NY", "country": "US" },
+    "symbol": "🎹",
+    "color": "#16a34a"
   }
 ]

package/data/friends/meta.json

@@ -1 +1,6 @@
-{"id": "friends", "name": "Friends"}
+{
+  "id": "friends",
+  "name": "Friends",
+  "genre": ["comedy", "romance"],
+  "description": "Six friends navigate life, love, and careers in New York City over ten years of coffee-shop conversations and apartment mishaps."
+}