@lukso/web-components 1.186.0 → 1.188.0

package/dist/scripts/llm/cem.d.ts

@@ -0,0 +1,60 @@
+/**
+ * cem.ts
+ *
+ * Loads and queries the Custom Elements Manifest (package/custom-elements.json).
+ * Provides typed interfaces for CEM declarations and helpers to extract
+ * Lukso class declarations and tag names from component source files.
+ */
+export interface CemMember {
+    kind: string;
+    name: string;
+    type?: {
+        text: string;
+    };
+    default?: string;
+    attribute?: string;
+    description?: string;
+    privacy?: string;
+    static?: boolean;
+}
+export interface CemDeclaration {
+    kind: string;
+    name: string;
+    tagName?: string;
+    description?: string;
+    members?: CemMember[];
+    attributes?: {
+        name: string;
+        type?: {
+            text: string;
+        };
+        default?: string;
+        description?: string;
+    }[];
+    events?: {
+        name: string;
+        type?: {
+            text: string;
+        };
+        description?: string;
+    }[];
+    slots?: {
+        name: string;
+        description?: string;
+    }[];
+}
+export interface CemModule {
+    kind: string;
+    path: string;
+    declarations?: CemDeclaration[];
+}
+/** Load the Custom Elements Manifest from package/custom-elements.json */
+export declare function loadCem(root: string): CemModule[];
+/** Return all Lukso class declarations with their parent module */
+export declare function getClassDeclarations(modules: CemModule[]): {
+    module: CemModule;
+    decl: CemDeclaration;
+}[];
+/** Extract the custom element tag name from a component source file */
+export declare function getTagName(source: string): string;
+//# sourceMappingURL=cem.d.ts.map

package/dist/scripts/llm/cem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cem.d.ts","sourceRoot":"","sources":["../../../../scripts/llm/cem.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACvB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,SAAS,EAAE,CAAA;IACrB,UAAU,CAAC,EAAE;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;QACvB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,EAAE,CAAA;IACH,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC1E,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CACjD;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,CAAC,EAAE,cAAc,EAAE,CAAA;CAChC;AAED,0EAA0E;AAC1E,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CAIjD;AAED,mEAAmE;AACnE,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,EAAE,GACnB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,EAAE,CAW/C;AAED,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGjD"}

package/dist/scripts/llm/component-doc.d.ts

@@ -0,0 +1,28 @@
+import { CemMember } from './cem.js';
+/** Extract the JSDoc block immediately before a class declaration (identified by markerPattern) */
+export declare function extractJsDoc(source: string, markerPattern: RegExp): string;
+/** Parse @fires tags from a JSDoc string */
+export declare function parseFiresTags(jsdoc: string): {
+    event: string;
+    detail: string;
+    bubbles: string;
+    description: string;
+}[];
+/** Parse @slot tags from a JSDoc string */
+export declare function parseSlotTags(jsdoc: string): {
+    name: string;
+    description: string;
+}[];
+/** Strip @fires/@slot tags from a JSDoc string and return the prose description only. */
+export declare function extractProse(jsdoc: string): string;
+/**
+ * Build a ## Types section listing types referenced in the attributes table.
+ * Looks up definitions from the component source and shared types.ts.
+ * Pass pre-loaded sharedTypesSrc to avoid re-reading the file per component.
+ */
+export declare function buildTypesSection(members: CemMember[], componentSrc: string, sharedTypesSrc: string): string;
+/** Build the ## Attributes markdown table from CEM members */
+export declare function buildAttributesTable(members: CemMember[]): string;
+/** Build the full markdown doc for a single component */
+export declare function buildComponentDoc(tagName: string, jsdoc: string, members: CemMember[], componentSrc: string, sharedTypesSrc: string, root: string): string;
+//# sourceMappingURL=component-doc.d.ts.map

package/dist/scripts/llm/component-doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-doc.d.ts","sourceRoot":"","sources":["../../../../scripts/llm/component-doc.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAKzC,mGAAmG;AACnG,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAiB1E;AAED,4CAA4C;AAC5C,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,GACZ;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAAE,CAc3E;AAED,2CAA2C;AAC3C,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,GACZ;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAAE,CAUzC;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlD;AAmDD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,EAAE,EACpB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,GACrB,MAAM,CAkBR;AAYD,8DAA8D;AAC9D,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,CAqBjE;AAID,yDAAyD;AACzD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,EAAE,EACpB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,GACX,MAAM,CAwDR"}

