@profpowell/vb-project-planning 0.1.0

package/src/web-components/user-persona/styles.js

@@ -0,0 +1,299 @@
+const styles = `
+  :host {
+    display: block;
+    font-family: var(--user-persona-font, var(--font-sans, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif));
+    --_bg:          var(--user-persona-bg, var(--color-surface, #ffffff));
+    --_text:        var(--user-persona-text, var(--color-text, #1a1a1a));
+    --_border:      var(--user-persona-border, var(--color-border, #e0e0e0));
+    --_muted:       var(--user-persona-muted, var(--color-text-muted, #666));
+    --_accent:      var(--user-persona-accent, var(--color-interactive, #0066cc));
+    --_card-bg:     var(--user-persona-card-bg, var(--color-surface-raised, #f8f9fa));
+    --_radius:      var(--user-persona-radius, var(--radius-xl, 1rem));
+    --_avatar-size: var(--user-persona-avatar-size, 80px);
+    --_goals:       var(--user-persona-goals, #22c55e);
+    --_frustrations: var(--user-persona-frustrations, #ef4444);
+    --_behaviors:   var(--user-persona-behaviors, #8b5cf6);
+    --_stories:     var(--user-persona-stories, #3b82f6);
+    --_shadow:    var(--user-persona-shadow, var(--shadow-md));
+    --_space-2xs: var(--user-persona-space-2xs, var(--size-2xs, 0.25rem));
+    --_space-xs:  var(--user-persona-space-xs, var(--size-xs, 0.5rem));
+    --_space-s:   var(--user-persona-space-s, var(--size-s, 0.75rem));
+    --_space-m:   var(--user-persona-space-m, var(--size-m, 1rem));
+    --_space-l:   var(--user-persona-space-l, var(--size-l, 1.5rem));
+    --_font-xs:   var(--user-persona-font-xs, var(--font-size-xs, 0.75rem));
+    --_font-sm:   var(--user-persona-font-sm, var(--font-size-sm, 0.875rem));
+    --_font-md:   var(--user-persona-font-md, var(--font-size-md, 1rem));
+    --_font-2xl:  var(--user-persona-font-2xl, var(--font-size-2xl, 1.5rem));
+    --_radius-m:  var(--user-persona-radius-m, var(--radius-m, 0.5rem));
+    --_radius-l:  var(--user-persona-radius-l, var(--radius-l, 0.75rem));
+  }
+
+  .persona-card {
+    background: var(--_bg);
+    border: 1px solid var(--_border);
+    border-radius: var(--_radius);
+    overflow: hidden;
+    box-shadow: var(--_shadow);
+  }
+
+  .persona-header {
+    display: flex;
+    align-items: center;
+    gap: var(--_space-l);
+    padding: var(--_space-l);
+    background: var(--_card-bg);
+    border-bottom: 1px solid var(--_border);
+  }
+
+  :host([compact]) .persona-header {
+    padding: var(--_space-m);
+    gap: var(--_space-m);
+  }
+
+  .avatar {
+    width: var(--_avatar-size);
+    height: var(--_avatar-size);
+    border-radius: 50%;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    font-size: 28px;
+    font-weight: 600;
+    color: white;
+    flex-shrink: 0;
+    box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
+  }
+
+  :host([compact]) .avatar {
+    width: 56px;
+    height: 56px;
+    font-size: 20px;
+  }
+
+  .header-info {
+    flex: 1;
+    min-width: 0;
+  }
+
+  .persona-name {
+    font-size: var(--_font-2xl);
+    font-weight: 700;
+    color: var(--_text);
+    margin: 0 0 var(--_space-2xs) 0;
+  }
+
+  :host([compact]) .persona-name {
+    font-size: 18px;
+  }
+
+  .persona-role {
+    font-size: var(--_font-md);
+    color: var(--_accent);
+    font-weight: 500;
+    margin: 0;
+  }
+
+  :host([compact]) .persona-role {
+    font-size: var(--_font-sm);
+  }
+
+  .persona-meta {
+    display: flex;
+    gap: var(--_space-m);
+    margin-top: var(--_space-xs);
+    flex-wrap: wrap;
+  }
+
+  .meta-item {
+    display: flex;
+    align-items: center;
+    gap: 6px;
+    font-size: 13px;
+    color: var(--_muted);
+  }
+
+  .meta-item svg {
+    width: 14px;
+    height: 14px;
+    fill: currentColor;
+    opacity: 0.7;
+  }
+
+  .persona-quote {
+    padding: 20px var(--_space-l);
+    background: var(--_card-bg);
+    border-bottom: 1px solid var(--_border);
+    position: relative;
+  }
+
+  :host([compact]) .persona-quote {
+    padding: var(--_space-m);
+  }
+
+  .quote-mark {
+    position: absolute;
+    top: 12px;
+    left: 16px;
+    font-size: 48px;
+    line-height: 1;
+    color: var(--_accent);
+    opacity: 0.2;
+    font-family: Georgia, serif;
+  }
+
+  .quote-text {
+    font-size: var(--_font-md);
+    font-style: italic;
+    color: var(--_text);
+    line-height: 1.6;
+    margin: 0;
+    padding-left: var(--_space-l);
+  }
+
+  :host([compact]) .quote-text {
+    font-size: var(--_font-sm);
+  }
+
+  .persona-body {
+    padding: var(--_space-l);
+    display: grid;
+    grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
+    gap: var(--_space-l);
+  }
+
+  :host([compact]) .persona-body {
+    padding: var(--_space-m);
+    gap: var(--_space-m);
+  }
+
+  .section {
+    background: var(--_card-bg);
+    border-radius: var(--_radius-l);
+    padding: var(--_space-m);
+  }
+
+  .section-header {
+    display: flex;
+    align-items: center;
+    gap: var(--_space-xs);
+    margin-bottom: var(--_space-s);
+  }
+
+  .section-icon {
+    width: 28px;
+    height: 28px;
+    border-radius: var(--_radius-m);
+    display: flex;
+    align-items: center;
+    justify-content: center;
+  }
+
+  .section-icon svg {
+    width: 16px;
+    height: 16px;
+    fill: white;
+  }
+
+  .section-icon.bio { background: var(--_accent); }
+  .section-icon.goals { background: var(--_goals); }
+  .section-icon.frustrations { background: var(--_frustrations); }
+  .section-icon.behaviors { background: var(--_behaviors); }
+  .section-icon.stories { background: var(--_stories); }
+
+  /* Stories section — auto-rendered list of related <user-story> elements */
+  .section-count {
+    margin-inline-start: var(--_space-2xs);
+    padding: 0.05em 0.5ch;
+    border-radius: 999px;
+    background: var(--color-surface-raised, oklch(95% 0 0));
+    color: var(--color-text-muted);
+    font-size: 0.75em;
+    font-weight: 600;
+  }
+  .story-list {
+    list-style: none;
+    margin: 0;
+    padding: 0;
+    display: grid;
+    gap: var(--_space-2xs);
+  }
+  .story-item {
+    display: flex;
+    align-items: center;
+    gap: var(--_space-s);
+    padding-block: var(--_space-2xs);
+    border-block-end: 1px solid var(--color-border-muted, var(--color-border, #e5e7eb));
+  }
+  .story-item:last-child { border-block-end: none; }
+  .story-item a {
+    color: var(--color-interactive, currentColor);
+    text-decoration: none;
+    flex: 1;
+  }
+  .story-item a:hover { text-decoration: underline; }
+  .story-meta {
+    font-size: var(--_font-xs);
+    color: var(--color-text-muted);
+    text-transform: uppercase;
+    letter-spacing: 0.05em;
+    padding: 0 0.5ch;
+    border: 1px solid var(--color-border-muted, var(--color-border, #e5e7eb));
+    border-radius: var(--_radius-m);
+  }
+  .empty-stories {
+    margin: 0;
+    color: var(--color-text-muted);
+    font-style: italic;
+  }
+
+  .section-title {
+    font-size: var(--_font-sm);
+    font-weight: 600;
+    color: var(--_text);
+    text-transform: uppercase;
+    letter-spacing: 0.5px;
+  }
+
+  .section-content {
+    color: var(--_text);
+    font-size: var(--_font-sm);
+    line-height: 1.6;
+  }
+
+  .section-content ::slotted(ul),
+  .section-content ::slotted(ol) {
+    margin: 0;
+    padding-left: 20px;
+  }
+
+  .section-content ::slotted(li) {
+    margin-bottom: var(--_space-xs);
+  }
+
+  .section-content ::slotted(p) {
+    margin: 0;
+  }
+
+  @media (max-width: 600px) {
+    .persona-header {
+      flex-direction: column;
+      text-align: center;
+    }
+
+    .persona-meta {
+      justify-content: center;
+    }
+
+    .persona-body {
+      grid-template-columns: 1fr;
+    }
+  }
+
+  @media (prefers-reduced-motion: reduce) {
+    * {
+      transition: none !important;
+    }
+  }
+`;
+
+export { styles };

