@preply/ds-ai-core 11.1.0

package/dist/tools/components/__tests__/get-component-docs.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=get-component-docs.test.d.ts.map

package/dist/tools/components/__tests__/get-component-docs.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-component-docs.test.d.ts","sourceRoot":"","sources":["../../../../src/tools/components/__tests__/get-component-docs.test.ts"],"names":[],"mappings":""}

package/dist/tools/components/__tests__/list-components.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=list-components.test.d.ts.map

package/dist/tools/components/__tests__/list-components.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-components.test.d.ts","sourceRoot":"","sources":["../../../../src/tools/components/__tests__/list-components.test.ts"],"names":[],"mappings":""}

package/dist/tools/components/context/__test__/get-components-data.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=get-components-data.test.d.ts.map

package/dist/tools/components/context/__test__/get-components-data.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-components-data.test.d.ts","sourceRoot":"","sources":["../../../../../src/tools/components/context/__test__/get-components-data.test.ts"],"names":[],"mappings":""}

package/dist/tools/components/context/__test__/test-components/FixtureButton.d.ts

@@ -0,0 +1,15 @@
+import { default as React } from 'react';
+export type FixtureButtonProps = {
+    /** Visible button label */
+    label: string;
+    /** Disabled state */
+    disabled?: boolean;
+};
+/**
+ * Lightweight fixture component used in docs generation tests.
+ *
+ * @example
+ * <FixtureButton label="Save" />
+ */
+export declare const FixtureButton: ({ label, disabled }: FixtureButtonProps) => React.JSX.Element;
+//# sourceMappingURL=FixtureButton.d.ts.map

package/dist/tools/components/context/__test__/test-components/FixtureButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FixtureButton.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/components/context/__test__/test-components/FixtureButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,MAAM,kBAAkB,GAAG;IAC7B,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,wBAAiC,kBAAkB,sBAE5E,CAAC"}

package/dist/tools/components/context/__test__/test-components/index.d.ts

@@ -0,0 +1,2 @@
+export { FixtureButton } from './FixtureButton';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/components/context/__test__/test-components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/components/context/__test__/test-components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/tools/components/context/extract-component-docgen-info.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from 'react-docgen-typescript';
+export declare function extractDocgenInfo(entry: string, ignoreErrors?: (string | RegExp)[]): ComponentDoc[];
+//# sourceMappingURL=extract-component-docgen-info.d.ts.map

package/dist/tools/components/context/extract-component-docgen-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-component-docgen-info.d.ts","sourceRoot":"","sources":["../../../../src/tools/components/context/extract-component-docgen-info.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAuB,MAAM,yBAAyB,CAAC;AAgC5E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,GAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAO,kBAwEtF"}

package/dist/tools/components/context/get-components-data.d.ts

@@ -0,0 +1,24 @@
+export type Entry = {
+    importPath: string;
+    entrypoint: string;
+    ignoreErrors?: (string | RegExp)[];
+};
+export type ComponentMeta = {
+    name: string;
+    import: string;
+    description: string;
+    deprecated?: boolean;
+};
+export type ComponentInfo = {
+    meta: ComponentMeta;
+    docs: string;
+};
+export type ComponentsMap = Record<string, ComponentInfo>;
+type PlatformComponents = {
+    web: ComponentsMap;
+    'react-native': ComponentsMap;
+};
+export declare function buildComponents(entries: Entry[]): ComponentsMap;
+export declare function getComponentsData(): PlatformComponents;
+export {};
+//# sourceMappingURL=get-components-data.d.ts.map

package/dist/tools/components/context/get-components-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-components-data.d.ts","sourceRoot":"","sources":["../../../../src/tools/components/context/get-components-data.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,KAAK,GAAG;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAE1D,KAAK,kBAAkB,GAAG;IACtB,GAAG,EAAE,aAAa,CAAC;IACnB,cAAc,EAAE,aAAa,CAAC;CACjC,CAAC;AAEF,wBAAgB,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,aAAa,CA0B/D;AAID,wBAAgB,iBAAiB,IAAI,kBAAkB,CAkCtD"}

package/dist/tools/components/context/index.d.ts