package/dist/scripts/llm/stories.d.ts

@@ -0,0 +1,14 @@
+/**
+ * stories.ts
+ *
+ * Extracts usage examples from Storybook story files (*.stories.ts).
+ * Parses story args, renders Lit html`` templates into plain HTML snippets,
+ * and extracts per-story JSDoc descriptions for inclusion in component docs.
+ */
+/**
+ * Extract usage examples from a component's `*.stories.ts` file.
+ * Parses meta.args, argTypes, and named story exports statically (no DOM needed).
+ * Returns a markdown ```html code block with one entry per story.
+ */
+export declare function extractStoriesExamples(tagName: string, root: string): string;
+//# sourceMappingURL=stories.d.ts.map

package/dist/scripts/llm/stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stories.d.ts","sourceRoot":"","sources":["../../../../scripts/llm/stories.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiMH;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CA6F5E"}

package/dist/scripts/llm/tailwind.d.ts

@@ -0,0 +1,26 @@
+/**
+ * tailwind.ts
+ *
+ * Generates markdown documentation for Tailwind utility classes and icon packs.
+ * Sources: tailwind-config.ts (colors/shadows), typography-v4.css, Animations/DropShadows
+ * story files, and the lukso-icon component's icon directories.
+ */
+/** Generate the Colors section: color families and their available lightness values. */
+export declare function generateColorsDoc(root: string): string;
+/** Generate the Typography section: heading, nav, and paragraph classes parsed from typography-v4.css. */
+export declare function generateTypographyDoc(root: string): string;
+/** Generate the Shadows section: shadow classes grouped by prefix, parsed from DropShadows.stories.ts. */
+export declare function generateShadowsDoc(root: string): string;
+/** Generate the Animations section: animation classes and utility modifiers parsed from Animations.stories.ts. */
+export declare function generateAnimationsDoc(root: string): string;
+/** Generate the Other Utilities section: border radius tokens and extra spacing values. */
+export declare function generateOtherDoc(): string;
+/** Generate the Custom Icons section: icon names discovered from the icons/ directory. */
+export declare function generateCustomIconsDoc(root: string): string;
+/** Generate the Vuesax Icons section: availability grid (✅/❌) per icon and variant, scanned from the vuesax/ directory. */
+export declare function generateVuesaxIconsDoc(root: string): string;
+/** Return all Tailwind utility class docs as a single concatenated string. */
+export declare function generateTailwindDocs(root: string): string;
+/** Return custom and Vuesax icon docs as a single concatenated string. */
+export declare function generateIconDocs(root: string): string;
+//# sourceMappingURL=tailwind.d.ts.map

package/dist/scripts/llm/tailwind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailwind.d.ts","sourceRoot":"","sources":["../../../../scripts/llm/tailwind.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,wFAAwF;AACxF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA2CtD;AAID,0GAA0G;AAC1G,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAuE1D;AAID,0GAA0G;AAC1G,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmCvD;AAID,kHAAkH;AAClH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoD1D;AAID,2FAA2F;AAC3F,wBAAgB,gBAAgB,IAAI,MAAM,CAmBzC;AAID,0FAA0F;AAC1F,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAgC3D;AAED,2HAA2H;AAC3H,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAkD3D;AAID,8EAA8E;AAC9E,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQzD;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/scripts/llm/utils.d.ts

@@ -0,0 +1,12 @@
+/**
+ * utils.ts
+ *
+ * Filesystem helpers used by the LLM doc generation scripts.
+ */
+/** Read a file as UTF-8 text; throws if the file does not exist. */
+export declare function read(filePath: string): string;
+/** Read a file as UTF-8 text; returns an empty string if the file does not exist. */
+export declare function readSafe(filePath: string): string;
+/** Write content to a file, creating parent directories as needed. */
+export declare function write(filePath: string, content: string): void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/scripts/llm/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../scripts/llm/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,oEAAoE;AACpE,wBAAgB,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,qFAAqF;AACrF,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED,sEAAsE;AACtE,wBAAgB,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,QAGtD"}