npm - @kondeio/kdf - Versions diffs - 0.1.0 - Mend

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (59) hide show

package/CHANGELOG.md +33 -0
package/CONTRIBUTING.md +57 -0
package/LICENSE +21 -0
package/README.md +374 -0
package/SECURITY.md +53 -0
package/dist/cli.d.ts +2 -0
package/dist/cli.js +58 -0
package/dist/css-generator.d.ts +17 -0
package/dist/css-generator.js +59 -0
package/dist/index.d.ts +48 -0
package/dist/index.js +62 -0
package/dist/plugin.d.ts +30 -0
package/dist/plugin.js +40 -0
package/dist/postinstall.d.ts +1 -0
package/dist/postinstall.js +48 -0
package/dist/resolver.d.ts +11 -0
package/dist/resolver.js +184 -0
package/dist/types.d.ts +44 -0
package/dist/types.js +1 -0
package/docs/kdf-doc.md +653 -0
package/docs/kdf-skill.md +374 -0
package/example/bootstrap/globals.css +12 -0
package/example/bootstrap/hero-section.tsx +38 -0
package/example/bootstrap/kdf/homepage.json +35 -0
package/example/bootstrap/kdf/shared/button.json +10 -0
package/example/bootstrap/kdf/shared/card.json +4 -0
package/example/bootstrap/kdf/shared/color.json +17 -0
package/example/bootstrap/kdf/shared/layout.json +7 -0
package/example/bootstrap/kdf/shared/typography.json +8 -0
package/example/bootstrap/konde-server.css +3 -0
package/example/bootstrap/konde.css +3 -0
package/example/preview.ts +428 -0
package/example/pure-css/hero-section.tsx +40 -0
package/example/pure-css/kdf/homepage.json +20 -0
package/example/pure-css/kdf/shared/button.json +10 -0
package/example/pure-css/kdf/shared/card.json +4 -0
package/example/pure-css/kdf/shared/color.json +11 -0
package/example/pure-css/kdf/shared/typography.json +8 -0
package/example/pure-css/konde-server.css +3 -0
package/example/pure-css/konde.css +3 -0
package/example/pure-css/styles.css +34 -0
package/example/sample-pages/about.json +30 -0
package/example/sample-pages/dashboard.json +12 -0
package/example/sample-pages/pricing.json +28 -0
package/example/shadcn/globals.css +15 -0
package/example/shadcn/hero-section.tsx +34 -0
package/example/shadcn/konde-server.css +3 -0
package/example/shadcn/konde.css +3 -0
package/example/tailwind/globals.css +5 -0
package/example/tailwind/hero-section.tsx +34 -0
package/example/tailwind/konde-server.css +3 -0
package/example/tailwind/konde.css +3 -0
package/kdf/homepage.json +25 -0
package/kdf/shared/button.json +10 -0
package/kdf/shared/card.json +4 -0
package/kdf/shared/color.json +17 -0
package/kdf/shared/layout.json +7 -0
package/kdf/shared/typography.json +8 -0
package/package.json +77 -0

package/example/shadcn/hero-section.tsx ADDED Viewed

@@ -0,0 +1,34 @@
+import { getDesign } from "@kondeio/kdf";
+import { Button } from "@/components/ui/button";
+export function HeroSection() {
+  const d = getDesign("homepage");
+  return (
+    <section data-kdf="hero.wrapper" className={d("hero.wrapper")}>
+      <div data-kdf="hero.content" className={d("hero.content")}>
+        <h1 data-kdf="hero.title" className={d("hero.title")}>
+          Build websites with AI
+        </h1>
+        <p data-kdf="hero.description" className={d("hero.description")}>
+          The AI orchestration platform for web development teams.
+        </p>
+        <div data-kdf="hero.actions" className={d("hero.actions")}>
+          <Button asChild data-kdf="hero.cta-secondary" className={d("hero.cta-secondary")}>
+            <a href="/about">Learn more</a>
+          </Button>
+          <Button asChild data-kdf="hero.cta-primary" className={d("hero.cta-primary")}>
+            <a href="/pricing">Get started</a>
+          </Button>
+        </div>
+      </div>
+    </section>
+  );
+}
+/*
+  kdf/homepage.json:
+    "hero.cta-primary": { "$": "Button", "variant": "default", "className": "@button.cta" }
+  shadcn Button gets KDF className on top of its own variant styles.
+*/

