@ladder-ui/manifests 0.10.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Ivan Avila
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/data/inventory.d.ts

@@ -0,0 +1 @@
+export declare const inventory: any;

package/dist/data/manifests.d.ts

@@ -0,0 +1,2 @@
+import type { ComponentManifest } from "../types";
+export declare const manifests: Record<string, ComponentManifest>;

package/dist/data/recipes.d.ts

@@ -0,0 +1 @@
+export declare const recipes: any;

package/dist/index.d.ts

@@ -0,0 +1,125 @@
+export type { ComponentManifest, ComponentEntry, PropEntry, SlotEntry, TokenEntry, EventEntry, EventsBlock, EventPayloadField, CssImports, ComponentCategory, TokenType, PropType, Inventory, PackageIndexEntry, RecipeEntry, RecipeNode, Recipe, } from "./types";
+import type { ComponentManifest, Inventory, Recipe } from "./types";
+/**
+ * The complete component inventory — categories, composition graph, and package index.
+ */
+export declare const inventory: Inventory;
+/**
+ * All component manifests indexed by package name (e.g. "button", "dialog").
+ */
+export declare const manifests: Record<string, ComponentManifest>;
+/**
+ * All recipes indexed by ID (e.g. "contact-form", "pricing-table").
+ */
+export declare const recipes: Record<string, Recipe>;
+/**
+ * Get a single component manifest by package name.
+ *
+ * @example
+ * ```ts
+ * const dialog = getManifest('dialog');
+ * dialog.props.DialogContent.placement.values
+ * // → ["top", "right", "bottom", "left", "center"]
+ * ```
+ */
+export declare function getManifest(packageName: string): ComponentManifest | undefined;
+/**
+ * Get all component names in a category.
+ *
+ * @example
+ * ```ts
+ * getComponentsByCategory('form')
+ * // → ["Calendar", "Checkbox", "Combobox", "Input", ...]
+ * ```
+ */
+export declare function getComponentsByCategory(category: string): string[];
+/**
+ * Get the valid children for a parent component from the composition graph.
+ *
+ * @example
+ * ```ts
+ * getValidChildren('Card')
+ * // → ["CardHeader", "CardContent", "CardFooter", ...]
+ * ```
+ */
+export declare function getValidChildren(parentComponent: string): string[];
+/**
+ * Check if a child component is valid inside a parent component.
+ *
+ * @example
+ * ```ts
+ * canContain('Card', 'CardHeader')  // → true
+ * canContain('Card', 'TabsList')    // → false
+ * ```
+ */
+export declare function canContain(parent: string, child: string): boolean;
+/**
+ * Find which manifest a component belongs to.
+ *
+ * @example
+ * ```ts
+ * findComponentPackage('DialogContent')
+ * // → { packageName: "dialog", manifest: ComponentManifest }
+ * ```
+ */
+export declare function findComponentPackage(componentName: string): {
+    packageName: string;
+    manifest: ComponentManifest;
+} | undefined;
+/**
+ * Get the props definition for a specific component.
+ *
+ * @example
+ * ```ts
+ * getComponentProps('Button')
+ * // → { variant: { type: "enum", values: [...], ... }, size: { ... }, ... }
+ * ```
+ */
+export declare function getComponentProps(componentName: string): Record<string, import("./types").PropEntry> | undefined;
+/**
+ * Get a recipe by ID. Returns undefined if not found.
+ *
+ * @example
+ * ```ts
+ * const recipe = getRecipe('contact-form');
+ * recipe.tree.component // → "Card"
+ * ```
+ */
+export declare function getRecipe(recipeId: string): Recipe | undefined;
+/**
+ * List all available recipe IDs and their descriptions.
+ *
+ * @example
+ * ```ts
+ * listRecipes()
+ * // → [{ id: "contact-form", description: "Contact form with...", tags: ["form", "landing"] }, ...]
+ * ```
+ */
+export declare function listRecipes(): Array<{
+    id: string;
+    description: string;
+    tags: string[];
+}>;
+/**
+ * Find recipes by tag.
+ *
+ * @example
+ * ```ts
+ * getRecipesByTag('dashboard')
+ * // → [{ id: "dashboard-stats", ... }, { id: "dashboard-table", ... }]
+ * ```
+ */
+export declare function getRecipesByTag(tag: string): Recipe[];
+/**
+ * Get all CSS imports required for a recipe (deduced from component tree).
+ *
+ * @example
+ * ```ts
+ * getRecipeImports('contact-form')
+ * // → { js: "import { Card, ... } from ...", css: ["@ladder-ui/card/card.css", ...] }
+ * ```
+ */
+export declare function getRecipeImports(recipeId: string): {
+    js: string[];
+    css: string[];
+} | undefined;