@pithyjs/pidl-catalog 0.1.0-beta.0

package/dist/src/borders-psychology.js

@@ -0,0 +1,42 @@
+/** @codex { "id": "pithy.pidl-catalog.borders-psychology", "title": "Borders Psychology Guidance", "category": "feature" } */
+/**
+ * Borders Psychology guidance — proprietary research-backed border-weight rules,
+ * injected into the AI system prompt so generated sites use a border style that
+ * fits the user's industry / use-case / mood.
+ *
+ * Border weight signals structure and definition: minimal/none reads airy,
+ * modern, content-first; subtle reads gently defined; standard reads clear and
+ * structured; strong reads bold, utilitarian, data-dense. Maps onto the design
+ * system's border presets (minimal / subtle / standard / strong). Intentionally
+ * compact for the 0.1 release.
+ *
+ * This file lives in the private @pithyjs/pidl-catalog package and is NEVER
+ * published to npm — it is IP and must stay server-side.
+ */
+export const BORDERS_PSYCHOLOGY_GUIDANCE = `
+## Border Psychology (structure & definition)
+
+Border weight signals how structured vs. airy a UI feels. Minimal/none reads
+modern, open, content-first; subtle reads gently defined and calm; standard reads
+clear, organized, professional; strong reads bold, utilitarian, information-dense.
+Pick the weight that matches the brand and how much structure the content needs.
+
+### Border preset → use-case
+- minimal → editorial, luxury, photography, minimalist & high-design brands —
+  rely on whitespace, not lines
+- subtle → most consumer & marketing sites, wellness, calm brands — light
+  definition
+- standard (default) → SaaS, business, forms-heavy or app-like products — clear,
+  organized structure
+- strong → dashboards, data tables, enterprise & admin tools — maximum
+  delineation for dense information
+
+### Applying it
+For a NEW page or site built from scratch, emit ONE \`theme.setPreset\` mutation
+to set the border weight — exact shape:
+\`{ "op": "theme.setPreset", "module": "borders", "value": "subtle" }\`
+\`value\` MUST be one of: minimal, subtle, standard, strong. Do this only for new
+builds, not for small content edits, and never when the user asks to keep the
+current style.
+`.trim();
+//# sourceMappingURL=borders-psychology.js.map

package/dist/src/borders-psychology.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"borders-psychology.js","sourceRoot":"","sources":["../../src/borders-psychology.ts"],"names":[],"mappings":"AAAA,8HAA8H;AAE9H;;;;;;;;;;;;;GAaG;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;CAyB1C,CAAC,IAAI,EAAE,CAAC"}

package/dist/src/color-psychology.d.ts

@@ -0,0 +1,20 @@
+/** @codex { "id": "pithy.pidl-catalog.color-psychology", "title": "Color Psychology Guidance", "category": "feature" } */
+/**
+ * Color Psychology guidance — proprietary research-backed color selection rules.
+ *
+ * Injected into the AI system prompt so the model chooses a brand `--color-primary`
+ * (OKLCH) suited to the user's industry / use-case / mood, instead of defaulting
+ * to blue. The design system re-derives the ENTIRE palette (surfaces, text,
+ * borders, statuses, tints) from that single seed, so a well-chosen primary is
+ * the highest-leverage decision the AI makes about a site's look.
+ *
+ * Hue values are OKLCH degrees; lightness/chroma ranges are tuned so the derived
+ * palette stays accessible in BOTH light and dark mode. This is intentionally
+ * compact for the 0.1 release — a heuristic the model applies, not an exhaustive
+ * taxonomy.
+ *
+ * This file lives in the private @pithyjs/pidl-catalog package and is NEVER
+ * published to npm — it is part of our IP and must stay server-side.
+ */
+export declare const COLOR_PSYCHOLOGY_GUIDANCE: string;
+//# sourceMappingURL=color-psychology.d.ts.map

package/dist/src/color-psychology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-psychology.d.ts","sourceRoot":"","sources":["../../src/color-psychology.ts"],"names":[],"mappings":"AAAA,0HAA0H;AAE1H;;;;;;;;;;;;;;;;GAgBG;AAEH,eAAO,MAAM,yBAAyB,QAqC9B,CAAC"}

package/dist/src/color-psychology.js