package/example/shadcn/konde-server.css ADDED Viewed

@@ -0,0 +1,3 @@
+/* konde-server.css — Critical design overrides (server-rendered) */
+/* Imported in layout.tsx — inlined in HTML, no FOUC */
+/* Edit freely — KDF will never overwrite this file */

package/example/shadcn/konde.css ADDED Viewed

@@ -0,0 +1,3 @@
+/* konde.css — Custom design overrides */
+/* Loaded LAST in <head> for highest specificity */
+/* Edit freely — KDF will never overwrite this file */

package/example/tailwind/globals.css ADDED Viewed

@@ -0,0 +1,5 @@
+/* Tailwind CSS — via CDN or build */
+/* CDN (dev only): add <script src="https://cdn.tailwindcss.com"></script> to HTML */
+/* Build (production): @tailwind base; @tailwind components; @tailwind utilities; */
+/* Load konde.css after framework CSS in the host app. withKDF() only exposes paths. */

package/example/tailwind/hero-section.tsx ADDED Viewed

@@ -0,0 +1,34 @@
+import { getDesign } from "@kondeio/kdf";
+export function HeroSection() {
+  const d = getDesign("homepage");
+  return (
+    <section data-kdf="hero.wrapper" className={d("hero.wrapper")}>
+      <div data-kdf="hero.content" className={d("hero.content")}>
+        <h1 data-kdf="hero.title" className={d("hero.title")}>
+          Build websites with AI
+        </h1>
+        <p data-kdf="hero.description" className={d("hero.description")}>
+          The AI orchestration platform for web development teams.
+        </p>
+        <div data-kdf="hero.actions" className={d("hero.actions")}>
+          <a href="/about" data-kdf="hero.cta-secondary" className={d("hero.cta-secondary")}>
+            Learn more
+          </a>
+          <a href="/pricing" data-kdf="hero.cta-primary" className={d("hero.cta-primary")}>
+            Get started
+          </a>
+        </div>
+      </div>
+    </section>
+  );
+}
+/*
+  kdf/shared/button.json:
+    "cta": "bg-blue-600 text-white shadow-lg hover:bg-blue-700 hover:shadow-xl"
+  kdf/homepage.json:
+    "hero.cta-primary": "@button.base @button.cta @button.md"
+*/

package/example/tailwind/konde-server.css ADDED Viewed

@@ -0,0 +1,3 @@
+/* konde-server.css — Critical design overrides (server-rendered) */
+/* Imported in layout.tsx — inlined in HTML, no FOUC */
+/* Edit freely — KDF will never overwrite this file */

package/example/tailwind/konde.css ADDED Viewed

@@ -0,0 +1,3 @@
+/* konde.css — Custom design overrides */
+/* Loaded LAST in <head> for highest specificity */
+/* Edit freely — KDF will never overwrite this file */

package/kdf/homepage.json ADDED Viewed

@@ -0,0 +1,25 @@
+{
+  "hero": {
+    "wrapper": "flex flex-col gap-8 lg:flex-row lg:items-start lg:justify-between",
+    "content": "w-full lg:max-w-[500px]",
+    "title": "@typography.h1",
+    "description": "mt-4 @typography.body",
+    "actions": "mt-6 flex gap-3",
+    "cta-primary": "@button.base @button.cta @button.md",
+    "cta-secondary": "@button.base @button.outline @button.md",
+    "slider": "w-full lg:max-w-[500px]"
+  },
+  "template-grid": {
+    "wrapper": "grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-6 mt-10",
+    "card": "@card.base @card.hover",
+    "card-image": "aspect-video w-full object-cover",
+    "card-body": "p-4",
+    "card-title": "font-medium text-gray-900 text-sm",
+    "card-category": "@typography.small"
+  },
+  "pagination": {
+    "wrapper": "mt-8 flex justify-center gap-2",
+    "button": "@button.base @button.ghost @button.sm",
+    "active": "@button.base @button.primary @button.sm"
+  }
+}

