exotic-car-logos 0.2.0

package/LEGAL.md

@@ -0,0 +1,27 @@
+# Legal Disclaimer
+
+All brand logos, wordmarks, and emblems included in or referenced by this package
+are the trademarks and/or registered trademarks of their respective owners.
+
+Logo images are sourced from carlogos.org for reference and informational purposes.
+This package is not affiliated with, endorsed by, or sponsored by any of the brands
+represented herein.
+
+## Your Responsibility
+
+By using this package, you agree to:
+
+- Review each brand's official trademark and usage guidelines before any use
+- Obtain appropriate licenses for commercial use where required
+- Not use logos in a way that implies endorsement, affiliation, or sponsorship
+- Comply with all applicable trademark and intellectual property laws
+
+## Takedown Policy
+
+If you are a trademark owner and believe a logo is being used improperly,
+please open an issue at [github.com/mattwhite8/exotic-car-logos/issues](https://github.com/mattwhite8/exotic-car-logos/issues)
+and we will remove the relevant content promptly.
+
+## Source Attribution
+
+PNG images sourced from [carlogos.org](https://www.carlogos.org).

package/LICENSE

@@ -0,0 +1,26 @@
+MIT License
+
+Copyright (c) 2025 Matt White
+
+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.
+
+IMPORTANT: The MIT license applies to the JavaScript/TypeScript source code
+of this package only. All brand logos, trademarks, and trade dress referenced
+by this package are the property of their respective owners and are NOT covered
+by this license. See LEGAL.md for details.

package/README.md

@@ -0,0 +1,106 @@
+# exotic-car-logos
+
+PNG logo components for the top 50 exotic & luxury car brands. React & React Native compatible. Tree-shakeable. TypeScript.
+
+## Installation
+
+```bash
+npm install exotic-car-logos
+```
+
+## Quick Start
+
+```tsx
+import { Ferrari, McLaren } from 'exotic-car-logos';
+
+// Or tree-shaken single import:
+import Ferrari from 'exotic-car-logos/logos/Ferrari';
+
+<Ferrari size="md" />           // 160px (default)
+<Ferrari size="sm" />           // 80px
+<Ferrari size="lg" />           // 320px
+<Ferrari width={240} />         // custom override
+<Ferrari alt="Ferrari Logo" />  // accessible alt
+```
+
+## Size Presets
+
+| Prop value  | Renders at | Fetches PNG | Best for                |
+| ----------- | ---------- | ----------- | ----------------------- |
+| `size="sm"` | 80px       | 160px (2x)  | Nav, tables, thumbnails |
+| `size="md"` | 160px      | 320px (2x)  | Cards, lists (default)  |
+| `size="lg"` | 320px      | 640px (2x)  | Hero, detail views      |
+| `width={N}` | Npx        | 640px       | Any custom size         |
+
+## Props
+
+| Prop        | Type                    | Default    | Description                                      |
+| ----------- | ----------------------- | ---------- | ------------------------------------------------ |
+| `size`      | `'sm' \| 'md' \| 'lg'` | `'md'`     | Size preset                                      |
+| `width`     | `number`                | --         | Custom width in px (overrides size)              |
+| `height`    | `number`                | --         | Custom height in px (overrides size)             |
+| `alt`       | `string`                | brand name | Accessible alt text                              |
+| `loading`   | `'lazy' \| 'eager'`    | `'lazy'`   | Native loading strategy                          |
+| `className` | `string`                | --         | CSS class(es)                                    |
+| `style`     | `CSSProperties`         | --         | Inline styles (merged with `objectFit: contain`) |
+| `...rest`   | `ImgHTMLAttributes`     | --         | Any standard `<img>` attribute                   |
+
+## Brand Metadata
+
+Each brand exports a `meta` object alongside the component:
+
+```tsx
+import { FerrariMeta } from 'exotic-car-logos';
+
+console.log(FerrariMeta.title);   // "Ferrari"
+console.log(FerrariMeta.country); // "Italy"
+console.log(FerrariMeta.hex);     // "CD212A"
+console.log(FerrariMeta.founded); // 1939
+```
+
+## Dynamic Rendering
+
+For rendering logos from string keys:
+
+```tsx
+import * as CarLogos from 'exotic-car-logos/allLogos';
+
+const brandName = 'Ferrari';
+const Logo = CarLogos[brandName as keyof typeof CarLogos];
+<Logo size="md" />;
+```
+
+## React Native
+
+Use the metadata `pngUrl` with React Native's `Image`:
+
+```tsx
+import { Image } from 'react-native';
+import { FerrariMeta } from 'exotic-car-logos';
+
+<Image source={{ uri: FerrariMeta.pngUrl }} style={{ width: 160, height: 160 }} />;
+```
+
+## All 50 Brands
+
+**Italian:** Ferrari, Lamborghini, Maserati, Alfa Romeo, Pagani, De Tomaso, Pininfarina, Dallara, Abarth, Italdesign
+
+**German:** Porsche, BMW, Mercedes-AMG, Brabus, Audi, Maybach, RUF, Gumpert, Apollo
+
+**British:** McLaren, Bentley, Rolls-Royce, Aston Martin, Lotus, Jaguar, Noble, TVR, Radical, Arash, Lister
+
+**French:** Bugatti, Alpine
+
+**American:** Shelby, Dodge, Chevrolet, Ford, Saleen, Hennessey, SSC, Mosler, Czinger, Glickenhaus
+
+**Swedish:** Koenigsegg, Polestar
+
+**Other:** Rimac (Croatia), Zenvo (Denmark), Spyker (Netherlands), W Motors (UAE), Lykan (UAE), Icona (Italy)
+
+## Legal
+
+All logos are trademarks of their respective owners. See [LEGAL.md](./LEGAL.md) for details.
+
+## License
+
+MIT (source code only). See [LICENSE](./LICENSE).

package/dist/allLogos.d.ts

@@ -0,0 +1,40 @@
+export { Abarth } from "./logos/Abarth";
+export { AlfaRomeo } from "./logos/AlfaRomeo";
+export { Alpine } from "./logos/Alpine";
+export { Arash } from "./logos/Arash";
+export { AstonMartin } from "./logos/AstonMartin";
+export { Audi } from "./logos/Audi";
+export { Bentley } from "./logos/Bentley";
+export { BMW } from "./logos/BMW";
+export { Brabus } from "./logos/Brabus";
+export { Bugatti } from "./logos/Bugatti";
+export { Chevrolet } from "./logos/Chevrolet";
+export { DeTomaso } from "./logos/DeTomaso";
+export { Dodge } from "./logos/Dodge";
+export { Ferrari } from "./logos/Ferrari";
+export { Ford } from "./logos/Ford";
+export { Gumpert } from "./logos/Gumpert";
+export { Hennessey } from "./logos/Hennessey";
+export { Jaguar } from "./logos/Jaguar";
+export { Koenigsegg } from "./logos/Koenigsegg";
+export { Lamborghini } from "./logos/Lamborghini";
+export { Lotus } from "./logos/Lotus";
+export { Maserati } from "./logos/Maserati";
+export { Maybach } from "./logos/Maybach";
+export { McLaren } from "./logos/McLaren";
+export { MercedesAMG } from "./logos/MercedesAMG";
+export { Mosler } from "./logos/Mosler";
+export { Pagani } from "./logos/Pagani";
+export { Pininfarina } from "./logos/Pininfarina";
+export { Polestar } from "./logos/Polestar";
+export { Porsche } from "./logos/Porsche";
+export { Radical } from "./logos/Radical";
+export { Rimac } from "./logos/Rimac";
+export { RollsRoyce } from "./logos/RollsRoyce";
+export { Saleen } from "./logos/Saleen";
+export { Shelby } from "./logos/Shelby";
+export { Spyker } from "./logos/Spyker";
+export { SSC } from "./logos/SSC";
+export { TVR } from "./logos/TVR";
+export { WMotors } from "./logos/WMotors";
+export { Zenvo } from "./logos/Zenvo";

package/dist/index.d.ts

@@ -0,0 +1,42 @@
+export { Abarth, meta as AbarthMeta } from "./logos/Abarth";
+export { AlfaRomeo, meta as AlfaRomeoMeta } from "./logos/AlfaRomeo";
+export { Alpine, meta as AlpineMeta } from "./logos/Alpine";
+export { Arash, meta as ArashMeta } from "./logos/Arash";
+export { AstonMartin, meta as AstonMartinMeta } from "./logos/AstonMartin";
+export { Audi, meta as AudiMeta } from "./logos/Audi";
+export { Bentley, meta as BentleyMeta } from "./logos/Bentley";
+export { BMW, meta as BMWMeta } from "./logos/BMW";
+export { Brabus, meta as BrabusMeta } from "./logos/Brabus";
+export { Bugatti, meta as BugattiMeta } from "./logos/Bugatti";
+export { Chevrolet, meta as ChevroletMeta } from "./logos/Chevrolet";
+export { DeTomaso, meta as DeTomasoMeta } from "./logos/DeTomaso";
+export { Dodge, meta as DodgeMeta } from "./logos/Dodge";
+export { Ferrari, meta as FerrariMeta } from "./logos/Ferrari";
+export { Ford, meta as FordMeta } from "./logos/Ford";
+export { Gumpert, meta as GumpertMeta } from "./logos/Gumpert";
+export { Hennessey, meta as HennesseyMeta } from "./logos/Hennessey";
+export { Jaguar, meta as JaguarMeta } from "./logos/Jaguar";
+export { Koenigsegg, meta as KoenigseggMeta } from "./logos/Koenigsegg";
+export { Lamborghini, meta as LamborghiniMeta } from "./logos/Lamborghini";
+export { Lotus, meta as LotusMeta } from "./logos/Lotus";
+export { Maserati, meta as MaseratiMeta } from "./logos/Maserati";
+export { Maybach, meta as MaybachMeta } from "./logos/Maybach";
+export { McLaren, meta as McLarenMeta } from "./logos/McLaren";
+export { MercedesAMG, meta as MercedesAMGMeta } from "./logos/MercedesAMG";
+export { Mosler, meta as MoslerMeta } from "./logos/Mosler";
+export { Pagani, meta as PaganiMeta } from "./logos/Pagani";
+export { Pininfarina, meta as PininfarinaMeta } from "./logos/Pininfarina";
+export { Polestar, meta as PolestarMeta } from "./logos/Polestar";
+export { Porsche, meta as PorscheMeta } from "./logos/Porsche";
+export { Radical, meta as RadicalMeta } from "./logos/Radical";
+export { Rimac, meta as RimacMeta } from "./logos/Rimac";
+export { RollsRoyce, meta as RollsRoyceMeta } from "./logos/RollsRoyce";
+export { Saleen, meta as SaleenMeta } from "./logos/Saleen";
+export { Shelby, meta as ShelbyMeta } from "./logos/Shelby";
+export { Spyker, meta as SpykerMeta } from "./logos/Spyker";
+export { SSC, meta as SSCMeta } from "./logos/SSC";
+export { TVR, meta as TVRMeta } from "./logos/TVR";
+export { WMotors, meta as WMotorsMeta } from "./logos/WMotors";
+export { Zenvo, meta as ZenvoMeta } from "./logos/Zenvo";
+export type { CarLogoProps, CarLogoMeta, LogoSize } from "./types";
+export { SIZE_MAP, CDN_WIDTH_MAP } from "./types";