@@ -0,0 +1,57 @@
+/** @codex { "id": "pithy.pidl-catalog.color-psychology", "title": "Color Psychology Guidance", "category": "feature" } */
+/**
+ * Color Psychology guidance — proprietary research-backed color selection rules.
+ *
+ * Injected into the AI system prompt so the model chooses a brand `--color-primary`
+ * (OKLCH) suited to the user's industry / use-case / mood, instead of defaulting
+ * to blue. The design system re-derives the ENTIRE palette (surfaces, text,
+ * borders, statuses, tints) from that single seed, so a well-chosen primary is
+ * the highest-leverage decision the AI makes about a site's look.
+ *
+ * Hue values are OKLCH degrees; lightness/chroma ranges are tuned so the derived
+ * palette stays accessible in BOTH light and dark mode. This is intentionally
+ * compact for the 0.1 release — a heuristic the model applies, not an exhaustive
+ * taxonomy.
+ *
+ * This file lives in the private @pithyjs/pidl-catalog package and is NEVER
+ * published to npm — it is part of our IP and must stay server-side.
+ */
+export const COLOR_PSYCHOLOGY_GUIDANCE = `
+## Color Psychology (choosing the brand primary)
+
+When building a site from scratch, choose \`--color-primary\` deliberately from the
+psychology of the user's industry and mood — never leave it on the default blue.
+Colors carry consistent emotional associations: blue = trust/calm, green =
+growth/health, red = energy/appetite, purple = creativity/luxury, orange/yellow =
+warmth/optimism, pink = warmth/approachability, near-neutral = premium/minimal.
+
+### Industry → hue (OKLCH degrees)
+- Healthcare / wellness / medical → calm blue (250), healing teal (195), or balanced green (150)
+- Finance / banking / legal / insurance → deep trust blue (255–265), or low-chroma slate
+- Tech / SaaS / startup → confident blue (255) or electric indigo/violet (280)
+- Food / restaurant / coffee → appetite red (28), warm orange (55), or earthy brown (low-chroma 60)
+- Eco / sustainability / outdoors / agriculture → natural green (145) or earthy olive (110)
+- Beauty / fashion / lifestyle → magenta-pink (350) or soft violet (300)
+- Education / nonprofit / community → friendly blue (250), optimistic teal (190), or warm orange (60)
+- Luxury / premium → very low-chroma near-neutral, deep violet (300), with optional gold accent (85)
+- Creative / entertainment / media → vivid violet (290) or energetic magenta (330)
+- Real estate / construction / industrial → dependable blue (250) or strong slate, optional amber (70)
+- Playful / kids → cheerful yellow (95) or friendly coral (30)
+
+### Tuning lightness & chroma to personality
+- Bold / energetic / youthful → higher chroma (0.16–0.22), lightness 60–70%
+- Professional / trustworthy / calm → moderate chroma (0.08–0.14), lightness 50–60%
+- Luxury / premium / minimal → low chroma (0.02–0.06), lightness 38–52%
+- Friendly / approachable → warm hue, lightness 64–72%
+
+### Selection strategy
+1. Infer the industry AND the mood from the user's prompt (e.g. "modern coffee shop" → food + warm/inviting).
+2. Pick a hue from the matching industry band above.
+3. Set lightness & chroma from the brand personality.
+4. Keep lightness roughly 45–70% so the design system can derive accessible contrast in BOTH light and dark mode.
+5. Pick blue ONLY when it genuinely fits (trust-critical finance/health/tech) — otherwise differentiate.
+
+Apply your choice as the single \`theme.setColor\` \`--color-primary\` mutation
+described in the Output Envelope; the whole palette is derived from it.
+`.trim();
+//# sourceMappingURL=color-psychology.js.map

package/dist/src/color-psychology.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-psychology.js","sourceRoot":"","sources":["../../src/color-psychology.ts"],"names":[],"mappings":"AAAA,0HAA0H;AAE1H;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCxC,CAAC,IAAI,EAAE,CAAC"}

package/dist/src/design-intelligence.d.ts

@@ -0,0 +1,13 @@
+/** @codex { "id": "pithy.pidl-catalog.design-intelligence", "title": "Design Intelligence Rules", "category": "feature" } */
+/**
+ * Design Intelligence rules — proprietary psychology-backed composition rules.
+ *
+ * These rules are injected into the AI system prompt to guide page generation.
+ * They encode design psychology research (Halo Effect, Cognitive Fluency,
+ * Peak-End Rule) and section composition constraints.
+ *
+ * This file lives in the private @pithyjs/pidl-catalog package and is NEVER
+ * published to npm.
+ */
+export declare const DESIGN_INTELLIGENCE_RULES: string;
+//# sourceMappingURL=design-intelligence.d.ts.map

package/dist/src/design-intelligence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-intelligence.d.ts","sourceRoot":"","sources":["../../src/design-intelligence.ts"],"names":[],"mappings":"AAAA,6HAA6H;AAE7H;;;;;;;;;GASG;AAEH,eAAO,MAAM,yBAAyB,QAuB9B,CAAC"}

package/dist/src/design-intelligence.js

@@ -0,0 +1,36 @@
+/** @codex { "id": "pithy.pidl-catalog.design-intelligence", "title": "Design Intelligence Rules", "category": "feature" } */
+/**
+ * Design Intelligence rules — proprietary psychology-backed composition rules.
+ *
+ * These rules are injected into the AI system prompt to guide page generation.
+ * They encode design psychology research (Halo Effect, Cognitive Fluency,
+ * Peak-End Rule) and section composition constraints.
+ *
+ * This file lives in the private @pithyjs/pidl-catalog package and is NEVER
+ * published to npm.
+ */
+export const DESIGN_INTELLIGENCE_RULES = `
+## Design Intelligence Rules
+
+### Halo Effect
+- Use high-quality hero imagery and typography to create positive first impressions
+- The first section sets the perceived quality for the entire page
+- Pair professional imagery with clean, spacious layouts
+
+### Cognitive Fluency
+- Prefer familiar layouts (centered hero, grid features, closing CTA)
+- Use clear visual hierarchy with consistent heading levels
+- Limit choices: 3-5 feature cards, 2-3 pricing tiers, 1-2 CTAs per section
+
+### Peak-End Rule
+- End every page with a strong CTA section or compelling closing message
+- The last section the user sees disproportionately affects their memory of the page
+- Footer should reinforce trust (links, contact info, social proof)
+
+### Section Composition Guidelines
+- Hero: max 1 primary CTA + 1 secondary CTA. No more.
+- Features grid: 3 or 6 items for visual balance. Avoid 4 (awkward 2x2).
+- CTA sections: single focused action. Multiple CTAs dilute effectiveness.
+- Contact: label + value pairs. Validate all URLs with isSafeHref().
+`.trim();
+//# sourceMappingURL=design-intelligence.js.map

package/dist/src/design-intelligence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-intelligence.js","sourceRoot":"","sources":["../../src/design-intelligence.ts"],"names":[],"mappings":"AAAA,6HAA6H;AAE7H;;;;;;;;;GASG;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;CAuBxC,CAAC,IAAI,EAAE,CAAC"}