@lacspace/logo 1.0.0

package/LICENSE

@@ -0,0 +1,51 @@
+Lacspace Free Licence
+Version 1.0, August 2026
+
+Copyright (c) 2026 Lacspace
+
+PREAMBLE
+
+This software is published by Lacspace under the Lacspace Free Licence — a free,
+permissive licence that lets you use this software for any purpose, including in
+commercial products and services, at no cost. It grants the same freedoms as
+common permissive open-source licences; the only condition is that this notice
+travels with the software. The canonical, always-current text of this licence is
+maintained at https://lacspace.com/licenses/lacspace-free-1.0
+
+GRANT OF RIGHTS
+
+Permission is hereby granted, free of charge, to any person or organisation
+obtaining a copy of this software and its associated documentation and data 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 conditions below. These rights are
+granted for any purpose, personal or commercial, and are perpetual, worldwide,
+non-exclusive, and royalty-free.
+
+CONDITIONS
+
+The above copyright notice, this permission notice, and the name of this licence
+("Lacspace Free Licence") shall be included in all copies or substantial portions
+of the Software.
+
+TRADEMARKS
+
+This licence does not grant permission to use the trade names, trademarks, service
+marks, logos, or product names of Lacspace, except as required to reproduce the
+notice above or to describe the origin of the Software in a truthful manner.
+
+DISCLAIMER OF WARRANTY AND LIMITATION OF LIABILITY
+
+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.
+
+---
+
+The Lacspace Free Licence is a source-available, permissive licence and is not (as
+of this version) an OSI-approved licence. In substance it grants the same freedoms
+as the MIT Licence. Learn more at https://lacspace.com/licenses

package/README.md