@@ -0,0 +1,6 @@
+declare const _default: {
+    web: import('./get-components-data').ComponentsMap;
+    'react-native': import('./get-components-data').ComponentsMap;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/components/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/components/context/index.ts"],"names":[],"mappings":";;;;AAGA,wBAAmC"}

package/dist/tools/components/context/render-component-doc.d.ts

@@ -0,0 +1,4 @@
+import { ComponentDoc } from 'react-docgen-typescript';
+export declare function renderComponentDoc(docgenInfo: ComponentDoc, importPath: string): string;
+export declare function renderImportExample(docgenInfo: ComponentDoc, importPath: string): string;
+//# sourceMappingURL=render-component-doc.d.ts.map

package/dist/tools/components/context/render-component-doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-component-doc.d.ts","sourceRoot":"","sources":["../../../../src/tools/components/context/render-component-doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAY,MAAM,yBAAyB,CAAC;AAGjE,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAU9E;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAG/E"}

package/dist/tools/components/get-component-docs.d.ts

@@ -0,0 +1,15 @@
+import * as z from 'zod';
+export declare const getComponentDocs: import('../../utils/define-tool').Tool<z.ZodObject<{
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+}, {
+    name: string;
+}>, z.ZodObject<{
+    platform: z.ZodEnum<["web", "react-native"]>;
+}, "strip", z.ZodTypeAny, {
+    platform: "web" | "react-native";
+}, {
+    platform: "web" | "react-native";
+}>>;
+//# sourceMappingURL=get-component-docs.d.ts.map

package/dist/tools/components/get-component-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-component-docs.d.ts","sourceRoot":"","sources":["../../../src/tools/components/get-component-docs.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;GAoB3B,CAAC"}

package/dist/tools/components/list-components.d.ts

@@ -0,0 +1,9 @@
+import * as z from 'zod';
+export declare const listComponents: import('../../utils/define-tool').Tool<never, z.ZodObject<{
+    platform: z.ZodEnum<["web", "react-native"]>;
+}, "strip", z.ZodTypeAny, {
+    platform: "web" | "react-native";
+}, {
+    platform: "web" | "react-native";
+}>>;
+//# sourceMappingURL=list-components.d.ts.map

package/dist/tools/components/list-components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-components.d.ts","sourceRoot":"","sources":["../../../src/tools/components/list-components.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAIzB,eAAO,MAAM,cAAc;;;;;;GA4BzB,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,6 @@
+export { searchIcon } from './search-icon/search-icon';
+export { searchTokenByName } from './search-token/search-token-by-name';
+export { searchTokenByValue } from './search-token/search-token-by-value';
+export { listComponents } from './components/list-components';
+export { getComponentDocs } from './components/get-component-docs';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/tools/search-icon/__tests__/get-icons-data.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=get-icons-data.test.d.ts.map

package/dist/tools/search-icon/__tests__/get-icons-data.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-icons-data.test.d.ts","sourceRoot":"","sources":["../../../../src/tools/search-icon/__tests__/get-icons-data.test.ts"],"names":[],"mappings":""}

package/dist/tools/search-icon/__tests__/search-icon.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=search-icon.test.d.ts.map

package/dist/tools/search-icon/__tests__/search-icon.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-icon.test.d.ts","sourceRoot":"","sources":["../../../../src/tools/search-icon/__tests__/search-icon.test.ts"],"names":[],"mappings":""}

package/dist/tools/search-icon/get-icons-data.d.ts

@@ -0,0 +1,6 @@
+export declare function getIconsData(iconsDirname?: string): {
+    web: string;
+    'react-native': string;
+}[];
+export type Icon = ReturnType<typeof getIconsData>[number];
+//# sourceMappingURL=get-icons-data.d.ts.map

package/dist/tools/search-icon/get-icons-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-icons-data.d.ts","sourceRoot":"","sources":["../../../src/tools/search-icon/get-icons-data.ts"],"names":[],"mappings":"AAMA,wBAAgB,YAAY,CAAC,YAAY,SAAgB;;;IAUxD;AAED,MAAM,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/tools/search-icon/search-icon.d.ts

@@ -0,0 +1,18 @@
+import * as z from 'zod';
+export declare const searchIcon: import('../../utils/define-tool').Tool<z.ZodObject<{
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+}, {
+    name: string;
+}>, z.ZodObject<{
+    platform: z.ZodEnum<["web", "react-native"]>;
+    includeExample: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    platform: "web" | "react-native";
+    includeExample: boolean;
+}, {
+    platform: "web" | "react-native";
+    includeExample?: boolean | undefined;
+}>>;
+//# sourceMappingURL=search-icon.d.ts.map

package/dist/tools/search-icon/search-icon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-icon.d.ts","sourceRoot":"","sources":["../../../src/tools/search-icon/search-icon.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAyCzB,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;GAmDrB,CAAC"}

package/dist/tools/search-token/__tests__/search-token-by-name.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=search-token-by-name.test.d.ts.map

package/dist/tools/search-token/__tests__/search-token-by-name.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-token-by-name.test.d.ts","sourceRoot":"","sources":["../../../../src/tools/search-token/__tests__/search-token-by-name.test.ts"],"names":[],"mappings":""}

package/dist/tools/search-token/__tests__/search-token-by-value.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=search-token-by-value.test.d.ts.map

package/dist/tools/search-token/__tests__/search-token-by-value.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-token-by-value.test.d.ts","sourceRoot":"","sources":["../../../../src/tools/search-token/__tests__/search-token-by-value.test.ts"],"names":[],"mappings":""}

package/dist/tools/search-token/context/__tests__/get-tokens-data.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=get-tokens-data.test.d.ts.map

package/dist/tools/search-token/context/__tests__/get-tokens-data.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-tokens-data.test.d.ts","sourceRoot":"","sources":["../../../../../src/tools/search-token/context/__tests__/get-tokens-data.test.ts"],"names":[],"mappings":""}

package/dist/tools/search-token/context/get-tokens-data.d.ts

@@ -0,0 +1,13 @@
+import { Platform } from '../../../types';
+export type TokenData = {
+    name: string;
+    scss: string;
+    less: string;
+    typescript: string;
+    value: string | number;
+    private: boolean;
+};
+type PlatformTokens = Record<Platform, TokenData[]>;
+export declare function getTokensData(): PlatformTokens;
+export {};
+//# sourceMappingURL=get-tokens-data.d.ts.map

package/dist/tools/search-token/context/get-tokens-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-tokens-data.d.ts","sourceRoot":"","sources":["../../../../src/tools/search-token/context/get-tokens-data.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AA8E1C,MAAM,MAAM,SAAS,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,KAAK,cAAc,GAAG,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;AAEpD,wBAAgB,aAAa,IAAI,cAAc,CAU9C"}

package/dist/tools/search-token/context/index.d.ts

@@ -0,0 +1,6 @@
+declare const _default: {
+    web: import('./get-tokens-data').TokenData[];
+    "react-native": import('./get-tokens-data').TokenData[];
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/search-token/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/search-token/context/index.ts"],"names":[],"mappings":";;;;AAGA,wBAA+B"}

package/dist/tools/search-token/search-token-by-name.d.ts

@@ -0,0 +1,26 @@
+import { Format } from './token-utils';
+import * as z from 'zod';
+export type { Format };
+export declare const searchTokenByName: import('../../utils/define-tool').Tool<z.ZodObject<{
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+}, {
+    name: string;
+}>, z.ZodObject<{
+    platform: z.ZodEnum<["web", "react-native"]>;
+    format: z.ZodDefault<z.ZodOptional<z.ZodEnum<["scss", "less", "typescript"]>>>;
+    includeExample: z.ZodDefault<z.ZodBoolean>;
+    includePrivate: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    platform: "web" | "react-native";
+    includeExample: boolean;
+    format: "scss" | "less" | "typescript";
+    includePrivate: boolean;
+}, {
+    platform: "web" | "react-native";
+    includeExample?: boolean | undefined;
+    format?: "scss" | "less" | "typescript" | undefined;
+    includePrivate?: boolean | undefined;
+}>>;
+//# sourceMappingURL=search-token-by-name.d.ts.map

package/dist/tools/search-token/search-token-by-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-token-by-name.d.ts","sourceRoot":"","sources":["../../../src/tools/search-token/search-token-by-name.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAIzB,OAAO,EAAE,MAAM,EAA2B,MAAM,eAAe,CAAC;AAEhE,YAAY,EAAE,MAAM,EAAE,CAAC;AAoBvB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;GA+E5B,CAAC"}

package/dist/tools/search-token/search-token-by-value.d.ts

@@ -0,0 +1,24 @@
+import * as z from 'zod';
+export declare const searchTokenByValue: import('../../utils/define-tool').Tool<z.ZodObject<{
+    value: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+}, {
+    value: string;
+}>, z.ZodObject<{
+    platform: z.ZodEnum<["web", "react-native"]>;
+    format: z.ZodDefault<z.ZodOptional<z.ZodEnum<["scss", "less", "typescript"]>>>;
+    includeExample: z.ZodDefault<z.ZodBoolean>;
+    includePrivate: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    platform: "web" | "react-native";
+    includeExample: boolean;
+    format: "scss" | "less" | "typescript";
+    includePrivate: boolean;
+}, {
+    platform: "web" | "react-native";
+    includeExample?: boolean | undefined;
+    format?: "scss" | "less" | "typescript" | undefined;
+    includePrivate?: boolean | undefined;
+}>>;
+//# sourceMappingURL=search-token-by-value.d.ts.map

package/dist/tools/search-token/search-token-by-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-token-by-value.d.ts","sourceRoot":"","sources":["../../../src/tools/search-token/search-token-by-value.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAuCzB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;GA8D7B,CAAC"}

package/dist/tools/search-token/token-utils.d.ts

@@ -0,0 +1,9 @@
+import { TokenData } from './context/get-tokens-data';
+import { Platform } from '../../types';
+export type Format = 'scss' | 'less' | 'typescript';
+export declare function formatToken(token: TokenData, platform: Platform, format: Format): {
+    token: string;
+    value: string | number;
+};
+export declare function getExample(platform: Platform, format: Format): string;
+//# sourceMappingURL=token-utils.d.ts.map

package/dist/tools/search-token/token-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-utils.d.ts","sourceRoot":"","sources":["../../../src/tools/search-token/token-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC;AAEpD,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM;;;EAK/E;AA8CD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,UAE5D"}

package/dist/types.d.ts

@@ -0,0 +1,3 @@
+export type Platform = 'web' | 'react-native';
+export declare const PLATFORMS: ["web", "react-native"];
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,cAAc,CAAC;AAE9C,eAAO,MAAM,SAAS,yBAAwD,CAAC"}

package/dist/utils/create-search-index.d.ts

@@ -0,0 +1,48 @@
+type Result<T> = {
+    item: T;
+    /** Whether the query matched a ref exactly (as opposed to a fuzzy/partial match). */
+    exact: boolean;
+};
+/**
+ * Extracts only the keys of T whose values are strings.
+ * Used to constrain `ref` so it always points to a string field.
+ */
+type StringKeys<T extends Record<string, unknown>, K = keyof T> = K extends string ? T[K] extends string ? K : never : never;
+/**
+ * Builds a lunr full-text search index over `items` and returns a thin wrapper
+ * with `search` (ranked results) and `get` (exact lookup) methods.
+ *
+ * @param items   - The dataset to index.
+ * @param ref     - Which string field to use as the unique document key.
+ * @param normalize - Optional transform applied to both stored refs and incoming
+ *                    queries so that e.g. case or naming-convention differences
+ *                    don't prevent matches. When provided, a custom pipeline
+ *                    function is also registered to split compound tokens.
+ */
+export declare function createSearchIndex<T extends Record<string, unknown>>(
+/** The dataset to index. */
+items: T[], options: {
+    /** The field to use as the unique document key. */
+    ref: StringKeys<T>;
+    /** An optional transform applied to both stored refs and incoming queries */
+    normalize?: (term: string) => string;
+}): {
+    /**
+     * Performs a full-text search over the indexed items.
+     *
+     * @example
+     * ```ts
+     * const results = index.search('dropShadow-1-shorthand');
+     * console.log(results);
+     * // [
+     * //   { item: { name: 'dropShadow-1-shorthand' }, exact: true },
+     * //   { item: { name: 'dropShadow-1-shorthand' }, exact: false },
+     * // ]
+     * ```
+     */
+    search(query: string, limit?: number): Result<T>[];
+    /** Direct lookup by normalized ref value. Returns undefined if not found. */
+    get(query: string): T | undefined;
+};
+export {};
+//# sourceMappingURL=create-search-index.d.ts.map

package/dist/utils/create-search-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-search-index.d.ts","sourceRoot":"","sources":["../../src/utils/create-search-index.ts"],"names":[],"mappings":"AAOA,KAAK,MAAM,CAAC,CAAC,IAAI;IACb,IAAI,EAAE,CAAC,CAAC;IACR,qFAAqF;IACrF,KAAK,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,KAAK,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,MAAM,GAC5E,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GACf,CAAC,GACD,KAAK,GACT,KAAK,CAAC;AAEZ;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;AAC/D,4BAA4B;AAC5B,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,EAAE;IACL,mDAAmD;IACnD,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACnB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACxC;IAiDG;;;;;;;;;;;;OAYG;kBACW,MAAM,UAAU,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE;IAWlD,6EAA6E;eAClE,MAAM,GAAG,CAAC,GAAG,SAAS;EAIxC"}

package/dist/utils/define-tool.d.ts

@@ -0,0 +1,49 @@
+import * as z from 'zod';
+/**
+ * Resolves callback parameter types based on which schemas a tool defines.
+ * Uses `[T] extends [never]` (wrapped in tuple) instead of `T extends never`
+ * to prevent TypeScript from collapsing the conditional via distributive behavior.
+ *
+ * - Both Arguments and Options are `never` -> callback takes no parameters
+ * - Only Options defined                   -> callback takes parsed Options
+ * - Only Arguments defined                 -> callback takes parsed Arguments
+ * - Both defined                           -> callback takes merged Arguments & Options
+ */
+type CallbackParameters<Arguments extends z.AnyZodObject = never, Options extends z.AnyZodObject = never> = [Arguments] extends [never] ? [Options] extends [never] ? [] : [z.input<Options>] : [Options] extends [never] ? [z.input<Arguments>] : [z.input<Arguments> & z.input<Options>];
+/**
+ * Shape of a single AI tool definition.
+ *
+ * A tool has a CLI-style interface with positional `arguments` and named
+ * `options`, both validated at runtime via Zod schemas. The `callback`
+ * receives the parsed (and type-safe) values and must return an array of
+ * output lines that are surfaced to the calling agent.
+ */
+export type Tool<Arguments extends z.AnyZodObject = never, Options extends z.AnyZodObject = never> = {
+    /** The tool name. Used when using as MCP tool. */
+    name: string;
+    /** The tool description. Used when using as MCP tool and displayed as a help message to CLI command. */
+    description: string;
+    /** Positional arguments schema. Omit if the tool takes no positional args. */
+    arguments?: Arguments;
+    /** Named options/flags schema. Omit if the tool takes no options. */
+    options?: Options;
+    /** Executes the tool logic; returns output lines shown to the agent. */
+    callback: (...args: CallbackParameters<Arguments, Options>) => string[];
+};
+/**
+ * Identity helper that infers the generic types from the tool object literal,
+ * giving full type-safety on `callback` params without manual type annotations.
+ *
+ * @example
+ * ```ts
+ * const myTool = defineTool({
+ *     name: 'greet',
+ *     description: 'Say hello',
+ *     arguments: z.object({ name: z.string() }),
+ *     callback: (args) => [`Hello, ${args.name}!`], // args is typed automatically
+ * });
+ * ```
+ */
+export declare function defineTool<Arguments extends z.AnyZodObject = never, Options extends z.AnyZodObject = never>(tool: Tool<Arguments, Options>): Tool<Arguments, Options>;
+export {};
+//# sourceMappingURL=define-tool.d.ts.map

package/dist/utils/define-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-tool.d.ts","sourceRoot":"","sources":["../../src/utils/define-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB;;;;;;;;;GASG;AACH,KAAK,kBAAkB,CACnB,SAAS,SAAS,CAAC,CAAC,YAAY,GAAG,KAAK,EACxC,OAAO,SAAS,CAAC,CAAC,YAAY,GAAG,KAAK,IACtC,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,GACzB,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,GACrB,EAAE,GACF,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GACtB,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,GACvB,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,GACpB,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;AAEhD;;;;;;;GAOG;AACH,MAAM,MAAM,IAAI,CACZ,SAAS,SAAS,CAAC,CAAC,YAAY,GAAG,KAAK,EACxC,OAAO,SAAS,CAAC,CAAC,YAAY,GAAG,KAAK,IACtC;IACA,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,wGAAwG;IACxG,WAAW,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wEAAwE;IACxE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,kBAAkB,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC;CAC3E,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CACtB,SAAS,SAAS,CAAC,CAAC,YAAY,GAAG,KAAK,EACxC,OAAO,SAAS,CAAC,CAAC,YAAY,GAAG,KAAK,EACxC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,4BAE/B"}

package/dist/utils/format-list.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Formats a list of objects into readable string.
+ *
+ * @example
+ * ```
+ * const list = [
+ *     { name: 'John', age: 30 },
+ *     { name: 'Jane', age: 25 },
+ * ];
+ * const formattedList = formatList(list);
+ * ```
+ *
+ * returns:
+ * ```
+ * ---
+ * name: John
+ * age: 30
+ * ---
+ * name: Jane
+ * age: 25
+ * ---
+ * ```
+ */
+export declare function formatList(list: unknown[]): string;
+export declare function formatListInline(list: unknown[]): string;
+//# sourceMappingURL=format-list.d.ts.map

package/dist/utils/format-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-list.d.ts","sourceRoot":"","sources":["../../src/utils/format-list.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,UAMzC;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,UAI/C"}

package/dist/utils/md.d.ts

@@ -0,0 +1,24 @@
+import * as tsmd from 'ts-markdown-builder';
+declare function frontMatter(object: Record<string, unknown>): string;
+export declare const md: {
+    frontMatter: typeof frontMatter;
+    comment: (comment: string) => string;
+    horizontalRule: "---";
+    heading: typeof tsmd.heading;
+    blockquote: typeof tsmd.blockquote;
+    orderedList: typeof tsmd.orderedList;
+    list: typeof tsmd.list;
+    codeBlock: typeof tsmd.codeBlock;
+    code: typeof tsmd.code;
+    italic: typeof tsmd.italic;
+    bold: typeof tsmd.bold;
+    link: typeof tsmd.link;
+    image: typeof tsmd.image;
+    table: typeof tsmd.table;
+    lineBreak: "<br/>";
+    disclosure: typeof tsmd.disclosure;
+    escape: typeof tsmd.escape;
+    joinBlocks: typeof tsmd.joinBlocks;
+};
+export {};
+//# sourceMappingURL=md.d.ts.map

package/dist/utils/md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"md.d.ts","sourceRoot":"","sources":["../../src/utils/md.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,qBAAqB,CAAC;AAG5C,iBAAS,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAM5D;AAED,eAAO,MAAM,EAAE;;uBAA8C,MAAM;;;;;;;;;;;;;;;;;CAA4B,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+    "name": "@preply/ds-ai-core",
+    "description": "Shared AI tools for the Preply Design System",
+    "version": "11.1.0",
+    "publishConfig": {
+        "access": "public"
+    },
+    "type": "module",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
+        }
+    },
+    "scripts": {
+        "clean": "rm -rf dist",
+        "check:types": "run --top-level tsc --noEmit",
+        "lint": "run --top-level eslint .",
+        "test": "run --top-level vitest --config ../../vitest.config.mts --watch=false packages/ai-core",
+        "test:watch": "run --top-level vitest --config ../../vitest.config.mts --watch=true packages/ai-core",
+        "build": "vite build",
+        "dev": "vite build --watch"
+    },
+    "devDependencies": {
+        "@preply/ds-core": "11.1.0",
+        "@preply/ds-theme-tokyo-ui": "11.1.0",
+        "@types/lunr": "^2.3.7",
+        "@types/node": "^24.12.0",
+        "front-matter": "^4.0.2",
+        "react-docgen-typescript": "^2.4.0",
+        "unplugin-macros": "^0.19.1",
+        "vite": "^8.0.0",
+        "vite-plugin-dts": "^4.5.4"
+    },
+    "dependencies": {
+        "dedent": "^1.7.0",
+        "env-paths": "^2.2.1",
+        "glob": "^13.0.0",
+        "kebab-case": "^2.0.2",
+        "lunr": "^2.3.9",
+        "posthog-node": "^5.28.6",
+        "ts-markdown-builder": "^0.5.0",
+        "yaml": "^2.8.1",
+        "zod": "^3.23.8",
+        "zod-opts": "^1.0.0"
+    },
+    "gitHead": "a5330f56c6c03a557b29efefcabacb41d67f4b63"
+}