package/kdf/shared/button.json ADDED Viewed

@@ -0,0 +1,10 @@
+{
+  "base": "inline-flex items-center gap-2 rounded font-medium transition-colors",
+  "primary": "bg-blue-600 text-white hover:bg-blue-700",
+  "outline": "border border-gray-300 text-gray-700 hover:bg-gray-50",
+  "ghost": "text-gray-600 hover:bg-gray-100 hover:text-gray-900",
+  "cta": "bg-blue-600 text-white shadow-lg hover:bg-blue-700 hover:shadow-xl",
+  "sm": "px-3 py-1.5 text-sm",
+  "md": "px-4 py-2 text-sm",
+  "lg": "px-6 py-3 text-base"
+}

package/kdf/shared/card.json ADDED Viewed

@@ -0,0 +1,4 @@
+{
+  "base": "bg-white border border-gray-200 rounded-lg overflow-hidden",
+  "hover": "hover:shadow-md transition-shadow"
+}

package/kdf/shared/color.json ADDED Viewed

@@ -0,0 +1,17 @@
+{
+  "primary": {
+    "css": { "--kdf-primary": "#4F46E5" }
+  },
+  "danger": {
+    "css": { "--kdf-danger": "#DC2626" }
+  },
+  "success": {
+    "css": { "--kdf-success": "#16A34A" }
+  },
+  "warning": {
+    "css": { "--kdf-warning": "#D97706" }
+  },
+  "accent": {
+    "css": { "--kdf-accent": "#FF6600" }
+  }
+}

package/kdf/shared/layout.json ADDED Viewed

@@ -0,0 +1,7 @@
+{
+  "header": "sticky top-0 z-20 bg-white/80 backdrop-blur-md border-b border-gray-100 h-14 px-6",
+  "sidebar": "fixed inset-y-0 left-0 z-30 w-64 bg-white border-r border-gray-200 hidden lg:block",
+  "content": "flex-1 px-6 py-10 lg:px-10",
+  "main": "flex w-full flex-col lg:pl-64",
+  "footer": "border-t border-gray-200 py-8 px-6"
+}

package/kdf/shared/typography.json ADDED Viewed

@@ -0,0 +1,8 @@
+{
+  "h1": "text-3xl font-bold leading-tight tracking-tight text-gray-900 sm:text-4xl",
+  "h2": "text-2xl font-bold tracking-tight sm:text-3xl",
+  "h3": "text-xl font-semibold",
+  "body": "text-sm leading-relaxed text-gray-600 sm:text-base",
+  "muted": "text-sm text-gray-500",
+  "small": "text-xs text-gray-400"
+}

package/package.json ADDED Viewed

@@ -0,0 +1,77 @@
+{
+  "name": "@kondeio/kdf",
+  "version": "0.1.0",
+  "description": "Agent-first design consistency for Node-powered web apps. KDF gives AI agents a JSON source of truth for consistent UI.",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "kdf": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./plugin": {
+      "import": "./dist/plugin.js",
+      "types": "./dist/plugin.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "docs",
+    "kdf",
+    "example",
+    "CONTRIBUTING.md",
+    "SECURITY.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "postinstall": "node dist/postinstall.js",
+    "typecheck": "tsc --noEmit",
+    "test": "bun unit-test.ts"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KondeIO/kdf.git"
+  },
+  "homepage": "https://github.com/KondeIO/kdf#readme",
+  "bugs": {
+    "url": "https://github.com/KondeIO/kdf/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "clsx": "^2.1.1"
+  },
+  "peerDependencies": {
+    "next": ">=14"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "tsx": "^4.0.0",
+    "typescript": "^6.0.2"
+  },
+  "keywords": [
+    "design-system",
+    "json",
+    "node",
+    "nextjs",
+    "astro",
+    "hono",
+    "design-tokens"
+  ]
+}

@kondeio/kdf 0.1.0