@nubase/core 0.1.14 → 0.1.16

package/dist/index.d.mts

@@ -28,9 +28,14 @@ interface SchemaMetadata<Output = any> {
     defaultValue?: Output;
     /**
      * Custom renderer identifier to override the default type-based rendering.
-     * Examples: "multiline", "email", "password", "url"
+     * Examples: "multiline", "email", "password", "url", "lookup"
      */
     renderer?: string;
+    /**
+     * When renderer is "lookup", this specifies which resource to use for the lookup.
+     * The resource must have a lookup endpoint configured.
+     */
+    lookupResource?: string;
     validateOnSubmit?: (value: any) => string | undefined;
     validateOnSubmitAsync?: (value: any) => Promise<string | undefined>;
     validateOnBlur?: (value: any) => string | undefined;
@@ -51,6 +56,18 @@ declare abstract class BaseSchema<Output = any> {
      * Used for type-based form field rendering.
      */
     abstract readonly type: string;
+    /**
+     * The base type of this schema, unwrapping any wrapper schemas (like OptionalSchema).
+     * For most schemas, this is the same as `type`. For wrapper schemas like OptionalSchema,
+     * this returns the type of the innermost wrapped schema.
+     */
+    get baseType(): string;
+    /**
+     * The default value for this schema type.
+     * Returns the user-configured default from metadata, or a sensible type-specific default.
+     * Subclasses override this to provide appropriate defaults (e.g., false for boolean, 0 for number).
+     */
+    get defaultValue(): Output | undefined;
     _meta: SchemaMetadata<Output>;
     /**
      * Replace the schema metadata with a new object.
@@ -77,14 +94,17 @@ declare abstract class BaseSchema<Output = any> {
 }
 declare class BooleanSchema extends BaseSchema<boolean> {
     readonly type: "boolean";
+    get defaultValue(): boolean;
     toZod(): z.ZodBoolean;
 }
 declare class StringSchema extends BaseSchema<string> {
     readonly type: "string";
+    get defaultValue(): string;
     toZod(): z.ZodString;
 }
 declare class NumberSchema extends BaseSchema<number> {
     readonly type: "number";
+    get defaultValue(): number;
     toZod(): z.ZodNumber;
 }
 /**
@@ -100,6 +120,15 @@ declare class OptionalSchema<TWrapped extends BaseSchema<any>> extends BaseSchem
      * @returns The wrapped schema.
      */
     unwrap(): TWrapped;
+    /**
+     * Returns the base type of the wrapped schema.
+     * This allows getting the underlying type (e.g., "number") even when wrapped in OptionalSchema.
+     */
+    get baseType(): string;
+    /**
+     * Optional fields default to undefined (which becomes null during validation).
+     */
+    get defaultValue(): TWrapped["_outputType"] | undefined;
     toZod(): z.ZodOptional<z.ZodNullable<z.ZodSchema<TWrapped["_outputType"]>>>;
 }
 /**
@@ -474,6 +503,79 @@ declare class NubaseSchemaError extends Error {
     static isNubaseSchemaError(error: unknown): error is NubaseSchemaError;
 }
 
+type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+interface RequestSchema {
+    method: HttpMethod;
+    path: string;
+    requestParams: ObjectSchema;
+    requestBody?: ObjectSchema;
+    responseBody: ObjectSchema | any;
+}
+type InferRequestParams<T extends RequestSchema> = Infer<T["requestParams"]>;
+type InferRequestBody<T extends RequestSchema> = T["requestBody"] extends ObjectSchema ? Infer<T["requestBody"]> : undefined;
+type InferResponseBody<T extends RequestSchema> = Infer<T["responseBody"]>;
+
+/**
+ * Schema type that can be used for lookup IDs.
+ * Supports both string IDs (UUIDs) and numeric IDs (auto-increment).
+ */
+type LookupIdSchema = StringSchema | NumberSchema;
+/**
+ * Creates a lookup schema with the specified ID type.
+ * This is the standardized format that all lookup endpoints must return.
+ *
+ * @param idSchema The schema for the ID field (nu.string() or nu.number())
+ */
+declare function createLookupSchema<TIdSchema extends LookupIdSchema>(idSchema: TIdSchema): ObjectSchema<{
+    /** Unique identifier for the entity */
+    id: TIdSchema;
+    /** Primary display text (e.g., user's display name) */
+    title: StringSchema;
+    /** Optional secondary text (e.g., email address) */
+    subtitle: OptionalSchema<StringSchema>;
+    /** Optional image URL or data URL for avatar display */
+    image: OptionalSchema<StringSchema>;
+}, null>;
+/**
+ * The default Lookup schema with string IDs.
+ * For numeric IDs, use createLookupSchema(nu.number()) instead.
+ */
+declare const lookupSchema: ObjectSchema<{
+    /** Unique identifier for the entity */
+    id: StringSchema;
+    /** Primary display text (e.g., user's display name) */
+    title: StringSchema;
+    /** Optional secondary text (e.g., email address) */
+    subtitle: OptionalSchema<StringSchema>;
+    /** Optional image URL or data URL for avatar display */
+    image: OptionalSchema<StringSchema>;
+}, null>;
+/**
+ * The Lookup type with string IDs - the display representation of an entity in lookup/select components.
+ * For numeric IDs, use Infer<ReturnType<typeof createLookupSchema<NumberSchema>>>.
+ */
+type Lookup = Infer<typeof lookupSchema>;
+/**
+ * Creates a lookup endpoint schema for a resource.
+ * Lookup endpoints accept a query string and return an array of Lookup objects.
+ *
+ * @example
+ * ```typescript
+ * // For string IDs (UUIDs):
+ * export const lookupUsersSchema = createLookupEndpoint("users", nu.string());
+ *
+ * // For numeric IDs (auto-increment):
+ * export const lookupUsersSchema = createLookupEndpoint("users", nu.number());
+ *
+ * // Creates: GET /lookup/users?q=<query> → Lookup[]
+ * ```
+ *
+ * @param resourceName The name of the resource (used in the path: /lookup/{resourceName})
+ * @param idSchema The schema for the ID field - use nu.string() for UUIDs or nu.number() for auto-increment IDs
+ * @returns A RequestSchema for the lookup endpoint
+ */
+declare function createLookupEndpoint<TIdSchema extends LookupIdSchema>(resourceName: string, idSchema: TIdSchema): RequestSchema;
+
 /**
  * The main nubase schema instance.
  * Provides factory methods to create different schema types.
@@ -511,18 +613,6 @@ declare const nu: {
     record: <TValueSchema extends BaseSchema<any>>(valueSchema: TValueSchema) => RecordSchema<TValueSchema>;
 };
 
-type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
-interface RequestSchema {
-    method: HttpMethod;
-    path: string;
-    requestParams: ObjectSchema;
-    requestBody?: ObjectSchema;
-    responseBody: ObjectSchema | any;
-}
-type InferRequestParams<T extends RequestSchema> = Infer<T["requestParams"]>;
-type InferRequestBody<T extends RequestSchema> = T["requestBody"] extends ObjectSchema ? Infer<T["requestBody"]> : undefined;
-type InferResponseBody<T extends RequestSchema> = Infer<T["responseBody"]>;
-
 /**
  * Configuration for series charts.
  * Defines which data keys represent the series and their display properties.
@@ -742,4 +832,4 @@ declare function createKpiWidgetEndpoint(path: string, requestParams?: ObjectSch
  */
 declare function createTableWidgetEndpoint(path: string, requestParams?: ObjectSchema<any>): TableWidgetRequestSchema;
 
-export { type ArrayOutput, ArraySchema, BaseSchema, BooleanSchema, type ComputedSchemaMetadata, type FormLayout, type FormLayoutField, type FormLayouts, HttpClient, type HttpMethod, type HttpRequestConfig, type HttpResponse, type Infer, type InferRequestBody, type InferRequestParams, type InferResponseBody, type KpiData, type KpiWidgetRequestSchema, type Layout, type LayoutGroup, type NuSchema, NubaseSchemaError, type NubaseValidationError, NumberSchema, type ObjectComputedMetadata, type ObjectLayouts, type ObjectOutput, ObjectSchema, type ObjectShape, OptionalSchema, type ProportionalData, type ProportionalDataItem, type ProportionalWidgetRequestSchema, RecordSchema, type RequestSchema, type SchemaMetadata, type SeriesConfig, type SeriesData, type SeriesDataPoint, type SeriesWidgetRequestSchema, StringSchema, type TableColumn, type TableData, type TableLayout, type TableLayoutField, type TableLayouts, type TableWidgetRequestSchema, type WidgetData, type WidgetDataType, createKpiWidgetEndpoint, createProportionalWidgetEndpoint, createSeriesWidgetEndpoint, createTableWidgetEndpoint, emptySchema, errorSchema, idNumberSchema, idStringSchema, kpiDataSchema, nu, proportionalDataItemSchema, proportionalDataSchema, seriesConfigSchema, seriesDataPointSchema, seriesDataSchema, successErrorSchema, successMessageSchema, successSchema, tableColumnSchema, tableDataSchema };
+export { type ArrayOutput, ArraySchema, BaseSchema, BooleanSchema, type ComputedSchemaMetadata, type FormLayout, type FormLayoutField, type FormLayouts, HttpClient, type HttpMethod, type HttpRequestConfig, type HttpResponse, type Infer, type InferRequestBody, type InferRequestParams, type InferResponseBody, type KpiData, type KpiWidgetRequestSchema, type Layout, type LayoutGroup, type Lookup, type LookupIdSchema, type NuSchema, NubaseSchemaError, type NubaseValidationError, NumberSchema, type ObjectComputedMetadata, type ObjectLayouts, type ObjectOutput, ObjectSchema, type ObjectShape, OptionalSchema, type ProportionalData, type ProportionalDataItem, type ProportionalWidgetRequestSchema, RecordSchema, type RequestSchema, type SchemaMetadata, type SeriesConfig, type SeriesData, type SeriesDataPoint, type SeriesWidgetRequestSchema, StringSchema, type TableColumn, type TableData, type TableLayout, type TableLayoutField, type TableLayouts, type TableWidgetRequestSchema, type WidgetData, type WidgetDataType, createKpiWidgetEndpoint, createLookupEndpoint, createLookupSchema, createProportionalWidgetEndpoint, createSeriesWidgetEndpoint, createTableWidgetEndpoint, emptySchema, errorSchema, idNumberSchema, idStringSchema, kpiDataSchema, lookupSchema, nu, proportionalDataItemSchema, proportionalDataSchema, seriesConfigSchema, seriesDataPointSchema, seriesDataSchema, successErrorSchema, successMessageSchema, successSchema, tableColumnSchema, tableDataSchema };

package/dist/index.d.ts

@@ -28,9 +28,14 @@ interface SchemaMetadata<Output = any> {
     defaultValue?: Output;
     /**
      * Custom renderer identifier to override the default type-based rendering.
-     * Examples: "multiline", "email", "password", "url"
+     * Examples: "multiline", "email", "password", "url", "lookup"
      */
     renderer?: string;
+    /**
+     * When renderer is "lookup", this specifies which resource to use for the lookup.
+     * The resource must have a lookup endpoint configured.
+     */
+    lookupResource?: string;
     validateOnSubmit?: (value: any) => string | undefined;
     validateOnSubmitAsync?: (value: any) => Promise<string | undefined>;
     validateOnBlur?: (value: any) => string | undefined;
@@ -51,6 +56,18 @@ declare abstract class BaseSchema<Output = any> {
      * Used for type-based form field rendering.
      */
     abstract readonly type: string;
+    /**
+     * The base type of this schema, unwrapping any wrapper schemas (like OptionalSchema).
+     * For most schemas, this is the same as `type`. For wrapper schemas like OptionalSchema,
+     * this returns the type of the innermost wrapped schema.
+     */
+    get baseType(): string;
+    /**
+     * The default value for this schema type.
+     * Returns the user-configured default from metadata, or a sensible type-specific default.
+     * Subclasses override this to provide appropriate defaults (e.g., false for boolean, 0 for number).
+     */
+    get defaultValue(): Output | undefined;
     _meta: SchemaMetadata<Output>;
     /**
      * Replace the schema metadata with a new object.
@@ -77,14 +94,17 @@ declare abstract class BaseSchema<Output = any> {
 }
 declare class BooleanSchema extends BaseSchema<boolean> {
     readonly type: "boolean";
+    get defaultValue(): boolean;
     toZod(): z.ZodBoolean;
 }
 declare class StringSchema extends BaseSchema<string> {
     readonly type: "string";
+    get defaultValue(): string;
     toZod(): z.ZodString;
 }
 declare class NumberSchema extends BaseSchema<number> {
     readonly type: "number";
+    get defaultValue(): number;
     toZod(): z.ZodNumber;
 }
 /**
@@ -100,6 +120,15 @@ declare class OptionalSchema<TWrapped extends BaseSchema<any>> extends BaseSchem
      * @returns The wrapped schema.
      */
     unwrap(): TWrapped;
+    /**
+     * Returns the base type of the wrapped schema.
+     * This allows getting the underlying type (e.g., "number") even when wrapped in OptionalSchema.
+     */
+    get baseType(): string;
+    /**
+     * Optional fields default to undefined (which becomes null during validation).
+     */
+    get defaultValue(): TWrapped["_outputType"] | undefined;
     toZod(): z.ZodOptional<z.ZodNullable<z.ZodSchema<TWrapped["_outputType"]>>>;
 }
 /**
@@ -474,6 +503,79 @@ declare class NubaseSchemaError extends Error {
     static isNubaseSchemaError(error: unknown): error is NubaseSchemaError;
 }
 
+type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+interface RequestSchema {
+    method: HttpMethod;
+    path: string;
+    requestParams: ObjectSchema;
+    requestBody?: ObjectSchema;
+    responseBody: ObjectSchema | any;
+}
+type InferRequestParams<T extends RequestSchema> = Infer<T["requestParams"]>;
+type InferRequestBody<T extends RequestSchema> = T["requestBody"] extends ObjectSchema ? Infer<T["requestBody"]> : undefined;
+type InferResponseBody<T extends RequestSchema> = Infer<T["responseBody"]>;
+
+/**
+ * Schema type that can be used for lookup IDs.
+ * Supports both string IDs (UUIDs) and numeric IDs (auto-increment).
+ */
+type LookupIdSchema = StringSchema | NumberSchema;
+/**
+ * Creates a lookup schema with the specified ID type.
+ * This is the standardized format that all lookup endpoints must return.
+ *
+ * @param idSchema The schema for the ID field (nu.string() or nu.number())
+ */
+declare function createLookupSchema<TIdSchema extends LookupIdSchema>(idSchema: TIdSchema): ObjectSchema<{
+    /** Unique identifier for the entity */
+    id: TIdSchema;
+    /** Primary display text (e.g., user's display name) */
+    title: StringSchema;
+    /** Optional secondary text (e.g., email address) */
+    subtitle: OptionalSchema<StringSchema>;
+    /** Optional image URL or data URL for avatar display */
+    image: OptionalSchema<StringSchema>;
+}, null>;
+/**
+ * The default Lookup schema with string IDs.
+ * For numeric IDs, use createLookupSchema(nu.number()) instead.
+ */
+declare const lookupSchema: ObjectSchema<{
+    /** Unique identifier for the entity */
+    id: StringSchema;
+    /** Primary display text (e.g., user's display name) */
+    title: StringSchema;
+    /** Optional secondary text (e.g., email address) */
+    subtitle: OptionalSchema<StringSchema>;
+    /** Optional image URL or data URL for avatar display */
+    image: OptionalSchema<StringSchema>;
+}, null>;
+/**
+ * The Lookup type with string IDs - the display representation of an entity in lookup/select components.
+ * For numeric IDs, use Infer<ReturnType<typeof createLookupSchema<NumberSchema>>>.
+ */
+type Lookup = Infer<typeof lookupSchema>;
+/**
+ * Creates a lookup endpoint schema for a resource.
+ * Lookup endpoints accept a query string and return an array of Lookup objects.
+ *
+ * @example
+ * ```typescript
+ * // For string IDs (UUIDs):
+ * export const lookupUsersSchema = createLookupEndpoint("users", nu.string());
+ *
+ * // For numeric IDs (auto-increment):
+ * export const lookupUsersSchema = createLookupEndpoint("users", nu.number());
+ *
+ * // Creates: GET /lookup/users?q=<query> → Lookup[]
+ * ```
+ *
+ * @param resourceName The name of the resource (used in the path: /lookup/{resourceName})
+ * @param idSchema The schema for the ID field - use nu.string() for UUIDs or nu.number() for auto-increment IDs
+ * @returns A RequestSchema for the lookup endpoint
+ */
+declare function createLookupEndpoint<TIdSchema extends LookupIdSchema>(resourceName: string, idSchema: TIdSchema): RequestSchema;
+
 /**
  * The main nubase schema instance.
  * Provides factory methods to create different schema types.
@@ -511,18 +613,6 @@ declare const nu: {
     record: <TValueSchema extends BaseSchema<any>>(valueSchema: TValueSchema) => RecordSchema<TValueSchema>;
 };
 
-type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
-interface RequestSchema {
-    method: HttpMethod;
-    path: string;
-    requestParams: ObjectSchema;
-    requestBody?: ObjectSchema;
-    responseBody: ObjectSchema | any;
-}
-type InferRequestParams<T extends RequestSchema> = Infer<T["requestParams"]>;
-type InferRequestBody<T extends RequestSchema> = T["requestBody"] extends ObjectSchema ? Infer<T["requestBody"]> : undefined;
-type InferResponseBody<T extends RequestSchema> = Infer<T["responseBody"]>;
-
 /**
  * Configuration for series charts.
  * Defines which data keys represent the series and their display properties.
@@ -742,4 +832,4 @@ declare function createKpiWidgetEndpoint(path: string, requestParams?: ObjectSch
  */
 declare function createTableWidgetEndpoint(path: string, requestParams?: ObjectSchema<any>): TableWidgetRequestSchema;
 
-export { type ArrayOutput, ArraySchema, BaseSchema, BooleanSchema, type ComputedSchemaMetadata, type FormLayout, type FormLayoutField, type FormLayouts, HttpClient, type HttpMethod, type HttpRequestConfig, type HttpResponse, type Infer, type InferRequestBody, type InferRequestParams, type InferResponseBody, type KpiData, type KpiWidgetRequestSchema, type Layout, type LayoutGroup, type NuSchema, NubaseSchemaError, type NubaseValidationError, NumberSchema, type ObjectComputedMetadata, type ObjectLayouts, type ObjectOutput, ObjectSchema, type ObjectShape, OptionalSchema, type ProportionalData, type ProportionalDataItem, type ProportionalWidgetRequestSchema, RecordSchema, type RequestSchema, type SchemaMetadata, type SeriesConfig, type SeriesData, type SeriesDataPoint, type SeriesWidgetRequestSchema, StringSchema, type TableColumn, type TableData, type TableLayout, type TableLayoutField, type TableLayouts, type TableWidgetRequestSchema, type WidgetData, type WidgetDataType, createKpiWidgetEndpoint, createProportionalWidgetEndpoint, createSeriesWidgetEndpoint, createTableWidgetEndpoint, emptySchema, errorSchema, idNumberSchema, idStringSchema, kpiDataSchema, nu, proportionalDataItemSchema, proportionalDataSchema, seriesConfigSchema, seriesDataPointSchema, seriesDataSchema, successErrorSchema, successMessageSchema, successSchema, tableColumnSchema, tableDataSchema };
+export { type ArrayOutput, ArraySchema, BaseSchema, BooleanSchema, type ComputedSchemaMetadata, type FormLayout, type FormLayoutField, type FormLayouts, HttpClient, type HttpMethod, type HttpRequestConfig, type HttpResponse, type Infer, type InferRequestBody, type InferRequestParams, type InferResponseBody, type KpiData, type KpiWidgetRequestSchema, type Layout, type LayoutGroup, type Lookup, type LookupIdSchema, type NuSchema, NubaseSchemaError, type NubaseValidationError, NumberSchema, type ObjectComputedMetadata, type ObjectLayouts, type ObjectOutput, ObjectSchema, type ObjectShape, OptionalSchema, type ProportionalData, type ProportionalDataItem, type ProportionalWidgetRequestSchema, RecordSchema, type RequestSchema, type SchemaMetadata, type SeriesConfig, type SeriesData, type SeriesDataPoint, type SeriesWidgetRequestSchema, StringSchema, type TableColumn, type TableData, type TableLayout, type TableLayoutField, type TableLayouts, type TableWidgetRequestSchema, type WidgetData, type WidgetDataType, createKpiWidgetEndpoint, createLookupEndpoint, createLookupSchema, createProportionalWidgetEndpoint, createSeriesWidgetEndpoint, createTableWidgetEndpoint, emptySchema, errorSchema, idNumberSchema, idStringSchema, kpiDataSchema, lookupSchema, nu, proportionalDataItemSchema, proportionalDataSchema, seriesConfigSchema, seriesDataPointSchema, seriesDataSchema, successErrorSchema, successMessageSchema, successSchema, tableColumnSchema, tableDataSchema };

package/dist/index.js

@@ -41,6 +41,8 @@ __export(index_exports, {
   RecordSchema: () => RecordSchema,
   StringSchema: () => StringSchema,
   createKpiWidgetEndpoint: () => createKpiWidgetEndpoint,
+  createLookupEndpoint: () => createLookupEndpoint,
+  createLookupSchema: () => createLookupSchema,
   createProportionalWidgetEndpoint: () => createProportionalWidgetEndpoint,
   createSeriesWidgetEndpoint: () => createSeriesWidgetEndpoint,
   createTableWidgetEndpoint: () => createTableWidgetEndpoint,
@@ -49,6 +51,7 @@ __export(index_exports, {
   idNumberSchema: () => idNumberSchema,
   idStringSchema: () => idStringSchema,
   kpiDataSchema: () => kpiDataSchema,
+  lookupSchema: () => lookupSchema,
   nu: () => nu,
   proportionalDataItemSchema: () => proportionalDataItemSchema,
   proportionalDataSchema: () => proportionalDataSchema,
@@ -336,6 +339,22 @@ var BaseSchema = class {
    * @internal
    */
   _outputType;
+  /**
+   * The base type of this schema, unwrapping any wrapper schemas (like OptionalSchema).
+   * For most schemas, this is the same as `type`. For wrapper schemas like OptionalSchema,
+   * this returns the type of the innermost wrapped schema.
+   */
+  get baseType() {
+    return this.type;
+  }
+  /**
+   * The default value for this schema type.
+   * Returns the user-configured default from metadata, or a sensible type-specific default.
+   * Subclasses override this to provide appropriate defaults (e.g., false for boolean, 0 for number).
+   */
+  get defaultValue() {
+    return this._meta?.defaultValue;
+  }
   _meta = {};
   /**
    * Replace the schema metadata with a new object.
@@ -365,20 +384,27 @@ var BaseSchema = class {
 };
 var BooleanSchema = class extends BaseSchema {
   type = "boolean";
+  get defaultValue() {
+    return this._meta?.defaultValue ?? false;
+  }
   toZod() {
     return import_zod.z.boolean();
   }
 };
 var StringSchema = class extends BaseSchema {
   type = "string";
-  // Add string-specific validation methods here (e.g., minLength, pattern)
+  get defaultValue() {
+    return this._meta?.defaultValue ?? "";
+  }
   toZod() {
     return import_zod.z.string();
   }
 };
 var NumberSchema = class extends BaseSchema {
   type = "number";
-  // Add number-specific validation methods here (e.g., min, max)
+  get defaultValue() {
+    return this._meta?.defaultValue ?? 0;
+  }
   toZod() {
     return import_zod.z.number();
   }
@@ -397,6 +423,19 @@ var OptionalSchema = class extends BaseSchema {
   unwrap() {
     return this._wrapped;
   }
+  /**
+   * Returns the base type of the wrapped schema.
+   * This allows getting the underlying type (e.g., "number") even when wrapped in OptionalSchema.
+   */
+  get baseType() {
+    return this._wrapped.baseType;
+  }
+  /**
+   * Optional fields default to undefined (which becomes null during validation).
+   */
+  get defaultValue() {
+    return this._meta?.defaultValue ?? void 0;
+  }
   toZod() {
     return this._wrapped.toZod().nullable().optional();
   }
@@ -927,6 +966,32 @@ ${errors.map((e) => `  - ${e.path}: ${e.message}`).join("\n")}`;
   }
 };
 
+// src/schema/lookup.ts
+function createLookupSchema(idSchema) {
+  return nu.object({
+    /** Unique identifier for the entity */
+    id: idSchema,
+    /** Primary display text (e.g., user's display name) */
+    title: nu.string(),
+    /** Optional secondary text (e.g., email address) */
+    subtitle: nu.string().optional(),
+    /** Optional image URL or data URL for avatar display */
+    image: nu.string().optional()
+  });
+}
+var lookupSchema = createLookupSchema(nu.string());
+function createLookupEndpoint(resourceName, idSchema) {
+  return {
+    method: "GET",
+    path: `/lookup/${resourceName}`,
+    requestParams: nu.object({
+      /** The search query string */
+      q: nu.string()
+    }),
+    responseBody: nu.array(createLookupSchema(idSchema))
+  };
+}
+
 // src/schema/widget-data-schema.ts
 var seriesConfigSchema = nu.object({
   /** The data key field names that represent numeric series (e.g., ["desktop", "mobile"]) */
@@ -1022,6 +1087,8 @@ function createTableWidgetEndpoint(path, requestParams) {
   RecordSchema,
   StringSchema,
   createKpiWidgetEndpoint,
+  createLookupEndpoint,
+  createLookupSchema,
   createProportionalWidgetEndpoint,
   createSeriesWidgetEndpoint,
   createTableWidgetEndpoint,
@@ -1030,6 +1097,7 @@ function createTableWidgetEndpoint(path, requestParams) {
   idNumberSchema,
   idStringSchema,
   kpiDataSchema,
+  lookupSchema,
   nu,
   proportionalDataItemSchema,
   proportionalDataSchema,