package/src/web-components/user-story/api.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "../../../schemas/api.schema.json",
+  "element": "user-story",
+  "type": "web-component",
+  "description": "Agile user story card — 'As a [persona], I want [action] so that [benefit]' with slotted content and state attributes",
+  "htmlvalidate": {
+    "flow": true,
+    "permittedContent": ["@flow"]
+  },
+  "attributes": [
+    { "name": "persona-id", "kind": "host-api", "purpose": "config", "type": "string",  "description": "Links to a user-persona element by id" },
+    { "name": "priority",   "kind": "host-api", "purpose": "config", "type": "enum", "values": ["critical", "high", "medium", "low"], "description": "Story priority level" },
+    { "name": "status",     "kind": "host-api", "purpose": "config", "type": "enum", "values": ["backlog", "to-do", "in-progress", "review", "done"], "description": "Workflow status" },
+    { "name": "points",     "kind": "host-api", "purpose": "config", "type": "string",  "description": "Story point estimate" },
+    { "name": "epic",       "kind": "host-api", "purpose": "config", "type": "string",  "description": "Parent epic label" },
+    { "name": "story-id",   "kind": "host-api", "purpose": "config", "type": "string",  "description": "Ticket or story identifier, auto-sets HTML id" },
+    { "name": "detail",     "kind": "host-api", "purpose": "config", "type": "enum", "values": ["full", "compact", "minimal"], "description": "Detail level" },
+    { "name": "compact",    "kind": "host-api", "purpose": "config", "type": "boolean", "description": "Alias for detail=compact" },
+    { "name": "src",        "kind": "host-api", "purpose": "config", "type": "string",  "description": "URL to JSON data" }
+  ],
+  "slots": [
+    { "name": "persona",             "description": "The 'As a...' role (e.g., <span>)" },
+    { "name": "action",              "description": "The 'I want...' description (e.g., <span>)" },
+    { "name": "benefit",             "description": "The 'so that...' outcome (e.g., <span>)" },
+    { "name": "title",               "description": "Short label for minimal mode (e.g., <h3>)" },
+    { "name": "acceptance-criteria", "description": "Acceptance criteria checklist (e.g., <ul>)" },
+    { "name": "tasks",               "description": "Implementation task list (e.g., <ul>)" },
+    { "name": "notes",               "description": "Additional context (e.g., <p>)" }
+  ],
+  "events": [
+    { "name": "story-ready",      "detail": "{ id, persona, action, benefit, priority, status, points }", "description": "Fired after render" },
+    { "name": "status-changed",   "detail": "{ status, storyId }",   "description": "Fired when updateStatus() is called" },
+    { "name": "priority-changed", "detail": "{ priority, storyId }", "description": "Fired when updatePriority() is called" }
+  ]
+}