@@ -0,0 +1,130 @@
+<div align="center">
+
+# @lacspace/logo
+
+**Generate real logos from a name + a few keywords — no AI.**
+
+[![npm version](https://img.shields.io/npm/v/@lacspace/logo?color=%2316a34a&label=npm)](https://www.npmjs.com/package/@lacspace/logo)
+[![install size](https://packagephobia.com/badge?p=@lacspace/logo)](https://packagephobia.com/result?p=@lacspace/logo)
+[![minzipped](https://img.shields.io/bundlephobia/minzip/@lacspace/logo?label=minzip)](https://bundlephobia.com/package/@lacspace/logo)
+[![types](https://img.shields.io/badge/types-included-blue)](https://www.npmjs.com/package/@lacspace/logo)
+[![license](https://img.shields.io/npm/l/@lacspace/logo?color=green)](https://github.com/lacspace/npm-packages/blob/main/LICENSE)
+
+</div>
+
+> Give a brand **name** and a few **keywords** and get an on-brand **SVG logo** — a monogram, an icon lockup, a geometric mark or an emblem. Choices (palette, type, icon, shape, layout) come deterministically from a curated JSON brain, so the same brief always yields the same logo, and a changed seed spins endless variations. Editable, infinitely scalable, and rasterizable to PNG/JPEG/WebP via [`@lacspace/image`](https://www.npmjs.com/package/@lacspace/image).
+
+**Not AI art — designed brand assets.** Instant, free, reproducible, keyless, zero-dependency, isomorphic.
+
+## Install
+
+```bash
+npm i @lacspace/logo
+```
+
+## One brief → a logo
+
+```ts
+import { generateLogo } from "@lacspace/logo";
+
+const { svg, palette, icon } = generateLogo({
+  name: "Kopi House",
+  keywords: "coffee, cozy, artisanal, warm",
+});
+// svg → a complete <svg> string (coffee ☕ mark, warm amber palette, emblem seal)
+```
+
+Pass a longer brief and it extracts the keywords for you:
+
+```ts
+generateLogo({
+  name: "Ledgerly",
+  brief: "A trustworthy fintech that automates bookkeeping for small businesses.",
+});
+// → finance mood, deep-indigo palette, wallet icon, clean corporate type
+```
+
+## 12 concepts to choose from (the slot-machine)
+
+```ts
+import { generateLogoSet } from "@lacspace/logo";
+
+const concepts = generateLogoSet({ name: "Orbit Labs", keywords: "ai, network, fast" }, 12);
+// 12 reproducible variations — different engines, palettes, layouts
+```
+
+## See *why* it chose what it did
+
+```ts
+import { suggest } from "@lacspace/logo";
+
+suggest({ name: "Ledgerly", keywords: "fintech trust money" });
+// { mood: "finance", paletteId: "deep-indigo", fontId: "...", iconKey: "wallet",
+//   notes: ["mood \"Finance\" from keywords", "palette Deep Indigo", ...] }
+```
+
+## The five engines
+
+| Engine | What you get |
+| --- | --- |
+| `monogram` | Initials on a gradient badge (circle · squircle · hexagon · shield · seal) |
+| `wordmark` | A keyword-matched **icon** locked up with the name |
+| `abstract` | A seeded **geometric mark** — orbit/network, venn, arcs, burst, waves, dot-grid |
+| `emblem` | A seal/ring with an icon and the name **curved along the bottom** |
+| `lettermark` | One big display letter filled with the brand gradient |
+
+Let the brief pick the engine, or force one: `generateLogo({ name, engine: "emblem" })`.
+
+## Everything is overridable
+
+```ts
+generateLogo({
+  name: "Aurelia",
+  keywords: "luxury, beauty",
+  palette: "royal-gold",   // force a palette id
+  font: "playfair-luxe",   // force a type pairing
+  icon: "crown",           // force an icon
+  shape: "seal",           // circle | rounded | squircle | hexagon | shield | seal | diamond | blob | none
+  layout: "emblem",        // icon-left | icon-top | stacked | wordmark-only | emblem | mark-only
+  engine: "emblem",
+  background: "surface",   // transparent | solid | surface | gradient
+  size: 512,
+  seed: 7,                  // deterministic variation
+});
+```
+
+## Export to raster (PNG / JPEG / WebP) with a size budget
+
+Logos are SVG — universal and editable. To rasterize, pair with `@lacspace/image`:
+
+```ts
+import { generateLogo } from "@lacspace/logo";
+import { rasterizeSvg, fit } from "@lacspace/image";
+
+const { svg } = generateLogo({ name: "Orbit Labs", keywords: "ai, network" });
+const surface = await rasterizeSvg(svg, { width: 512, height: 512 });     // browser Canvas / optional sharp in Node
+const png = await fit(surface, { format: "png", maxSize: "40kb" });
+```
+
+> **SVG renders everywhere.** Rasterizing text logos in **Node** needs the optional `sharp` peer (`npm i sharp`); in the **browser** it uses the native Canvas with no extra deps. The geometric/icon marks rasterize anywhere.
+
+## The JSON brain (extensible)
+
+The creativity lives in data you can extend: `palettes` (mood-tagged), `fonts` (curated Google pairings), `icons` (keyword-tagged line glyphs), `moods` (style presets), plus a color/vibe keyword interpreter. They're exported for building your own UI:
+
+```ts
+import { PALETTES, FONTS, ICONS, MOODS } from "@lacspace/logo";
+```
+
+## API
+
+- `generateLogo(brief)` → `{ svg, width, height, engine, palette, font, icon, shape, layout, mood, seed, interpreted }`
+- `generateLogoSet(brief, count = 12)` → `LogoResult[]`
+- `suggest(brief)` → the interpretation only (no render)
+- `tokenize(brief)`, `initials(name)`, and the `PALETTES` / `FONTS` / `ICONS` / `MOODS` data
+
+## License
+
+[Lacspace Free Licence v1.0](https://github.com/lacspace/npm-packages/blob/main/LICENSE) — free, permissive, Lacspace-branded.
+
+<div align="center"><sub>Part of the <a href="https://developer.lacspace.com/packages">Lacspace</a> ecosystem · zero-dependency · isomorphic · fully typed</sub></div>