@aurodesignsystem-dev/auro-cli 0.0.0-pr296.1 → 0.0.0-pr296.2

package/dist/auro-cli.js

@@ -62,7 +62,7 @@ ${Object.entries(e).map(([o,n])=>`  ${o}: ${n}`).join(`
 ${i.map(l=>`  - ${l.replace("@aurodesignsystem","AlaskaAirlines").replace("@alaskaairux/icons","AlaskaAirlines/Icons")}`).join(`
 `)}`).join(`
 
-`);console.log(s),e.text="Running migrations on dependency batches...",new Promise(i=>setTimeout(i,2e3)),e.succeed("Migration process completed successfully.");break}default:console.error("Unknown action selected.")}});import Bo from"node:fs/promises";import Go from"node:path";import{program as Lo}from"commander";import Ho from"ora";var Ue='# Auro Design System \u2014 AI Assistant Context\nAlaska Airlines open-source design system | https://auro.alaskaair.com\n\n## What is Auro?\nAuro is Alaska Airlines\' design system built on Web Components (Custom Elements v1) using the Lit library.\n- npm scope: `@aurodesignsystem/` (current), `@alaskaairux/` (legacy)\n- Framework-agnostic: works with React, Angular, Vue, Svelte, or plain HTML\n- Each component is a separate npm package\n- All components use the `<auro-*>` custom element tag\n\n## Rules for Writing Auro Code\n\n1. **Use `<auro-*>` custom element tags \u2014 never plain HTML equivalents**\n   - \u2717 `<button>` \u2192 \u2713 `<auro-button>`\n   - \u2717 `<a href="...">` \u2192 \u2713 `<auro-hyperlink href="...">`\n   - \u2717 `<input>` \u2192 \u2713 `<auro-input>` (from auro-formkit)\n\n2. **Install and register each component before use**\n   ```bash\n   npm install @aurodesignsystem/auro-button\n   ```\n   ```js\n   import "@aurodesignsystem/auro-button"; // registers <auro-button> globally\n   ```\n\n3. **Props are HTML attributes in templates; camelCase properties in JS**\n   ```html\n   <auro-button disabled loading>Save</auro-button>\n   ```\n   ```js\n   document.querySelector(\'auro-button\').loading = true;\n   ```\n\n4. **Content goes in named slots, not innerHTML**\n   ```html\n   <auro-dialog>\n     <span slot="header">Title</span>\n     <div slot="content">Body content here</div>\n   </auro-dialog>\n   ```\n\n5. **Design tokens are CSS custom properties**\n   ```bash\n   npm install @aurodesignsystem/design-tokens\n   ```\n   ```css\n   @import "@aurodesignsystem/design-tokens/dist/themes/CSSCustomProperties--bundled.css";\n   ```\n   Token naming: `--ds-basic-*` and `--ds-advanced-*` (e.g. `--ds-advanced-color-*`, `--ds-basic-color-*`)\n\n## Component Reference\n\n| Element Tag | Package | Description |\n|---|---|---|\n| `<auro-accordion>` | `@aurodesignsystem/auro-accordion` | Expandable content sections |\n| `<auro-alert>` | `@aurodesignsystem/auro-alert` | Inline status messages: error, warning, success, information |\n| `<auro-avatar>` | `@aurodesignsystem/auro-avatar` | User or entity avatar |\n| `<auro-background>` | `@aurodesignsystem/auro-background` | Themed background wrapper |\n| `<auro-backtotop>` | `@aurodesignsystem/auro-backtotop` | Scroll-to-top button |\n| `<auro-badge>` | `@aurodesignsystem/auro-badge` | Status or count badge |\n| `<auro-banner>` | `@aurodesignsystem/auro-banner` | Full-width promotional banner |\n| `<auro-button>` | `@aurodesignsystem/auro-button` | Interactive button; supports `loading`, `disabled`, `shape` |\n| `<auro-card>` | `@aurodesignsystem/auro-card` | Content card container |\n| `<auro-carousel>` | `@aurodesignsystem/auro-carousel` | Horizontally scrollable carousel |\n| `<auro-datetime>` | `@aurodesignsystem/auro-datetime` | Localized date and time formatting |\n| `<auro-dialog>` | `@aurodesignsystem/auro-dialog` | Modal dialog; slots: header, content, footer |\n| `<auro-drawer>` | `@aurodesignsystem/auro-drawer` | Slide-in panel; slots: header, content, footer |\n| `<auro-flight>` | `@aurodesignsystem/auro-flight` | Flight segment display (origin, destination, stops) |\n| `<auro-flightline>` | `@aurodesignsystem/auro-flightline` | Visual flight path/stop indicator |\n| `<auro-input>` | `@aurodesignsystem/auro-formkit` | Text input field |\n| `<auro-select>` | `@aurodesignsystem/auro-formkit` | Select/dropdown |\n| `<auro-datepicker>` | `@aurodesignsystem/auro-formkit` | Date picker input |\n| `<auro-combobox>` | `@aurodesignsystem/auro-formkit` | Combobox with search |\n| `<auro-checkbox>` | `@aurodesignsystem/auro-formkit` | Checkbox input |\n| `<auro-radio>` | `@aurodesignsystem/auro-formkit` | Radio button input |\n| `<auro-header>` | `@aurodesignsystem/auro-header` | Page/section heading |\n| `<auro-hyperlink>` | `@aurodesignsystem/auro-hyperlink` | Accessible anchor link |\n| `<auro-icon>` | `@aurodesignsystem/auro-icon` | Alaska Airlines icon: `category` + `name` attributes |\n| `<auro-loader>` | `@aurodesignsystem/auro-loader` | Loading spinner |\n| `<auro-lockup>` | `@aurodesignsystem/auro-lockup` | Image + text layout lockup |\n| `<auro-nav>` | `@aurodesignsystem/auro-nav` | Secondary navigation aid (relation to higher-level pages) |\n| `<auro-pane>` | `@aurodesignsystem/auro-pane` | Selectable shoulder dates with associated prices |\n| `<auro-popover>` | `@aurodesignsystem/auro-popover` | Tooltip-style popover |\n| `<auro-sidenav>` | `@aurodesignsystem/auro-sidenav` | Vertical side navigation |\n| `<auro-skeleton>` | `@aurodesignsystem/auro-skeleton` | Loading placeholder skeleton |\n| `<auro-slideshow>` | `@aurodesignsystem/auro-slideshow` | Image/content slideshow |\n| `<auro-table>` | `@aurodesignsystem/auro-table` | Accessible data table |\n| `<auro-tabs>` | `@aurodesignsystem/auro-tabs` | Tabbed content panels |\n| `<auro-tail>` | `@aurodesignsystem/auro-tail` | Alaska, Hawaiian, and partner airline tail graphics |\n| `<auro-toast>` | `@aurodesignsystem/auro-toast` | Transient notification toast |\n\n## Common Patterns\n\n### Button (default, secondary, tertiary)\n```html\n<auro-button>Primary</auro-button>\n<auro-button variant="secondary">Secondary</auro-button>\n<auro-button variant="tertiary">Tertiary</auro-button>\n<auro-button loading>Saving...</auro-button>\n```\n\n### Alert\n```html\n<auro-alert type="success">Changes saved.</auro-alert>\n<auro-alert type="error">Something went wrong.</auro-alert>\n<auro-alert type="warning">Please review before continuing.</auro-alert>\n<auro-alert type="information">Your flight departs at 9am.</auro-alert>\n```\n\n### Form inputs (auro-formkit)\nauro-formkit has no root export \u2014 always import the specific sub-component.\nThe field label is a **slot**, not an attribute.\n```js\nimport "@aurodesignsystem/auro-formkit/auro-input";\nimport "@aurodesignsystem/auro-formkit/auro-select";\n```\n```html\n<auro-input required>\n  <span slot="label">First name</span>\n</auro-input>\n<auro-select>\n  <span slot="label">Seat preference</span>\n  <auro-menu>\n    <auro-menuoption value="window">Window</auro-menuoption>\n    <auro-menuoption value="aisle">Aisle</auro-menuoption>\n  </auro-menu>\n</auro-select>\n```\n\n### Icon\nSet `category` and `name`. Icon names are exact \u2014 check the icon library for the correct name.\n```html\n<auro-icon category="interface" name="arrow-right"></auro-icon>\n<auro-icon category="terminal" name="plane-side-fill"></auro-icon>\n```\n\n### Hyperlink\n```html\n<auro-hyperlink href="/flights">View flights</auro-hyperlink>\n<auro-hyperlink href="https://example.com" target="_blank">External link</auro-hyperlink>\n```\n\n### Dialog (modal)\n```js\ndocument.querySelector(\'#confirmDialog\').show();\n```\n```html\n<auro-dialog id="confirmDialog">\n  <span slot="header">Confirm booking</span>\n  <div slot="content">Are you sure you want to book this flight?</div>\n  <div slot="footer">\n    <auro-button>Confirm</auro-button>\n    <auro-button variant="secondary">Cancel</auro-button>\n  </div>\n</auro-dialog>\n```\n\n## Accessibility Notes\n- Use the `ariaLabel` slot on `<auro-button>` for icon-only buttons\n- `<auro-hyperlink>` adds rel="noopener noreferrer" automatically for external links\n- All `auro-formkit` components handle aria-invalid and error messaging built-in\n- All components meet WCAG 2.1 AA\n\n## Documentation\n- Component docs: https://auro.alaskaair.com\n- Component status: https://auro.alaskaair.com/component-status\n- Design tokens: https://auro.alaskaair.com/getting-started/developers/token-usage\n- Contributing: https://auro.alaskaair.com/getting-started/developers/contributing\n- GitHub: https://github.com/AlaskaAirlines\n';var Sa=Lo.command("context").description("Generate an AI assistant context document for the Auro Design System").option("-o, --output <path>","Write context to a file instead of stdout (e.g. AURO_CONTEXT.md)").action(async r=>{if(r.output){let t=Ho(`Writing context to ${r.output}...`).start();try{let e=Go.resolve(process.cwd(),r.output);await Bo.writeFile(e,Ue,"utf-8"),t.succeed(`Auro context written to ${r.output}`),console.log(`
+`);console.log(s),e.text="Running migrations on dependency batches...",new Promise(i=>setTimeout(i,2e3)),e.succeed("Migration process completed successfully.");break}default:console.error("Unknown action selected.")}});import Bo from"node:fs/promises";import Go from"node:path";import{program as Lo}from"commander";import Ho from"ora";var Ue='# Auro Design System \u2014 AI Assistant Context\nAlaska Airlines open-source design system | https://auro.alaskaair.com\n\n## What is Auro?\nAuro is Alaska Airlines\' design system built on Web Components (Custom Elements v1) using the Lit library.\n- npm scope: `@aurodesignsystem/` (current), `@alaskaairux/` (legacy)\n- Framework-agnostic: works with React, Angular, Vue, Svelte, or plain HTML\n- Each component is a separate npm package\n- All components use the `<auro-*>` custom element tag\n\n## Rules for Writing Auro Code\n\n1. **Use `<auro-*>` custom element tags \u2014 never plain HTML equivalents**\n   - \u2717 `<button>` \u2192 \u2713 `<auro-button>`\n   - \u2717 `<a href="...">` \u2192 \u2713 `<auro-hyperlink href="...">`\n   - \u2717 `<input>` \u2192 \u2713 `<auro-input>` (from auro-formkit)\n\n2. **Install and register each component before use**\n   ```bash\n   npm install @aurodesignsystem/auro-button\n   ```\n   ```js\n   import "@aurodesignsystem/auro-button"; // registers <auro-button> globally\n   ```\n\n3. **Props are HTML attributes in templates; camelCase properties in JS**\n   ```html\n   <auro-button disabled loading>Save</auro-button>\n   ```\n   ```js\n   document.querySelector(\'auro-button\').loading = true;\n   ```\n\n4. **Content goes in named slots, not innerHTML**\n   ```html\n   <auro-dialog>\n     <span slot="header">Title</span>\n     <div slot="content">Body content here</div>\n   </auro-dialog>\n   ```\n\n5. **Design tokens are CSS custom properties**\n   ```bash\n   npm install @aurodesignsystem/design-tokens\n   ```\n   ```css\n   @import "@aurodesignsystem/design-tokens/dist/themes/CSSCustomProperties--bundled.css";\n   ```\n   Token naming: `--ds-basic-*` and `--ds-advanced-*` (e.g. `--ds-advanced-color-*`, `--ds-basic-color-*`)\n\n## Component Reference\n\n| Element Tag | Package | Description |\n|---|---|---|\n| `<auro-accordion>` | `@aurodesignsystem/auro-accordion` | Expandable content sections |\n| `<auro-alert>` | `@aurodesignsystem/auro-alert` | Inline status messages: error, warning, success, information |\n| `<auro-avatar>` | `@aurodesignsystem/auro-avatar` | User or entity avatar |\n| `<auro-background>` | `@aurodesignsystem/auro-background` | Themed background wrapper |\n| `<auro-backtotop>` | `@aurodesignsystem/auro-backtotop` | Scroll-to-top button |\n| `<auro-badge>` | `@aurodesignsystem/auro-badge` | Status or count badge |\n| `<auro-banner>` | `@aurodesignsystem/auro-banner` | Full-width promotional banner |\n| `<auro-button>` | `@aurodesignsystem/auro-button` | Interactive button; supports `loading`, `disabled`, `shape` |\n| `<auro-card>` | `@aurodesignsystem/auro-card` | Content card container |\n| `<auro-carousel>` | `@aurodesignsystem/auro-carousel` | Horizontally scrollable carousel |\n| `<auro-datetime>` | `@aurodesignsystem/auro-datetime` | Localized date and time formatting |\n| `<auro-dialog>` | `@aurodesignsystem/auro-dialog` | Modal dialog; slots: header, content, footer |\n| `<auro-drawer>` | `@aurodesignsystem/auro-drawer` | Slide-in panel; slots: header, content, footer |\n| `<auro-flight>` | `@aurodesignsystem/auro-flight` | Flight segment display (origin, destination, stops) |\n| `<auro-flightline>` | `@aurodesignsystem/auro-flightline` | Visual flight path/stop indicator |\n| `<auro-input>` | `@aurodesignsystem/auro-formkit` | Text input field |\n| `<auro-select>` | `@aurodesignsystem/auro-formkit` | Select/dropdown |\n| `<auro-datepicker>` | `@aurodesignsystem/auro-formkit` | Date picker input |\n| `<auro-combobox>` | `@aurodesignsystem/auro-formkit` | Combobox with search |\n| `<auro-checkbox>` | `@aurodesignsystem/auro-formkit` | Checkbox input |\n| `<auro-radio>` | `@aurodesignsystem/auro-formkit` | Radio button input |\n| `<auro-header>` | `@aurodesignsystem/auro-header` | Page/section heading |\n| `<auro-hyperlink>` | `@aurodesignsystem/auro-hyperlink` | Accessible anchor link |\n| `<auro-icon>` | `@aurodesignsystem/auro-icon` | Alaska Airlines icon: `category` + `name` attributes |\n| `<auro-loader>` | `@aurodesignsystem/auro-loader` | Loading spinner |\n| `<auro-lockup>` | `@aurodesignsystem/auro-lockup` | Image + text layout lockup |\n| `<auro-nav>` | `@aurodesignsystem/auro-nav` | Secondary navigation aid (relation to higher-level pages) |\n| `<auro-pane>` | `@aurodesignsystem/auro-pane` | Selectable shoulder dates with associated prices |\n| `<auro-popover>` | `@aurodesignsystem/auro-popover` | Tooltip-style popover |\n| `<auro-sidenav>` | `@aurodesignsystem/auro-sidenav` | Vertical side navigation |\n| `<auro-skeleton>` | `@aurodesignsystem/auro-skeleton` | Loading placeholder skeleton |\n| `<auro-slideshow>` | `@aurodesignsystem/auro-slideshow` | Image/content slideshow |\n| `<auro-table>` | `@aurodesignsystem/auro-table` | Accessible data table |\n| `<auro-tabs>` | `@aurodesignsystem/auro-tabs` | Tabbed content panels |\n| `<auro-tail>` | `@aurodesignsystem/auro-tail` | Alaska, Hawaiian, and partner airline tail graphics |\n| `<auro-toast>` | `@aurodesignsystem/auro-toast` | Transient notification toast |\n| `<auro-tokenlist>` | `@aurodesignsystem/auro-tokenlist` | Design token display utilities |\n\n## Common Patterns\n\n### Button (default, secondary, tertiary)\n```html\n<auro-button>Primary</auro-button>\n<auro-button variant="secondary">Secondary</auro-button>\n<auro-button variant="tertiary">Tertiary</auro-button>\n<auro-button loading>Saving...</auro-button>\n```\n\n### Alert\n```html\n<auro-alert type="success">Changes saved.</auro-alert>\n<auro-alert type="error">Something went wrong.</auro-alert>\n<auro-alert type="warning">Please review before continuing.</auro-alert>\n<auro-alert type="information">Your flight departs at 9am.</auro-alert>\n```\n\n### Form inputs (auro-formkit)\nauro-formkit has no root export \u2014 always import the specific sub-component.\nThe field label is a **slot**, not an attribute.\n```js\nimport "@aurodesignsystem/auro-formkit/auro-input";\nimport "@aurodesignsystem/auro-formkit/auro-select";\n```\n```html\n<auro-input required>\n  <span slot="label">First name</span>\n</auro-input>\n<auro-select>\n  <span slot="label">Seat preference</span>\n  <auro-menu>\n    <auro-menuoption value="window">Window</auro-menuoption>\n    <auro-menuoption value="aisle">Aisle</auro-menuoption>\n  </auro-menu>\n</auro-select>\n```\n\n### Icon\nSet `category` and `name`. Icon names are exact \u2014 check the icon library for the correct name.\n```html\n<auro-icon category="interface" name="arrow-right"></auro-icon>\n<auro-icon category="terminal" name="plane-side-fill"></auro-icon>\n```\n\n### Hyperlink\n```html\n<auro-hyperlink href="/flights">View flights</auro-hyperlink>\n<auro-hyperlink href="https://example.com" target="_blank">External link</auro-hyperlink>\n```\n\n### Dialog (modal)\n```js\ndocument.querySelector(\'#confirmDialog\').show();\n```\n```html\n<auro-dialog id="confirmDialog">\n  <span slot="header">Confirm booking</span>\n  <div slot="content">Are you sure you want to book this flight?</div>\n  <div slot="footer">\n    <auro-button>Confirm</auro-button>\n    <auro-button variant="secondary">Cancel</auro-button>\n  </div>\n</auro-dialog>\n```\n\n## Accessibility Notes\n- Use the `ariaLabel` slot on `<auro-button>` for icon-only buttons\n- `<auro-hyperlink>` adds rel="noopener noreferrer" automatically for external links\n- All `auro-formkit` components handle aria-invalid and error messaging built-in\n- All components meet WCAG 2.1 AA\n\n## Documentation\n- Component docs: https://auro.alaskaair.com\n- Component status: https://auro.alaskaair.com/component-status\n- Design tokens: https://auro.alaskaair.com/getting-started/developers/token-usage\n- Contributing: https://auro.alaskaair.com/getting-started/developers/contributing\n- GitHub: https://github.com/AlaskaAirlines\n';var Sa=Lo.command("context").description("Generate an AI assistant context document for the Auro Design System").option("-o, --output <path>","Write context to a file instead of stdout (e.g. AURO_CONTEXT.md)").action(async r=>{if(r.output){let t=Ho(`Writing context to ${r.output}...`).start();try{let e=Go.resolve(process.cwd(),r.output);await Bo.writeFile(e,Ue,"utf-8"),t.succeed(`Auro context written to ${r.output}`),console.log(`
 Paste this file into your AI coding tool (Claude, Cursor, Copilot, etc.) to prime it on Auro components.`)}catch(e){let o=e instanceof Error?e.message:String(e);t.fail(`Failed to write context: ${o}`),process.exit(1)}}else process.stdout.write(Ue)});import{program as Uo}from"commander";var We=Uo.command("docs").description("Generate API documentation").option("-c, --cem","Generate Custom Elements Manifest (CEM) file",!1).option("-a, --api","Creates api md file from CEM",!1).option("-w, --watch","Watch for changes and rebuild docs",!1).option("-r, --readme-template <url>","URL to the README template file").option("--skip-readme","Skip README.md processing",!1);We=Z(We);var Pa=We.action(async r=>{r.cem&&await ne(),r.api&&await se(),await st(r),r.serve&&await it(r),r.watch&&await at(r)});import{program as Jo}from"commander";import{Octokit as qe}from"@octokit/rest";import*as ge from"azure-devops-node-api";import fe from"ora";var Wo=async r=>{let t=process.env.GH_TOKEN;if(!t)throw new Error("GH_TOKEN environment variable is required");let e=new qe({auth:t}),o,n,s;if(r.includes("github.com")){let a=r.match(/github\.com\/([^\/]+)\/([^\/]+)\/issues\/(\d+)/);if(!a)throw new Error("Invalid GitHub issue URL format");[,o,n,s]=a}else if(r.includes("#")){let a=r.match(/([^\/]+)\/([^#]+)#(\d+)/);if(!a)throw new Error("Invalid GitHub issue reference format");[,o,n,s]=a}else throw new Error("Issue must be provided as full URL or in format 'owner/repo#number'");let i=Number.parseInt(s,10);try{let{data:a}=await e.rest.issues.get({owner:o,repo:n,issue_number:i});return{title:a.title,body:a.body??null,html_url:a.html_url,number:a.number,repository:{owner:{login:o},name:n}}}catch(a){throw new Error(`Failed to fetch GitHub issue: ${a}`)}},qo=async r=>{let t=process.env.GH_TOKEN;if(!t)return null;let e=new qe({auth:t});try{let o=`
       query($owner: String!, $repo: String!, $issueNumber: Int!) {
         repository(owner: $owner, name: $repo) {