alepha 0.20.5 → 0.20.7

package/dist/react/form/index.js

@@ -25,7 +25,8 @@ const useFormState = (target, _events = [
 		if (hasErrors || hasValues || hasDirty) listeners.push(alepha.events.on("form:change", (event) => {
 			if (event.id === form.id) {
 				if (!path || event.path === path) {
-					if (hasDirty) setDirty(true);
+					if (hasDirty) if (event.initial) setDirty(false);
+					else setDirty(true);
 					if (hasErrors) setError(void 0);
 				}
 				if (hasValues) setValues(form.currentValues);
@@ -117,6 +118,8 @@ const useFieldValue = (input) => {
 * @see {@link useForm}
 */
 var FormModel = class {
+	id;
+	options;
 	log = $logger();
 	alepha = $inject(Alepha);
 	values = {};
@@ -133,7 +136,7 @@ var FormModel = class {
 		const schemaDefaults = this.extractSchemaDefaults(options.schema);
 		if (Object.keys(schemaDefaults).length > 0) Object.assign(this.values, schemaDefaults);
 		if (options.initialValues) {
-			const decoded = this.alepha.codec.decode(options.schema, options.initialValues);
+			const decoded = this.alepha.codec.decode(t.partial(options.schema), options.initialValues);
 			Object.assign(this.values, decoded);
 		}
 		this.initialValues = { ...this.values };
@@ -174,7 +177,7 @@ var FormModel = class {
 		};
 	}
 	setInitialValues = (values) => {
-		const decoded = this.alepha.codec.decode(this.options.schema, values);
+		const decoded = this.alepha.codec.decode(t.partial(this.options.schema), values);
 		for (const key in this.initialValues) delete this.initialValues[key];
 		Object.assign(this.initialValues, decoded);
 		for (const key in this.values) delete this.values[key];
@@ -184,7 +187,8 @@ var FormModel = class {
 			this.alepha.events.emit("form:change", {
 				id: this.id,
 				path,
-				value
+				value,
+				initial: true
 			}, { catch: true });
 		}
 	};

package/dist/react/form/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/react/form/hooks/useFormState.ts","../../../src/react/form/components/FormState.tsx","../../../src/react/form/errors/FormValidationError.ts","../../../src/react/form/hooks/useFieldValue.ts","../../../src/react/form/services/FormModel.ts","../../../src/react/form/hooks/useForm.ts","../../../src/react/form/hooks/useFormValues.ts","../../../src/react/form/services/prettyName.ts","../../../src/react/form/services/parseField.ts","../../../src/react/form/index.ts"],"sourcesContent":["import { type TObject, TypeBoxError } from \"alepha\";\nimport { useAlepha } from \"alepha/react\";\nimport { useEffect, useState } from \"react\";\nimport type { FormModel } from \"../services/FormModel.ts\";\n\nexport interface UseFormStateReturn {\n  loading: boolean;\n  dirty: boolean;\n  values?: Record<string, any>;\n  error?: Error;\n}\n\nexport const useFormState = <\n  T extends TObject,\n  Keys extends keyof UseFormStateReturn,\n>(\n  target: FormModel<T> | { form: FormModel<T>; path: string },\n  _events: Keys[] = [\"loading\", \"dirty\", \"error\"] as Keys[],\n): Pick<UseFormStateReturn, Keys> => {\n  const alepha = useAlepha();\n  const events = _events as string[];\n\n  const [dirty, setDirty] = useState(false);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | undefined>(undefined);\n  const [values, setValues] = useState<Record<string, any> | undefined>(\n    undefined,\n  );\n\n  const form = \"form\" in target ? target.form : target;\n  const path = \"path\" in target ? target.path : undefined;\n\n  const hasValues = events.includes(\"values\");\n  const hasErrors = events.includes(\"error\");\n  const hasDirty = events.includes(\"dirty\");\n  const hasLoading = events.includes(\"loading\");\n\n  useEffect(() => {\n    const listeners: Function[] = [];\n\n    if (hasErrors || hasValues || hasDirty) {\n      listeners.push(\n        alepha.events.on(\"form:change\", (event) => {\n          if (event.id === form.id) {\n            if (!path || event.path === path) {\n              if (hasDirty) {\n                setDirty(true);\n              }\n              if (hasErrors) {\n                setError(undefined);\n              }\n            }\n            if (hasValues) {\n              setValues(form.currentValues);\n            }\n          }\n        }),\n      );\n    }\n\n    if (hasLoading) {\n      listeners.push(\n        alepha.events.on(\"form:submit:begin\", (event) => {\n          if (event.id === form.id) {\n            setLoading(true);\n          }\n        }),\n        alepha.events.on(\"form:submit:end\", (event) => {\n          if (event.id === form.id) {\n            setLoading(false);\n          }\n        }),\n      );\n    }\n\n    if (hasValues || hasDirty) {\n      listeners.push(\n        alepha.events.on(\"form:submit:success\", (event) => {\n          if (event.id === form.id) {\n            if (hasValues) {\n              setValues(event.values);\n            }\n            if (hasDirty) {\n              setDirty(false);\n            }\n          }\n        }),\n      );\n    }\n\n    if (hasDirty) {\n      listeners.push(\n        alepha.events.on(\"form:reset\", (event) => {\n          if (event.id === form.id) {\n            setDirty(false);\n          }\n        }),\n      );\n    }\n\n    if (hasErrors) {\n      listeners.push(\n        alepha.events.on(\"form:submit:error\", (event) => {\n          if (event.id === form.id) {\n            if (\n              !path ||\n              (event.error instanceof TypeBoxError &&\n                event.error.value.path === path)\n            ) {\n              setError(event.error);\n            }\n          }\n        }),\n      );\n    }\n\n    return () => {\n      for (const unsub of listeners) {\n        unsub();\n      }\n    };\n  }, []);\n\n  return {\n    dirty,\n    loading,\n    error,\n    values,\n  } as Pick<UseFormStateReturn, Keys>;\n};\n","import type { TObject } from \"alepha\";\nimport type { ReactNode } from \"react\";\nimport { useFormState } from \"../hooks/useFormState.ts\";\nimport type { FormModel } from \"../services/FormModel.ts\";\n\nconst FormState = <T extends TObject>(props: {\n  form: FormModel<T>;\n  children: (state: { loading: boolean; dirty: boolean }) => ReactNode;\n}) => {\n  const formState = useFormState(props.form);\n  return props.children({\n    loading: formState.loading,\n    dirty: formState.dirty,\n  });\n};\n\nexport default FormState;\n","import { TypeBoxError } from \"alepha\";\n\nexport class FormValidationError extends TypeBoxError {\n  readonly name = \"ValidationError\";\n\n  constructor(options: {\n    message: string;\n    path: string;\n  }) {\n    super({\n      message: options.message,\n      instancePath: options.path,\n      schemaPath: \"\",\n      keyword: \"not\",\n      params: {},\n    });\n  }\n}\n","import { useAlepha } from \"alepha/react\";\nimport { useEffect, useState } from \"react\";\nimport type { BaseInputField } from \"../services/FormModel.ts\";\n\n/**\n * Hook to subscribe to a single form field's value.\n * Only re-renders when this specific field changes.\n *\n * @returns A tuple of [value, setValue] similar to useState.\n */\nexport const useFieldValue = (\n  input: BaseInputField,\n): [any, (value: any) => void] => {\n  const alepha = useAlepha();\n  const [value, setValue] = useState(input?.initialValue);\n\n  useEffect(() => {\n    if (!input?.form || !alepha.isBrowser()) {\n      return;\n    }\n\n    return alepha.events.on(\"form:change\", (ev) => {\n      if (ev.id === input.form.id && ev.path === input.path) {\n        setValue(ev.value);\n      }\n    });\n  }, []);\n\n  const setFieldValue = (newValue: any) => {\n    input.set(newValue);\n  };\n\n  return [value, setFieldValue];\n};\n","import type { TArray } from \"alepha\";\nimport {\n  $inject,\n  Alepha,\n  type Static,\n  type TObject,\n  type TSchema,\n  t,\n} from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport type { InputHTMLAttributes } from \"react\";\n\n/**\n * FormModel is a dynamic form handler that generates form inputs based on a provided TypeBox schema.\n * It manages form state, handles input changes, and processes form submissions with validation.\n *\n * It means to be injected and used within React components to provide a structured way to create and manage forms.\n *\n * @see {@link useForm}\n */\nexport class FormModel<T extends TObject> {\n  protected readonly log = $logger();\n  protected readonly alepha = $inject(Alepha);\n  protected readonly values: Record<string, any> = {};\n  protected readonly initialValues: Record<string, any> = {};\n  protected submitInProgress = false;\n\n  public input: SchemaToInput<T>;\n\n  public get submitting(): boolean {\n    return this.submitInProgress;\n  }\n\n  constructor(\n    public readonly id: string,\n    public readonly options: FormCtrlOptions<T>,\n  ) {\n    this.options = options;\n\n    // Initialize with schema defaults first, then override with initialValues\n    const schemaDefaults = this.extractSchemaDefaults(options.schema);\n    if (Object.keys(schemaDefaults).length > 0) {\n      Object.assign(this.values, schemaDefaults);\n    }\n\n    if (options.initialValues) {\n      const decoded = this.alepha.codec.decode(\n        options.schema,\n        options.initialValues,\n      ) as Record<string, any>;\n      Object.assign(this.values, decoded);\n    }\n\n    this.initialValues = { ...this.values };\n\n    this.input = this.createProxyFromSchema(options, options.schema, {\n      store: this.values,\n      parent: \"\",\n    });\n  }\n\n  /**\n   * Extract default values from a TypeBox schema.\n   * Recursively handles nested objects.\n   */\n  protected extractSchemaDefaults(\n    schema: TObject,\n    prefix: string = \"\",\n  ): Record<string, any> {\n    const defaults: Record<string, any> = {};\n\n    if (!schema.properties) {\n      return defaults;\n    }\n\n    for (const [key, propSchema] of Object.entries(schema.properties)) {\n      const fullKey = prefix ? `${prefix}.${key}` : key;\n\n      if (\"default\" in propSchema && propSchema.default !== undefined) {\n        defaults[fullKey] = propSchema.default;\n      } else if (\n        propSchema &&\n        \"type\" in propSchema &&\n        propSchema.type === \"object\" &&\n        \"properties\" in propSchema\n      ) {\n        // Recursively extract defaults from nested objects\n        const nestedDefaults = this.extractSchemaDefaults(\n          propSchema as TObject,\n          fullKey,\n        );\n        Object.assign(defaults, nestedDefaults);\n      }\n    }\n\n    return defaults;\n  }\n\n  public get currentValues(): Record<string, any> {\n    return this.restructureValues(this.values);\n  }\n\n  public get props() {\n    return {\n      id: this.id,\n      noValidate: true,\n      onSubmit: (ev?: FormEventLike) => {\n        ev?.preventDefault?.();\n        this.submit();\n      },\n      onReset: (event: FormEventLike) => this.reset(event),\n    };\n  }\n\n  public readonly setInitialValues = (values: Record<string, any>) => {\n    const decoded = this.alepha.codec.decode(\n      this.options.schema,\n      values,\n    ) as Record<string, any>;\n\n    for (const key in this.initialValues) {\n      delete (this.initialValues as Record<string, any>)[key];\n    }\n    Object.assign(this.initialValues, decoded);\n\n    for (const key in this.values) {\n      delete this.values[key];\n    }\n    Object.assign(this.values, { ...this.initialValues });\n\n    for (const [key, value] of Object.entries(this.values)) {\n      const path = `/${key.replaceAll(\".\", \"/\")}`;\n      this.alepha.events.emit(\n        \"form:change\",\n        { id: this.id, path, value },\n        { catch: true },\n      );\n    }\n  };\n\n  public readonly reset = (event?: FormEventLike) => {\n    event?.preventDefault?.();\n    // Snapshot all keys that need notification — both keys present\n    // before reset (so subscribers learn the cleared value) and keys\n    // restored from initialValues. Without the union, fields that were\n    // typed but absent from initialValues stay visually stale.\n    const keys = new Set<string>([\n      ...Object.keys(this.values),\n      ...Object.keys(this.initialValues),\n    ]);\n    for (const key in this.values) {\n      delete this.values[key];\n    }\n    Object.assign(this.values, { ...this.initialValues });\n    for (const key of keys) {\n      const path = `/${key.replaceAll(\".\", \"/\")}`;\n      this.alepha.events.emit(\n        \"form:change\",\n        { id: this.id, path, value: this.values[key] },\n        { catch: true },\n      );\n    }\n    this.alepha.events.emit(\"form:reset\", { id: this.id }, { catch: true });\n    this.options.onReset?.();\n  };\n\n  public readonly submit = async () => {\n    if (this.submitInProgress) {\n      this.log.warn(\n        \"Form submission already in progress, ignoring duplicate submit.\",\n      );\n      return;\n    }\n\n    // emit both action and form events\n    await this.alepha.events.emit(\"react:action:begin\", {\n      type: \"form\",\n      id: this.id,\n    });\n    await this.alepha.events.emit(\"form:submit:begin\", {\n      id: this.id,\n    });\n\n    this.submitInProgress = true;\n\n    const options = this.options;\n\n    try {\n      let values: Record<string, any> = this.restructureValues(this.values);\n\n      if (t.schema.isSchema(options.schema)) {\n        values = this.alepha.codec.decode(options.schema, values) as Record<\n          string,\n          any\n        >;\n      }\n\n      await options.handler(values as any);\n\n      await this.alepha.events.emit(\"react:action:success\", {\n        type: \"form\",\n        id: this.id,\n      });\n      await this.alepha.events.emit(\"form:submit:success\", {\n        id: this.id,\n        values,\n      });\n    } catch (error) {\n      this.log.error(\"Form submission error:\", error);\n\n      options.onError?.(error as Error);\n\n      await this.alepha.events.emit(\"react:action:error\", {\n        type: \"form\",\n        id: this.id,\n        error: error as Error,\n      });\n      await this.alepha.events.emit(\"form:submit:error\", {\n        error: error as Error,\n        id: this.id,\n      });\n    } finally {\n      this.submitInProgress = false;\n    }\n\n    await this.alepha.events.emit(\"react:action:end\", {\n      type: \"form\",\n      id: this.id,\n    });\n    await this.alepha.events.emit(\"form:submit:end\", {\n      id: this.id,\n    });\n  };\n\n  /**\n   * Restructures flat keys like \"address.city\" into nested objects like { address: { city: ... } }\n   * Values are already typed from onChange, so no conversion is needed.\n   */\n  protected restructureValues(store: Record<string, any>): Record<string, any> {\n    const values: Record<string, any> = {};\n\n    for (const [key, value] of Object.entries(store)) {\n      if (key.includes(\".\")) {\n        // nested object: restructure flat key to nested structure\n        this.restructureNestedValue(values, key, value);\n      } else {\n        // value is already typed, just copy it\n        values[key] = value;\n      }\n    }\n\n    return values;\n  }\n\n  /**\n   * Helper to restructure a flat key like \"address.city\" into nested object structure.\n   * The value is already typed, so we just assign it to the nested path.\n   */\n  protected restructureNestedValue(\n    values: Record<string, any>,\n    key: string,\n    value: any,\n  ) {\n    const pathSegments = key.split(\".\");\n    const finalPropertyKey = pathSegments.pop();\n    if (!finalPropertyKey) {\n      return;\n    }\n\n    let currentObjectLevel = values;\n\n    // traverse/create the nested structure\n    for (const segment of pathSegments) {\n      currentObjectLevel[segment] ??= {};\n      currentObjectLevel = currentObjectLevel[segment];\n    }\n\n    // value is already typed from onChange, just assign it\n    currentObjectLevel[finalPropertyKey] = value;\n  }\n\n  protected createProxyFromSchema<T extends TObject>(\n    options: FormCtrlOptions<T>,\n    schema: TSchema,\n    context: {\n      parent: string;\n      store: Record<string, any>;\n    },\n  ): SchemaToInput<T> {\n    const parent = context.parent || \"\";\n    return new Proxy<SchemaToInput<T>>({} as SchemaToInput<T>, {\n      get: (_, prop: string) => {\n        if (!options.schema || !t.schema.isObject(schema)) {\n          return {};\n        }\n\n        if (prop in schema.properties) {\n          // // it's a nested object, create another proxy\n          // if (t.schema.isObject(schema.properties[prop])) {\n          //   return this.createProxyFromSchema(\n          //     options,\n          //     schema.properties[prop],\n          //     {\n          //       parent: parent ? `${parent}.${prop}` : prop,\n          //       store: context.store,\n          //     },\n          //   );\n          // }\n\n          return this.createInputFromSchema<T>(\n            prop as keyof Static<T> & string,\n            options,\n            schema,\n            schema.required?.includes(prop as string) || false,\n            context,\n          );\n        }\n      },\n    });\n  }\n\n  protected createInputFromSchema<T extends TObject>(\n    name: keyof Static<T> & string,\n    options: FormCtrlOptions<T>,\n    schema: TObject,\n    required: boolean,\n    context: {\n      parent: string;\n      store: Record<string, any>;\n    },\n  ): BaseInputField {\n    const parent = context.parent || \"\";\n    const field = schema.properties?.[name];\n    if (!field) {\n      return {\n        path: \"\",\n        required,\n        initialValue: undefined,\n        props: {} as InputHTMLAttributes<unknown>,\n        schema: schema,\n        set: () => {},\n        form: this,\n      };\n    }\n\n    const isRequired = schema.required?.includes(name) ?? false;\n    const key = parent ? `${parent}.${name}` : name;\n    const path = `/${key.replaceAll(\".\", \"/\")}`;\n\n    const set = (value: any) => {\n      const typedValue = this.getValueFromInput(value, field);\n      context.store[key] = typedValue;\n      if (options.onChange) {\n        options.onChange(key, typedValue, context.store);\n      }\n      this.alepha.events.emit(\n        \"form:change\",\n        { id: this.id, path: path, value: typedValue },\n        { catch: true },\n      );\n    };\n\n    const attr: InputHTMLAttributesLike = {\n      name: key,\n    };\n\n    // Use the form's runtime id (always set — comes from `useId()` when\n    // no explicit `options.id` was provided). This guarantees stable\n    // per-field DOM ids without forcing callers to pass `id`.\n    attr.id = `${this.id}-${key}`;\n    (attr as any)[\"data-testid\"] = attr.id;\n\n    if (t.schema.isString(field)) {\n      if (field.maxLength != null) {\n        attr.maxLength = Number(field.maxLength);\n      }\n\n      if (field.minLength != null) {\n        attr.minLength = Number(field.minLength);\n      }\n    }\n\n    if (isRequired) {\n      attr.required = true;\n    }\n\n    if (\"description\" in field && typeof field.description === \"string\") {\n      attr[\"aria-label\"] = field.description;\n    }\n\n    if (t.schema.isInteger(field) || t.schema.isNumber(field)) {\n      attr.type = \"number\";\n    } else if (name === \"password\") {\n      attr.type = \"password\";\n    } else if (name === \"email\") {\n      attr.type = \"email\";\n    } else if (name === \"url\") {\n      attr.type = \"url\";\n    } else if (t.schema.isString(field)) {\n      if (field.format === \"binary\") {\n        attr.type = \"file\";\n      } else if (field.format === \"date\") {\n        attr.type = \"date\";\n      } else if (field.format === \"time\") {\n        attr.type = \"time\";\n      } else if (field.format === \"date-time\") {\n        attr.type = \"datetime-local\";\n      } else {\n        attr.type = \"text\";\n      }\n    } else if (t.schema.isBoolean(field)) {\n      attr.type = \"checkbox\";\n    }\n\n    if (options.onCreateField) {\n      const customAttr = options.onCreateField(name, field);\n      Object.assign(attr, customAttr);\n    }\n\n    // if type = object, add items: { [key: string]: InputField }\n    if (t.schema.isObject(field)) {\n      return {\n        path,\n        props: attr,\n        schema: field,\n        set,\n        form: this,\n        required,\n        initialValue: context.store[key],\n        items: this.createProxyFromSchema(options, field, {\n          parent: key,\n          store: context.store,\n        }),\n      } as ObjectInputField<any>;\n    }\n\n    // if type = array, add items: InputField[]\n    if (t.schema.isArray(field)) {\n      return {\n        path,\n        props: attr,\n        schema: field,\n        set,\n        form: this,\n        required,\n        initialValue: context.store[key],\n        items: [], // <- will be populated dynamically in the UI\n      } as ArrayInputField<any>;\n    }\n\n    return {\n      path,\n      props: attr,\n      schema: field,\n      set,\n      form: this,\n      required,\n      initialValue: context.store[key],\n    };\n  }\n\n  /**\n   * Convert an input value to the correct type based on the schema.\n   * Handles raw DOM values (strings, booleans from checkboxes, Files, etc.)\n   */\n  protected getValueFromInput(input: any, schema: TSchema): any {\n    if (input instanceof File) {\n      // for file inputs, return the File object directly\n      if (t.schema.isString(schema) && schema.format === \"binary\") {\n        return input;\n      }\n      // for now, ignore other formats\n      return null;\n    }\n\n    if (t.schema.isBoolean(schema)) {\n      // Handle string representations from Select components (Yes/No dropdown)\n      if (input === \"true\") return true;\n      if (input === \"false\") return false;\n      if (input === \"\" || input === null || input === undefined)\n        return undefined;\n      // Handle actual boolean values\n      return !!input;\n    }\n\n    if (t.schema.isNumber(schema)) {\n      const num = Number(input);\n      return Number.isNaN(num) ? null : num;\n    }\n\n    if (t.schema.isString(schema)) {\n      if (schema.format === \"date\") {\n        return new Date(input).toISOString().slice(0, 10); // For date input\n      }\n      if (schema.format === \"time\") {\n        return new Date(`1970-01-01T${input}`).toISOString().slice(11, 16); // For time input\n      }\n      if (schema.format === \"date-time\") {\n        return new Date(input).toISOString(); // For datetime-local input\n      }\n      return String(input);\n    }\n\n    return input; // fallback for other types\n  }\n}\n\nexport type SchemaToInput<T extends TObject> = {\n  [K in keyof T[\"properties\"]]: InputField<T[\"properties\"][K]>;\n};\n\nexport interface FormEventLike {\n  preventDefault?: () => void;\n  stopPropagation?: () => void;\n}\n\nexport type InputField<T extends TSchema> = T extends TObject\n  ? ObjectInputField<T>\n  : T extends TArray<infer U>\n    ? ArrayInputField<U>\n    : BaseInputField;\n\nexport interface BaseInputField {\n  path: string;\n  required: boolean;\n  initialValue: any;\n  props: InputHTMLAttributesLike;\n  schema: TSchema;\n  set: (value: any) => void;\n  form: FormModel<any>;\n  items?: any;\n}\n\nexport interface ObjectInputField<T extends TObject> extends BaseInputField {\n  items: SchemaToInput<T>;\n}\n\nexport interface ArrayInputField<T extends TSchema> extends BaseInputField {\n  items: Array<InputField<T>>;\n}\n\nexport type InputHTMLAttributesLike = Pick<\n  InputHTMLAttributes<unknown>,\n  | \"id\"\n  | \"name\"\n  | \"type\"\n  | \"value\"\n  | \"required\"\n  | \"maxLength\"\n  | \"minLength\"\n  | \"aria-label\"\n> & {\n  value?: any;\n};\n\nexport type FormCtrlOptions<T extends TObject> = {\n  /**\n   * The schema defining the structure and validation rules for the form.\n   * This should be a TypeBox schema object.\n   */\n  schema: T;\n\n  /**\n   * Callback function to handle form submission.\n   * This function will receive the parsed and validated form values.\n   */\n  handler: (values: Static<T>) => unknown;\n\n  /**\n   * Optional initial values for the form fields.\n   * This can be used to pre-populate the form with existing data.\n   */\n  initialValues?: Partial<Static<T>>;\n\n  /**\n   * Optional function to create custom field attributes.\n   * This can be used to add custom validation, styles, or other attributes.\n   */\n  onCreateField?: (\n    name: keyof Static<T> & string,\n    schema: TSchema,\n  ) => InputHTMLAttributes<unknown>;\n\n  /**\n   * If defined, this will generate a unique ID for each field, prefixed with this string.\n   *\n   * > \"username\" with id=\"form-123\" will become \"form-123-username\".\n   *\n   * If omitted, IDs will not be generated.\n   */\n  id?: string;\n\n  onError?: (error: Error) => void;\n\n  onChange?: (key: string, value: any, store: Record<string, any>) => void;\n\n  onReset?: () => void;\n};\n","import type { TObject } from \"alepha\";\nimport { useAlepha } from \"alepha/react\";\nimport { useEffect, useId, useMemo, useRef } from \"react\";\nimport { type FormCtrlOptions, FormModel } from \"../services/FormModel.ts\";\n\n/**\n * Custom hook to create a form with validation and field management.\n * This hook uses TypeBox schemas to define the structure and validation rules for the form.\n * It provides a way to handle form submission, field creation, and value management.\n *\n * @example\n * ```tsx\n * import { t } from \"alepha\";\n *\n * const form = useForm({\n *   schema: t.object({\n *     username: t.text(),\n *     password: t.text(),\n *   }),\n *   handler: (values) => {\n *     console.log(\"Form submitted with values:\", values);\n *   },\n * });\n *\n * return (\n *   <form {...form.props}>\n *     <input {...form.input.username.props} />\n *     <input {...form.input.password.props} />\n *     <button type=\"submit\">Submit</button>\n *   </form>\n * );\n * ```\n */\nexport const useForm = <T extends TObject>(\n  options: FormCtrlOptions<T>,\n  deps: any[] = [],\n): FormModel<T> => {\n  const alepha = useAlepha();\n  const formId = useId();\n  const initialValuesRef = useRef(options.initialValues);\n\n  const form = useMemo(() => {\n    return alepha.inject(FormModel<T>, {\n      lifetime: \"transient\",\n      args: [options.id || formId, options],\n    });\n  }, deps);\n\n  useEffect(() => {\n    if (initialValuesRef.current !== options.initialValues) {\n      initialValuesRef.current = options.initialValues;\n      if (options.initialValues) {\n        form.setInitialValues(options.initialValues as Record<string, any>);\n      }\n    }\n  }, [options.initialValues]);\n\n  return form;\n};\n","import type { TObject } from \"alepha\";\nimport { useAlepha } from \"alepha/react\";\nimport { useEffect, useState } from \"react\";\nimport type { FormModel } from \"../services/FormModel.ts\";\n\n/**\n * Hook to subscribe to all form values.\n * Re-renders on every field change — use only when needed (debug panels, live previews).\n */\nexport const useFormValues = <T extends TObject>(\n  form: FormModel<T>,\n): Record<string, any> => {\n  const alepha = useAlepha();\n  const [values, setValues] = useState<Record<string, any>>(form.currentValues);\n\n  useEffect(() => {\n    if (!alepha.isBrowser()) {\n      return;\n    }\n\n    return alepha.events.on(\"form:change\", (ev) => {\n      if (ev.id === form.id) {\n        setValues(form.currentValues);\n      }\n    });\n  }, []);\n\n  return values;\n};\n","/**\n * Converts a path or identifier string into a pretty display name.\n * For paths like \"/contacts/0/name\", extracts just the field name \"Name\".\n * Handles camelCase and snake_case conversion to Title Case.\n *\n * @example\n * prettyName(\"/userName\") // \"User Name\"\n * prettyName(\"/contacts/0/email\") // \"Email\"\n * prettyName(\"/address/streetName\") // \"Street Name\"\n * prettyName(\"first_name\") // \"First Name\"\n */\nexport const prettyName = (name: string): string => {\n  const segments = name.split(\"/\").filter((s) => s && !/^\\d+$/.test(s));\n  const fieldName = segments[segments.length - 1] || name.replaceAll(\"/\", \"\");\n  return fieldName\n    .replace(/([a-z])([A-Z])/g, \"$1 $2\")\n    .replace(/_/g, \" \")\n    .replace(/\\b\\w/g, (c) => c.toUpperCase());\n};\n","import { type TSchema, TypeBoxError } from \"alepha\";\nimport type { BaseInputField } from \"./FormModel.ts\";\nimport { prettyName } from \"./prettyName.ts\";\n\n/**\n * Semantic icon hint derived from schema metadata. UI layers map this\n * to their own icon set — this module is headless and ships no JSX.\n */\nexport type IconHint =\n  | \"email\"\n  | \"password\"\n  | \"phone\"\n  | \"url\"\n  | \"number\"\n  | \"calendar\"\n  | \"clock\"\n  | \"list\"\n  | \"text\"\n  | \"user\"\n  | \"file\"\n  | \"switch\";\n\nexport interface FieldConstraints {\n  minLength?: number;\n  maxLength?: number;\n  minimum?: number;\n  maximum?: number;\n  pattern?: string;\n}\n\nexport interface FieldMeta {\n  id?: string;\n  label: string;\n  description?: string;\n  error?: string;\n  required: boolean;\n  type?: string;\n  format?: string;\n  isEnum: boolean;\n  isArray: boolean;\n  isObject: boolean;\n  isArrayOfObjects: boolean;\n  enum?: readonly unknown[];\n  iconHint?: IconHint;\n  constraints: FieldConstraints;\n  testId?: string;\n  schema: TSchema;\n  /**\n   * Raw `$control` value from the schema, untyped here. The UI layer\n   * (`alepha/react/ui`) provides the strict {@link SchemaControl} type and\n   * a `resolveSchemaControl` helper to evaluate the function form.\n   */\n  control?: unknown;\n}\n\nexport interface ParseFieldOptions {\n  label?: string;\n  description?: string;\n  error?: Error;\n}\n\n/**\n * Derives a {@link FieldMeta} from an `InputField` (from `useForm`) plus\n * optional overrides. Pure — no React, no JSX, no UI library coupling.\n *\n * UI components consume this metadata to render labels, descriptions,\n * error messages, icons, and validation constraints.\n */\nexport const parseField = (\n  input: BaseInputField,\n  options: ParseFieldOptions = {},\n): FieldMeta => {\n  const schema = input.schema as TSchema & {\n    type?: string;\n    format?: string;\n    title?: string;\n    description?: string;\n    enum?: readonly unknown[];\n    minLength?: number;\n    maxLength?: number;\n    minimum?: number;\n    maximum?: number;\n    pattern?: string;\n    properties?: unknown;\n    items?: { properties?: unknown };\n    $control?: unknown;\n  };\n\n  const label =\n    options.label ??\n    (typeof schema.title === \"string\" ? schema.title : undefined) ??\n    prettyName(input.path);\n\n  const description =\n    options.description ??\n    (typeof schema.description === \"string\" ? schema.description : undefined);\n\n  const error =\n    options.error instanceof TypeBoxError\n      ? (options.error as TypeBoxError).value?.message\n      : undefined;\n\n  const type = schema.type;\n  const format = typeof schema.format === \"string\" ? schema.format : undefined;\n  const isEnum = Array.isArray(schema.enum);\n  const isArray = type === \"array\";\n  const isObject = type === \"object\" && Boolean(schema.properties);\n  const isArrayOfObjects =\n    isArray && Boolean(schema.items && (schema.items as any).properties);\n\n  const name = input.props.name;\n  const iconHint = inferIconHint({ type, format, name, isEnum, isArray });\n\n  const constraints: FieldConstraints = {};\n  if (typeof schema.minLength === \"number\")\n    constraints.minLength = schema.minLength;\n  if (typeof schema.maxLength === \"number\")\n    constraints.maxLength = schema.maxLength;\n  if (typeof schema.minimum === \"number\") constraints.minimum = schema.minimum;\n  if (typeof schema.maximum === \"number\") constraints.maximum = schema.maximum;\n  if (typeof schema.pattern === \"string\") constraints.pattern = schema.pattern;\n\n  return {\n    id: input.props.id,\n    label,\n    description,\n    error,\n    required: input.required,\n    type,\n    format,\n    isEnum,\n    isArray,\n    isObject,\n    isArrayOfObjects,\n    enum: schema.enum,\n    iconHint,\n    constraints,\n    testId: (input.props as Record<string, unknown>)[\"data-testid\"] as\n      | string\n      | undefined,\n    schema: input.schema,\n    control: schema.$control,\n  };\n};\n\nconst inferIconHint = (params: {\n  type?: string;\n  format?: string;\n  name?: string;\n  isEnum: boolean;\n  isArray: boolean;\n}): IconHint | undefined => {\n  const { type, format, name, isEnum, isArray } = params;\n\n  if (format === \"email\") return \"email\";\n  if (format === \"url\" || format === \"uri\") return \"url\";\n  if (format === \"tel\" || format === \"phone\") return \"phone\";\n  if (format === \"date\" || format === \"date-time\") return \"calendar\";\n  if (format === \"time\") return \"clock\";\n\n  if (name?.toLowerCase().includes(\"password\")) return \"password\";\n  if (name?.toLowerCase().includes(\"email\")) return \"email\";\n  if (name?.toLowerCase().includes(\"phone\")) return \"phone\";\n\n  if (type === \"boolean\") return \"switch\";\n  if (type === \"number\" || type === \"integer\") return \"number\";\n  if (isEnum || isArray) return \"list\";\n  if (type === \"string\") return \"text\";\n\n  return undefined;\n};\n","import { $module } from \"alepha\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport { default as FormState } from \"./components/FormState.tsx\";\nexport * from \"./errors/FormValidationError.ts\";\nexport * from \"./hooks/useFieldValue.ts\";\nexport * from \"./hooks/useForm.ts\";\nexport * from \"./hooks/useFormState.ts\";\nexport * from \"./hooks/useFormValues.ts\";\nexport * from \"./services/FormModel.ts\";\nexport * from \"./services/parseField.ts\";\nexport * from \"./services/prettyName.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\ndeclare module \"alepha\" {\n  interface Hooks {\n    \"form:change\": { id: string; path: string; value: any };\n    \"form:submit:begin\": { id: string };\n    \"form:submit:success\": { id: string; values: Record<string, any> };\n    \"form:submit:error\": { id: string; error: Error };\n    \"form:submit:end\": { id: string };\n    \"form:reset\": { id: string };\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Type-safe forms with validation.\n *\n * **Features:**\n * - Form state management\n * - TypeBox schema validation\n * - Field-level error handling\n * - Submit handling with loading state\n * - Form reset\n *\n * @module alepha.react.form\n */\nexport const AlephaReactForm = $module({\n  name: \"alepha.react.form\",\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/react/form/hooks/useFormState.ts","../../../src/react/form/components/FormState.tsx","../../../src/react/form/errors/FormValidationError.ts","../../../src/react/form/hooks/useFieldValue.ts","../../../src/react/form/services/FormModel.ts","../../../src/react/form/hooks/useForm.ts","../../../src/react/form/hooks/useFormValues.ts","../../../src/react/form/services/prettyName.ts","../../../src/react/form/services/parseField.ts","../../../src/react/form/index.ts"],"sourcesContent":["import { type TObject, TypeBoxError } from \"alepha\";\nimport { useAlepha } from \"alepha/react\";\nimport { useEffect, useState } from \"react\";\nimport type { FormModel } from \"../services/FormModel.ts\";\n\nexport interface UseFormStateReturn {\n  loading: boolean;\n  dirty: boolean;\n  values?: Record<string, any>;\n  error?: Error;\n}\n\nexport const useFormState = <\n  T extends TObject,\n  Keys extends keyof UseFormStateReturn,\n>(\n  target: FormModel<T> | { form: FormModel<T>; path: string },\n  _events: Keys[] = [\"loading\", \"dirty\", \"error\"] as Keys[],\n): Pick<UseFormStateReturn, Keys> => {\n  const alepha = useAlepha();\n  const events = _events as string[];\n\n  const [dirty, setDirty] = useState(false);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | undefined>(undefined);\n  const [values, setValues] = useState<Record<string, any> | undefined>(\n    undefined,\n  );\n\n  const form = \"form\" in target ? target.form : target;\n  const path = \"path\" in target ? target.path : undefined;\n\n  const hasValues = events.includes(\"values\");\n  const hasErrors = events.includes(\"error\");\n  const hasDirty = events.includes(\"dirty\");\n  const hasLoading = events.includes(\"loading\");\n\n  useEffect(() => {\n    const listeners: Function[] = [];\n\n    if (hasErrors || hasValues || hasDirty) {\n      listeners.push(\n        alepha.events.on(\"form:change\", (event) => {\n          if (event.id === form.id) {\n            if (!path || event.path === path) {\n              // `initial: true` marks a programmatic reset (e.g. parent\n              // re-rendering with fresh data via `setInitialValues`). Treat\n              // it like a reset: clear dirty, don't mark dirty.\n              if (hasDirty) {\n                if (event.initial) {\n                  setDirty(false);\n                } else {\n                  setDirty(true);\n                }\n              }\n              if (hasErrors) {\n                setError(undefined);\n              }\n            }\n            if (hasValues) {\n              setValues(form.currentValues);\n            }\n          }\n        }),\n      );\n    }\n\n    if (hasLoading) {\n      listeners.push(\n        alepha.events.on(\"form:submit:begin\", (event) => {\n          if (event.id === form.id) {\n            setLoading(true);\n          }\n        }),\n        alepha.events.on(\"form:submit:end\", (event) => {\n          if (event.id === form.id) {\n            setLoading(false);\n          }\n        }),\n      );\n    }\n\n    if (hasValues || hasDirty) {\n      listeners.push(\n        alepha.events.on(\"form:submit:success\", (event) => {\n          if (event.id === form.id) {\n            if (hasValues) {\n              setValues(event.values);\n            }\n            if (hasDirty) {\n              setDirty(false);\n            }\n          }\n        }),\n      );\n    }\n\n    if (hasDirty) {\n      listeners.push(\n        alepha.events.on(\"form:reset\", (event) => {\n          if (event.id === form.id) {\n            setDirty(false);\n          }\n        }),\n      );\n    }\n\n    if (hasErrors) {\n      listeners.push(\n        alepha.events.on(\"form:submit:error\", (event) => {\n          if (event.id === form.id) {\n            if (\n              !path ||\n              (event.error instanceof TypeBoxError &&\n                event.error.value.path === path)\n            ) {\n              setError(event.error);\n            }\n          }\n        }),\n      );\n    }\n\n    return () => {\n      for (const unsub of listeners) {\n        unsub();\n      }\n    };\n  }, []);\n\n  return {\n    dirty,\n    loading,\n    error,\n    values,\n  } as Pick<UseFormStateReturn, Keys>;\n};\n","import type { TObject } from \"alepha\";\nimport type { ReactNode } from \"react\";\nimport { useFormState } from \"../hooks/useFormState.ts\";\nimport type { FormModel } from \"../services/FormModel.ts\";\n\nconst FormState = <T extends TObject>(props: {\n  form: FormModel<T>;\n  children: (state: { loading: boolean; dirty: boolean }) => ReactNode;\n}) => {\n  const formState = useFormState(props.form);\n  return props.children({\n    loading: formState.loading,\n    dirty: formState.dirty,\n  });\n};\n\nexport default FormState;\n","import { TypeBoxError } from \"alepha\";\n\nexport class FormValidationError extends TypeBoxError {\n  readonly name = \"ValidationError\";\n\n  constructor(options: {\n    message: string;\n    path: string;\n  }) {\n    super({\n      message: options.message,\n      instancePath: options.path,\n      schemaPath: \"\",\n      keyword: \"not\",\n      params: {},\n    });\n  }\n}\n","import { useAlepha } from \"alepha/react\";\nimport { useEffect, useState } from \"react\";\nimport type { BaseInputField } from \"../services/FormModel.ts\";\n\n/**\n * Hook to subscribe to a single form field's value.\n * Only re-renders when this specific field changes.\n *\n * @returns A tuple of [value, setValue] similar to useState.\n */\nexport const useFieldValue = (\n  input: BaseInputField,\n): [any, (value: any) => void] => {\n  const alepha = useAlepha();\n  const [value, setValue] = useState(input?.initialValue);\n\n  useEffect(() => {\n    if (!input?.form || !alepha.isBrowser()) {\n      return;\n    }\n\n    return alepha.events.on(\"form:change\", (ev) => {\n      if (ev.id === input.form.id && ev.path === input.path) {\n        setValue(ev.value);\n      }\n    });\n  }, []);\n\n  const setFieldValue = (newValue: any) => {\n    input.set(newValue);\n  };\n\n  return [value, setFieldValue];\n};\n","import type { TArray } from \"alepha\";\nimport {\n  $inject,\n  Alepha,\n  type Static,\n  type TObject,\n  type TSchema,\n  t,\n} from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport type { InputHTMLAttributes } from \"react\";\n\n/**\n * FormModel is a dynamic form handler that generates form inputs based on a provided TypeBox schema.\n * It manages form state, handles input changes, and processes form submissions with validation.\n *\n * It means to be injected and used within React components to provide a structured way to create and manage forms.\n *\n * @see {@link useForm}\n */\nexport class FormModel<T extends TObject> {\n  protected readonly log = $logger();\n  protected readonly alepha = $inject(Alepha);\n  protected readonly values: Record<string, any> = {};\n  protected readonly initialValues: Record<string, any> = {};\n  protected submitInProgress = false;\n\n  public input: SchemaToInput<T>;\n\n  public get submitting(): boolean {\n    return this.submitInProgress;\n  }\n\n  constructor(\n    public readonly id: string,\n    public readonly options: FormCtrlOptions<T>,\n  ) {\n    this.options = options;\n\n    // Initialize with schema defaults first, then override with initialValues\n    const schemaDefaults = this.extractSchemaDefaults(options.schema);\n    if (Object.keys(schemaDefaults).length > 0) {\n      Object.assign(this.values, schemaDefaults);\n    }\n\n    if (options.initialValues) {\n      // Decode against a partial of the schema so callers can supply incomplete\n      // initial values (the form's whole job is to collect them). Codecs still\n      // run on whatever's provided; missing fields stay undefined and only the\n      // full schema is enforced at submit time.\n      const decoded = this.alepha.codec.decode(\n        t.partial(options.schema),\n        options.initialValues,\n      ) as Record<string, any>;\n      Object.assign(this.values, decoded);\n    }\n\n    this.initialValues = { ...this.values };\n\n    this.input = this.createProxyFromSchema(options, options.schema, {\n      store: this.values,\n      parent: \"\",\n    });\n  }\n\n  /**\n   * Extract default values from a TypeBox schema.\n   * Recursively handles nested objects.\n   */\n  protected extractSchemaDefaults(\n    schema: TObject,\n    prefix: string = \"\",\n  ): Record<string, any> {\n    const defaults: Record<string, any> = {};\n\n    if (!schema.properties) {\n      return defaults;\n    }\n\n    for (const [key, propSchema] of Object.entries(schema.properties)) {\n      const fullKey = prefix ? `${prefix}.${key}` : key;\n\n      if (\"default\" in propSchema && propSchema.default !== undefined) {\n        defaults[fullKey] = propSchema.default;\n      } else if (\n        propSchema &&\n        \"type\" in propSchema &&\n        propSchema.type === \"object\" &&\n        \"properties\" in propSchema\n      ) {\n        // Recursively extract defaults from nested objects\n        const nestedDefaults = this.extractSchemaDefaults(\n          propSchema as TObject,\n          fullKey,\n        );\n        Object.assign(defaults, nestedDefaults);\n      }\n    }\n\n    return defaults;\n  }\n\n  public get currentValues(): Record<string, any> {\n    return this.restructureValues(this.values);\n  }\n\n  public get props() {\n    return {\n      id: this.id,\n      noValidate: true,\n      onSubmit: (ev?: FormEventLike) => {\n        ev?.preventDefault?.();\n        this.submit();\n      },\n      onReset: (event: FormEventLike) => this.reset(event),\n    };\n  }\n\n  public readonly setInitialValues = (values: Record<string, any>) => {\n    // Same partial-decode rationale as the constructor — initial values may be\n    // incomplete; full schema is enforced only at submit time.\n    const decoded = this.alepha.codec.decode(\n      t.partial(this.options.schema),\n      values,\n    ) as Record<string, any>;\n\n    for (const key in this.initialValues) {\n      delete (this.initialValues as Record<string, any>)[key];\n    }\n    Object.assign(this.initialValues, decoded);\n\n    for (const key in this.values) {\n      delete this.values[key];\n    }\n    Object.assign(this.values, { ...this.initialValues });\n\n    for (const [key, value] of Object.entries(this.values)) {\n      const path = `/${key.replaceAll(\".\", \"/\")}`;\n      this.alepha.events.emit(\n        \"form:change\",\n        { id: this.id, path, value, initial: true },\n        { catch: true },\n      );\n    }\n  };\n\n  public readonly reset = (event?: FormEventLike) => {\n    event?.preventDefault?.();\n    // Snapshot all keys that need notification — both keys present\n    // before reset (so subscribers learn the cleared value) and keys\n    // restored from initialValues. Without the union, fields that were\n    // typed but absent from initialValues stay visually stale.\n    const keys = new Set<string>([\n      ...Object.keys(this.values),\n      ...Object.keys(this.initialValues),\n    ]);\n    for (const key in this.values) {\n      delete this.values[key];\n    }\n    Object.assign(this.values, { ...this.initialValues });\n    for (const key of keys) {\n      const path = `/${key.replaceAll(\".\", \"/\")}`;\n      this.alepha.events.emit(\n        \"form:change\",\n        { id: this.id, path, value: this.values[key] },\n        { catch: true },\n      );\n    }\n    this.alepha.events.emit(\"form:reset\", { id: this.id }, { catch: true });\n    this.options.onReset?.();\n  };\n\n  public readonly submit = async () => {\n    if (this.submitInProgress) {\n      this.log.warn(\n        \"Form submission already in progress, ignoring duplicate submit.\",\n      );\n      return;\n    }\n\n    // emit both action and form events\n    await this.alepha.events.emit(\"react:action:begin\", {\n      type: \"form\",\n      id: this.id,\n    });\n    await this.alepha.events.emit(\"form:submit:begin\", {\n      id: this.id,\n    });\n\n    this.submitInProgress = true;\n\n    const options = this.options;\n\n    try {\n      let values: Record<string, any> = this.restructureValues(this.values);\n\n      if (t.schema.isSchema(options.schema)) {\n        values = this.alepha.codec.decode(options.schema, values) as Record<\n          string,\n          any\n        >;\n      }\n\n      await options.handler(values as any);\n\n      await this.alepha.events.emit(\"react:action:success\", {\n        type: \"form\",\n        id: this.id,\n      });\n      await this.alepha.events.emit(\"form:submit:success\", {\n        id: this.id,\n        values,\n      });\n    } catch (error) {\n      this.log.error(\"Form submission error:\", error);\n\n      options.onError?.(error as Error);\n\n      await this.alepha.events.emit(\"react:action:error\", {\n        type: \"form\",\n        id: this.id,\n        error: error as Error,\n      });\n      await this.alepha.events.emit(\"form:submit:error\", {\n        error: error as Error,\n        id: this.id,\n      });\n    } finally {\n      this.submitInProgress = false;\n    }\n\n    await this.alepha.events.emit(\"react:action:end\", {\n      type: \"form\",\n      id: this.id,\n    });\n    await this.alepha.events.emit(\"form:submit:end\", {\n      id: this.id,\n    });\n  };\n\n  /**\n   * Restructures flat keys like \"address.city\" into nested objects like { address: { city: ... } }\n   * Values are already typed from onChange, so no conversion is needed.\n   */\n  protected restructureValues(store: Record<string, any>): Record<string, any> {\n    const values: Record<string, any> = {};\n\n    for (const [key, value] of Object.entries(store)) {\n      if (key.includes(\".\")) {\n        // nested object: restructure flat key to nested structure\n        this.restructureNestedValue(values, key, value);\n      } else {\n        // value is already typed, just copy it\n        values[key] = value;\n      }\n    }\n\n    return values;\n  }\n\n  /**\n   * Helper to restructure a flat key like \"address.city\" into nested object structure.\n   * The value is already typed, so we just assign it to the nested path.\n   */\n  protected restructureNestedValue(\n    values: Record<string, any>,\n    key: string,\n    value: any,\n  ) {\n    const pathSegments = key.split(\".\");\n    const finalPropertyKey = pathSegments.pop();\n    if (!finalPropertyKey) {\n      return;\n    }\n\n    let currentObjectLevel = values;\n\n    // traverse/create the nested structure\n    for (const segment of pathSegments) {\n      currentObjectLevel[segment] ??= {};\n      currentObjectLevel = currentObjectLevel[segment];\n    }\n\n    // value is already typed from onChange, just assign it\n    currentObjectLevel[finalPropertyKey] = value;\n  }\n\n  protected createProxyFromSchema<T extends TObject>(\n    options: FormCtrlOptions<T>,\n    schema: TSchema,\n    context: {\n      parent: string;\n      store: Record<string, any>;\n    },\n  ): SchemaToInput<T> {\n    const parent = context.parent || \"\";\n    return new Proxy<SchemaToInput<T>>({} as SchemaToInput<T>, {\n      get: (_, prop: string) => {\n        if (!options.schema || !t.schema.isObject(schema)) {\n          return {};\n        }\n\n        if (prop in schema.properties) {\n          // // it's a nested object, create another proxy\n          // if (t.schema.isObject(schema.properties[prop])) {\n          //   return this.createProxyFromSchema(\n          //     options,\n          //     schema.properties[prop],\n          //     {\n          //       parent: parent ? `${parent}.${prop}` : prop,\n          //       store: context.store,\n          //     },\n          //   );\n          // }\n\n          return this.createInputFromSchema<T>(\n            prop as keyof Static<T> & string,\n            options,\n            schema,\n            schema.required?.includes(prop as string) || false,\n            context,\n          );\n        }\n      },\n    });\n  }\n\n  protected createInputFromSchema<T extends TObject>(\n    name: keyof Static<T> & string,\n    options: FormCtrlOptions<T>,\n    schema: TObject,\n    required: boolean,\n    context: {\n      parent: string;\n      store: Record<string, any>;\n    },\n  ): BaseInputField {\n    const parent = context.parent || \"\";\n    const field = schema.properties?.[name];\n    if (!field) {\n      return {\n        path: \"\",\n        required,\n        initialValue: undefined,\n        props: {} as InputHTMLAttributes<unknown>,\n        schema: schema,\n        set: () => {},\n        form: this,\n      };\n    }\n\n    const isRequired = schema.required?.includes(name) ?? false;\n    const key = parent ? `${parent}.${name}` : name;\n    const path = `/${key.replaceAll(\".\", \"/\")}`;\n\n    const set = (value: any) => {\n      const typedValue = this.getValueFromInput(value, field);\n      context.store[key] = typedValue;\n      if (options.onChange) {\n        options.onChange(key, typedValue, context.store);\n      }\n      this.alepha.events.emit(\n        \"form:change\",\n        { id: this.id, path: path, value: typedValue },\n        { catch: true },\n      );\n    };\n\n    const attr: InputHTMLAttributesLike = {\n      name: key,\n    };\n\n    // Use the form's runtime id (always set — comes from `useId()` when\n    // no explicit `options.id` was provided). This guarantees stable\n    // per-field DOM ids without forcing callers to pass `id`.\n    attr.id = `${this.id}-${key}`;\n    (attr as any)[\"data-testid\"] = attr.id;\n\n    if (t.schema.isString(field)) {\n      if (field.maxLength != null) {\n        attr.maxLength = Number(field.maxLength);\n      }\n\n      if (field.minLength != null) {\n        attr.minLength = Number(field.minLength);\n      }\n    }\n\n    if (isRequired) {\n      attr.required = true;\n    }\n\n    if (\"description\" in field && typeof field.description === \"string\") {\n      attr[\"aria-label\"] = field.description;\n    }\n\n    if (t.schema.isInteger(field) || t.schema.isNumber(field)) {\n      attr.type = \"number\";\n    } else if (name === \"password\") {\n      attr.type = \"password\";\n    } else if (name === \"email\") {\n      attr.type = \"email\";\n    } else if (name === \"url\") {\n      attr.type = \"url\";\n    } else if (t.schema.isString(field)) {\n      if (field.format === \"binary\") {\n        attr.type = \"file\";\n      } else if (field.format === \"date\") {\n        attr.type = \"date\";\n      } else if (field.format === \"time\") {\n        attr.type = \"time\";\n      } else if (field.format === \"date-time\") {\n        attr.type = \"datetime-local\";\n      } else {\n        attr.type = \"text\";\n      }\n    } else if (t.schema.isBoolean(field)) {\n      attr.type = \"checkbox\";\n    }\n\n    if (options.onCreateField) {\n      const customAttr = options.onCreateField(name, field);\n      Object.assign(attr, customAttr);\n    }\n\n    // if type = object, add items: { [key: string]: InputField }\n    if (t.schema.isObject(field)) {\n      return {\n        path,\n        props: attr,\n        schema: field,\n        set,\n        form: this,\n        required,\n        initialValue: context.store[key],\n        items: this.createProxyFromSchema(options, field, {\n          parent: key,\n          store: context.store,\n        }),\n      } as ObjectInputField<any>;\n    }\n\n    // if type = array, add items: InputField[]\n    if (t.schema.isArray(field)) {\n      return {\n        path,\n        props: attr,\n        schema: field,\n        set,\n        form: this,\n        required,\n        initialValue: context.store[key],\n        items: [], // <- will be populated dynamically in the UI\n      } as ArrayInputField<any>;\n    }\n\n    return {\n      path,\n      props: attr,\n      schema: field,\n      set,\n      form: this,\n      required,\n      initialValue: context.store[key],\n    };\n  }\n\n  /**\n   * Convert an input value to the correct type based on the schema.\n   * Handles raw DOM values (strings, booleans from checkboxes, Files, etc.)\n   */\n  protected getValueFromInput(input: any, schema: TSchema): any {\n    if (input instanceof File) {\n      // for file inputs, return the File object directly\n      if (t.schema.isString(schema) && schema.format === \"binary\") {\n        return input;\n      }\n      // for now, ignore other formats\n      return null;\n    }\n\n    if (t.schema.isBoolean(schema)) {\n      // Handle string representations from Select components (Yes/No dropdown)\n      if (input === \"true\") return true;\n      if (input === \"false\") return false;\n      if (input === \"\" || input === null || input === undefined)\n        return undefined;\n      // Handle actual boolean values\n      return !!input;\n    }\n\n    if (t.schema.isNumber(schema)) {\n      const num = Number(input);\n      return Number.isNaN(num) ? null : num;\n    }\n\n    if (t.schema.isString(schema)) {\n      if (schema.format === \"date\") {\n        return new Date(input).toISOString().slice(0, 10); // For date input\n      }\n      if (schema.format === \"time\") {\n        return new Date(`1970-01-01T${input}`).toISOString().slice(11, 16); // For time input\n      }\n      if (schema.format === \"date-time\") {\n        return new Date(input).toISOString(); // For datetime-local input\n      }\n      return String(input);\n    }\n\n    return input; // fallback for other types\n  }\n}\n\nexport type SchemaToInput<T extends TObject> = {\n  [K in keyof T[\"properties\"]]: InputField<T[\"properties\"][K]>;\n};\n\nexport interface FormEventLike {\n  preventDefault?: () => void;\n  stopPropagation?: () => void;\n}\n\nexport type InputField<T extends TSchema> = T extends TObject\n  ? ObjectInputField<T>\n  : T extends TArray<infer U>\n    ? ArrayInputField<U>\n    : BaseInputField;\n\nexport interface BaseInputField {\n  path: string;\n  required: boolean;\n  initialValue: any;\n  props: InputHTMLAttributesLike;\n  schema: TSchema;\n  set: (value: any) => void;\n  form: FormModel<any>;\n  items?: any;\n}\n\nexport interface ObjectInputField<T extends TObject> extends BaseInputField {\n  items: SchemaToInput<T>;\n}\n\nexport interface ArrayInputField<T extends TSchema> extends BaseInputField {\n  items: Array<InputField<T>>;\n}\n\nexport type InputHTMLAttributesLike = Pick<\n  InputHTMLAttributes<unknown>,\n  | \"id\"\n  | \"name\"\n  | \"type\"\n  | \"value\"\n  | \"required\"\n  | \"maxLength\"\n  | \"minLength\"\n  | \"aria-label\"\n> & {\n  value?: any;\n};\n\nexport type FormCtrlOptions<T extends TObject> = {\n  /**\n   * The schema defining the structure and validation rules for the form.\n   * This should be a TypeBox schema object.\n   */\n  schema: T;\n\n  /**\n   * Callback function to handle form submission.\n   * This function will receive the parsed and validated form values.\n   */\n  handler: (values: Static<T>) => unknown;\n\n  /**\n   * Optional initial values for the form fields.\n   * This can be used to pre-populate the form with existing data.\n   */\n  initialValues?: Partial<Static<T>>;\n\n  /**\n   * Optional function to create custom field attributes.\n   * This can be used to add custom validation, styles, or other attributes.\n   */\n  onCreateField?: (\n    name: keyof Static<T> & string,\n    schema: TSchema,\n  ) => InputHTMLAttributes<unknown>;\n\n  /**\n   * If defined, this will generate a unique ID for each field, prefixed with this string.\n   *\n   * > \"username\" with id=\"form-123\" will become \"form-123-username\".\n   *\n   * If omitted, IDs will not be generated.\n   */\n  id?: string;\n\n  onError?: (error: Error) => void;\n\n  onChange?: (key: string, value: any, store: Record<string, any>) => void;\n\n  onReset?: () => void;\n};\n","import type { TObject } from \"alepha\";\nimport { useAlepha } from \"alepha/react\";\nimport { useEffect, useId, useMemo, useRef } from \"react\";\nimport { type FormCtrlOptions, FormModel } from \"../services/FormModel.ts\";\n\n/**\n * Custom hook to create a form with validation and field management.\n * This hook uses TypeBox schemas to define the structure and validation rules for the form.\n * It provides a way to handle form submission, field creation, and value management.\n *\n * @example\n * ```tsx\n * import { t } from \"alepha\";\n *\n * const form = useForm({\n *   schema: t.object({\n *     username: t.text(),\n *     password: t.text(),\n *   }),\n *   handler: (values) => {\n *     console.log(\"Form submitted with values:\", values);\n *   },\n * });\n *\n * return (\n *   <form {...form.props}>\n *     <input {...form.input.username.props} />\n *     <input {...form.input.password.props} />\n *     <button type=\"submit\">Submit</button>\n *   </form>\n * );\n * ```\n */\nexport const useForm = <T extends TObject>(\n  options: FormCtrlOptions<T>,\n  deps: any[] = [],\n): FormModel<T> => {\n  const alepha = useAlepha();\n  const formId = useId();\n  const initialValuesRef = useRef(options.initialValues);\n\n  const form = useMemo(() => {\n    return alepha.inject(FormModel<T>, {\n      lifetime: \"transient\",\n      args: [options.id || formId, options],\n    });\n  }, deps);\n\n  useEffect(() => {\n    if (initialValuesRef.current !== options.initialValues) {\n      initialValuesRef.current = options.initialValues;\n      if (options.initialValues) {\n        form.setInitialValues(options.initialValues as Record<string, any>);\n      }\n    }\n  }, [options.initialValues]);\n\n  return form;\n};\n","import type { TObject } from \"alepha\";\nimport { useAlepha } from \"alepha/react\";\nimport { useEffect, useState } from \"react\";\nimport type { FormModel } from \"../services/FormModel.ts\";\n\n/**\n * Hook to subscribe to all form values.\n * Re-renders on every field change — use only when needed (debug panels, live previews).\n */\nexport const useFormValues = <T extends TObject>(\n  form: FormModel<T>,\n): Record<string, any> => {\n  const alepha = useAlepha();\n  const [values, setValues] = useState<Record<string, any>>(form.currentValues);\n\n  useEffect(() => {\n    if (!alepha.isBrowser()) {\n      return;\n    }\n\n    return alepha.events.on(\"form:change\", (ev) => {\n      if (ev.id === form.id) {\n        setValues(form.currentValues);\n      }\n    });\n  }, []);\n\n  return values;\n};\n","/**\n * Converts a path or identifier string into a pretty display name.\n * For paths like \"/contacts/0/name\", extracts just the field name \"Name\".\n * Handles camelCase and snake_case conversion to Title Case.\n *\n * @example\n * prettyName(\"/userName\") // \"User Name\"\n * prettyName(\"/contacts/0/email\") // \"Email\"\n * prettyName(\"/address/streetName\") // \"Street Name\"\n * prettyName(\"first_name\") // \"First Name\"\n */\nexport const prettyName = (name: string): string => {\n  const segments = name.split(\"/\").filter((s) => s && !/^\\d+$/.test(s));\n  const fieldName = segments[segments.length - 1] || name.replaceAll(\"/\", \"\");\n  return fieldName\n    .replace(/([a-z])([A-Z])/g, \"$1 $2\")\n    .replace(/_/g, \" \")\n    .replace(/\\b\\w/g, (c) => c.toUpperCase());\n};\n","import { type TSchema, TypeBoxError } from \"alepha\";\nimport type { BaseInputField } from \"./FormModel.ts\";\nimport { prettyName } from \"./prettyName.ts\";\n\n/**\n * Semantic icon hint derived from schema metadata. UI layers map this\n * to their own icon set — this module is headless and ships no JSX.\n */\nexport type IconHint =\n  | \"email\"\n  | \"password\"\n  | \"phone\"\n  | \"url\"\n  | \"number\"\n  | \"calendar\"\n  | \"clock\"\n  | \"list\"\n  | \"text\"\n  | \"user\"\n  | \"file\"\n  | \"switch\";\n\nexport interface FieldConstraints {\n  minLength?: number;\n  maxLength?: number;\n  minimum?: number;\n  maximum?: number;\n  pattern?: string;\n}\n\nexport interface FieldMeta {\n  id?: string;\n  label: string;\n  description?: string;\n  error?: string;\n  required: boolean;\n  type?: string;\n  format?: string;\n  isEnum: boolean;\n  isArray: boolean;\n  isObject: boolean;\n  isArrayOfObjects: boolean;\n  enum?: readonly unknown[];\n  iconHint?: IconHint;\n  constraints: FieldConstraints;\n  testId?: string;\n  schema: TSchema;\n  /**\n   * Raw `$control` value from the schema, untyped here. The UI layer\n   * (`alepha/react/ui`) provides the strict {@link SchemaControl} type and\n   * a `resolveSchemaControl` helper to evaluate the function form.\n   */\n  control?: unknown;\n}\n\nexport interface ParseFieldOptions {\n  label?: string;\n  description?: string;\n  error?: Error;\n}\n\n/**\n * Derives a {@link FieldMeta} from an `InputField` (from `useForm`) plus\n * optional overrides. Pure — no React, no JSX, no UI library coupling.\n *\n * UI components consume this metadata to render labels, descriptions,\n * error messages, icons, and validation constraints.\n */\nexport const parseField = (\n  input: BaseInputField,\n  options: ParseFieldOptions = {},\n): FieldMeta => {\n  const schema = input.schema as TSchema & {\n    type?: string;\n    format?: string;\n    title?: string;\n    description?: string;\n    enum?: readonly unknown[];\n    minLength?: number;\n    maxLength?: number;\n    minimum?: number;\n    maximum?: number;\n    pattern?: string;\n    properties?: unknown;\n    items?: { properties?: unknown };\n    $control?: unknown;\n  };\n\n  const label =\n    options.label ??\n    (typeof schema.title === \"string\" ? schema.title : undefined) ??\n    prettyName(input.path);\n\n  const description =\n    options.description ??\n    (typeof schema.description === \"string\" ? schema.description : undefined);\n\n  const error =\n    options.error instanceof TypeBoxError\n      ? (options.error as TypeBoxError).value?.message\n      : undefined;\n\n  const type = schema.type;\n  const format = typeof schema.format === \"string\" ? schema.format : undefined;\n  const isEnum = Array.isArray(schema.enum);\n  const isArray = type === \"array\";\n  const isObject = type === \"object\" && Boolean(schema.properties);\n  const isArrayOfObjects =\n    isArray && Boolean(schema.items && (schema.items as any).properties);\n\n  const name = input.props.name;\n  const iconHint = inferIconHint({ type, format, name, isEnum, isArray });\n\n  const constraints: FieldConstraints = {};\n  if (typeof schema.minLength === \"number\")\n    constraints.minLength = schema.minLength;\n  if (typeof schema.maxLength === \"number\")\n    constraints.maxLength = schema.maxLength;\n  if (typeof schema.minimum === \"number\") constraints.minimum = schema.minimum;\n  if (typeof schema.maximum === \"number\") constraints.maximum = schema.maximum;\n  if (typeof schema.pattern === \"string\") constraints.pattern = schema.pattern;\n\n  return {\n    id: input.props.id,\n    label,\n    description,\n    error,\n    required: input.required,\n    type,\n    format,\n    isEnum,\n    isArray,\n    isObject,\n    isArrayOfObjects,\n    enum: schema.enum,\n    iconHint,\n    constraints,\n    testId: (input.props as Record<string, unknown>)[\"data-testid\"] as\n      | string\n      | undefined,\n    schema: input.schema,\n    control: schema.$control,\n  };\n};\n\nconst inferIconHint = (params: {\n  type?: string;\n  format?: string;\n  name?: string;\n  isEnum: boolean;\n  isArray: boolean;\n}): IconHint | undefined => {\n  const { type, format, name, isEnum, isArray } = params;\n\n  if (format === \"email\") return \"email\";\n  if (format === \"url\" || format === \"uri\") return \"url\";\n  if (format === \"tel\" || format === \"phone\") return \"phone\";\n  if (format === \"date\" || format === \"date-time\") return \"calendar\";\n  if (format === \"time\") return \"clock\";\n\n  if (name?.toLowerCase().includes(\"password\")) return \"password\";\n  if (name?.toLowerCase().includes(\"email\")) return \"email\";\n  if (name?.toLowerCase().includes(\"phone\")) return \"phone\";\n\n  if (type === \"boolean\") return \"switch\";\n  if (type === \"number\" || type === \"integer\") return \"number\";\n  if (isEnum || isArray) return \"list\";\n  if (type === \"string\") return \"text\";\n\n  return undefined;\n};\n","import { $module } from \"alepha\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport { default as FormState } from \"./components/FormState.tsx\";\nexport * from \"./errors/FormValidationError.ts\";\nexport * from \"./hooks/useFieldValue.ts\";\nexport * from \"./hooks/useForm.ts\";\nexport * from \"./hooks/useFormState.ts\";\nexport * from \"./hooks/useFormValues.ts\";\nexport * from \"./services/FormModel.ts\";\nexport * from \"./services/parseField.ts\";\nexport * from \"./services/prettyName.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\ndeclare module \"alepha\" {\n  interface Hooks {\n    \"form:change\": {\n      id: string;\n      path: string;\n      value: any;\n      /**\n       * Programmatic reset (e.g. `setInitialValues` after the parent updates\n       * its state). Subscribers tracking dirty state should ignore these.\n       */\n      initial?: boolean;\n    };\n    \"form:submit:begin\": { id: string };\n    \"form:submit:success\": { id: string; values: Record<string, any> };\n    \"form:submit:error\": { id: string; error: Error };\n    \"form:submit:end\": { id: string };\n    \"form:reset\": { id: string };\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Type-safe forms with validation.\n *\n * **Features:**\n * - Form state management\n * - TypeBox schema validation\n * - Field-level error handling\n * - Submit handling with loading state\n * - Form reset\n *\n * @module alepha.react.form\n */\nexport const AlephaReactForm = $module({\n  name: \"alepha.react.form\",\n});\n"],"mappings":"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"}

package/dist/react/head/index.browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.browser.js","names":[],"sources":["../../../src/react/head/helpers/SeoExpander.ts","../../../src/react/head/providers/HeadProvider.ts","../../../src/react/head/primitives/$head.ts","../../../src/react/head/providers/BrowserHeadProvider.ts","../../../src/react/head/hooks/useHead.ts","../../../src/react/head/index.browser.ts"],"sourcesContent":["import type { Head, HeadMeta } from \"../interfaces/Head.ts\";\n\n/**\n * Expands Head configuration into SEO meta tags.\n *\n * Generates:\n * - `<meta name=\"description\">` from head.description\n * - `<meta property=\"og:*\">` OpenGraph tags\n * - `<meta name=\"twitter:*\">` Twitter Card tags\n *\n * @example\n * ```ts\n * const helper = new SeoExpander();\n * const { meta, link } = helper.expand({\n *   title: \"My App\",\n *   description: \"Build amazing apps\",\n *   image: \"https://example.com/og.png\",\n *   url: \"https://example.com/\",\n * });\n * ```\n */\nexport class SeoExpander {\n  public expand(head: Head): {\n    meta: HeadMeta[];\n    link: Array<{ rel: string; href: string }>;\n  } {\n    const meta: HeadMeta[] = [];\n    const link: Array<{ rel: string; href: string }> = [];\n\n    // Only expand SEO if there's meaningful content beyond just title\n    const hasSeoContent =\n      head.description ||\n      head.image ||\n      head.url ||\n      head.siteName ||\n      head.locale ||\n      head.type ||\n      head.og ||\n      head.twitter;\n\n    if (!hasSeoContent) {\n      return { meta, link };\n    }\n\n    // Base description\n    if (head.description) {\n      meta.push({ name: \"description\", content: head.description });\n    }\n\n    // Canonical URL\n    if (head.url) {\n      link.push({ rel: \"canonical\", href: head.url });\n    }\n\n    // OpenGraph tags\n    this.expandOpenGraph(head, meta);\n\n    // Twitter Card tags\n    this.expandTwitter(head, meta);\n\n    return { meta, link };\n  }\n\n  protected expandOpenGraph(head: Head, meta: HeadMeta[]): void {\n    const ogTitle = head.og?.title ?? head.title;\n    const ogDescription = head.og?.description ?? head.description;\n    const ogImage = head.og?.image ?? head.image;\n\n    if (head.type || ogTitle) {\n      meta.push({ property: \"og:type\", content: head.type ?? \"website\" });\n    }\n    if (head.url) {\n      meta.push({ property: \"og:url\", content: head.url });\n    }\n    if (ogTitle) {\n      meta.push({ property: \"og:title\", content: ogTitle });\n    }\n    if (ogDescription) {\n      meta.push({ property: \"og:description\", content: ogDescription });\n    }\n    if (ogImage) {\n      meta.push({ property: \"og:image\", content: ogImage });\n      if (head.imageWidth) {\n        meta.push({\n          property: \"og:image:width\",\n          content: String(head.imageWidth),\n        });\n      }\n      if (head.imageHeight) {\n        meta.push({\n          property: \"og:image:height\",\n          content: String(head.imageHeight),\n        });\n      }\n      if (head.imageAlt) {\n        meta.push({ property: \"og:image:alt\", content: head.imageAlt });\n      }\n    }\n    if (head.siteName) {\n      meta.push({ property: \"og:site_name\", content: head.siteName });\n    }\n    if (head.locale) {\n      meta.push({ property: \"og:locale\", content: head.locale });\n    }\n  }\n\n  protected expandTwitter(head: Head, meta: HeadMeta[]): void {\n    const twitterTitle = head.twitter?.title ?? head.title;\n    const twitterDescription = head.twitter?.description ?? head.description;\n    const twitterImage = head.twitter?.image ?? head.image;\n\n    if (head.twitter?.card || twitterTitle || twitterImage) {\n      meta.push({\n        name: \"twitter:card\",\n        content:\n          head.twitter?.card ??\n          (twitterImage ? \"summary_large_image\" : \"summary\"),\n      });\n    }\n    if (head.url) {\n      meta.push({ name: \"twitter:url\", content: head.url });\n    }\n    if (twitterTitle) {\n      meta.push({ name: \"twitter:title\", content: twitterTitle });\n    }\n    if (twitterDescription) {\n      meta.push({ name: \"twitter:description\", content: twitterDescription });\n    }\n    if (twitterImage) {\n      meta.push({ name: \"twitter:image\", content: twitterImage });\n      if (head.imageAlt) {\n        meta.push({ name: \"twitter:image:alt\", content: head.imageAlt });\n      }\n    }\n    if (head.twitter?.site) {\n      meta.push({ name: \"twitter:site\", content: head.twitter.site });\n    }\n    if (head.twitter?.creator) {\n      meta.push({ name: \"twitter:creator\", content: head.twitter.creator });\n    }\n  }\n}\n","import { $inject } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { SeoExpander } from \"../helpers/SeoExpander.ts\";\nimport type { Head } from \"../interfaces/Head.ts\";\n\n/**\n * Provides methods to fill and merge head information into the application state.\n *\n * Used both on server and client side to manage document head.\n *\n * @see {@link SeoExpander}\n * @see {@link ServerHeadProvider}\n * @see {@link BrowserHeadProvider}\n */\nexport class HeadProvider {\n  protected readonly log = $logger();\n  protected readonly seoExpander = $inject(SeoExpander);\n\n  public global?: Array<Head | (() => Head)> = [];\n\n  /**\n   * Track if we've warned about page-level htmlAttributes to avoid spam.\n   */\n  protected warnedAboutHtmlAttributes = false;\n\n  /**\n   * Resolve global head configuration (from $head primitives only).\n   *\n   * This is used to get htmlAttributes early, before page loaders run.\n   * Only htmlAttributes from global $head are allowed; page-level htmlAttributes\n   * are ignored for early streaming optimization.\n   *\n   * @returns Merged global head with htmlAttributes\n   */\n  public resolveGlobalHead(): Head {\n    const head: Head = {\n      htmlAttributes: { lang: \"en\" },\n    };\n\n    for (const h of this.global ?? []) {\n      const resolved = typeof h === \"function\" ? h() : h;\n      if (resolved.htmlAttributes) {\n        head.htmlAttributes = {\n          ...head.htmlAttributes,\n          ...resolved.htmlAttributes,\n        };\n      }\n    }\n\n    return head;\n  }\n\n  /**\n   * Fully resolve all global $head entries (functions re-evaluated, objects kept as-is).\n   *\n   * Unlike resolveGlobalHead() which only extracts htmlAttributes for streaming,\n   * this resolves all head properties (meta, link, script, htmlAttributes, etc.).\n   *\n   * Used by BrowserHeadProvider.refreshGlobalHead() to re-apply global head to the DOM.\n   */\n  public resolveGlobal(): Head {\n    let head: Head = {};\n\n    for (const h of this.global ?? []) {\n      const resolved = typeof h === \"function\" ? h() : h;\n      const { meta, link } = this.seoExpander.expand(resolved);\n      head = {\n        ...head,\n        ...resolved,\n        meta: [...(head.meta ?? []), ...meta, ...(resolved.meta ?? [])],\n        link: [...(head.link ?? []), ...link, ...(resolved.link ?? [])],\n        script: [...(head.script ?? []), ...(resolved.script ?? [])],\n      };\n    }\n\n    return head;\n  }\n\n  public fillHead(state: HeadState) {\n    state.head = {\n      ...state.head,\n    };\n\n    for (const h of this.global ?? []) {\n      const head = typeof h === \"function\" ? h() : h;\n      this.mergeHead(state, head);\n    }\n\n    for (const layer of state.layers) {\n      if (layer.route?.head && !layer.error) {\n        this.fillHeadByPage(layer.route, state, layer.props ?? {});\n      }\n    }\n\n    // Defaults if none were set by global $head or page head\n    state.head.title ??= \"App\";\n    state.head.htmlAttributes = {\n      lang: \"en\",\n      ...state.head.htmlAttributes,\n    };\n  }\n\n  protected mergeHead(state: HeadState, head: Head): void {\n    // Expand SEO fields into meta tags\n    const { meta, link } = this.seoExpander.expand(head);\n    state.head = {\n      ...state.head,\n      ...head,\n      meta: [...(state.head.meta ?? []), ...meta, ...(head.meta ?? [])],\n      link: [...(state.head.link ?? []), ...link, ...(head.link ?? [])],\n      script: [...(state.head.script ?? []), ...(head.script ?? [])],\n    };\n  }\n\n  protected fillHeadByPage(\n    page: HeadRoute,\n    state: HeadState,\n    props: Record<string, any>,\n  ): void {\n    if (!page.head) {\n      return;\n    }\n\n    state.head ??= {};\n\n    const head =\n      typeof page.head === \"function\"\n        ? page.head(props, state.head)\n        : page.head;\n\n    // Expand SEO fields into meta tags\n    const { meta, link } = this.seoExpander.expand(head);\n    state.head.meta = [...(state.head.meta ?? []), ...meta];\n    state.head.link = [...(state.head.link ?? []), ...link];\n\n    if (head.title) {\n      state.head ??= {};\n\n      if (state.head.titleSeparator) {\n        state.head.title = `${head.title}${state.head.titleSeparator}${state.head.title}`;\n      } else {\n        state.head.title = head.title;\n      }\n\n      state.head.titleSeparator = head.titleSeparator;\n    }\n\n    // htmlAttributes from pages are ignored for early streaming optimization.\n    // Only global $head can set htmlAttributes.\n    if (head.htmlAttributes && !this.warnedAboutHtmlAttributes) {\n      this.warnedAboutHtmlAttributes = true;\n      this.log.warn(\n        \"Page-level htmlAttributes are ignored. Use global $head() for htmlAttributes instead, \" +\n          \"as they are sent before page loaders run for early streaming optimization.\",\n      );\n    }\n\n    if (head.bodyAttributes) {\n      state.head.bodyAttributes = {\n        ...state.head.bodyAttributes,\n        ...head.bodyAttributes,\n      };\n    }\n\n    if (head.meta) {\n      state.head.meta = [...(state.head.meta ?? []), ...(head.meta ?? [])];\n    }\n\n    if (head.link) {\n      state.head.link = [...(state.head.link ?? []), ...(head.link ?? [])];\n    }\n\n    if (head.script) {\n      state.head.script = [\n        ...(state.head.script ?? []),\n        ...(head.script ?? []),\n      ];\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Minimal route interface for head processing.\n * Avoids circular dependency with alepha/react/router.\n */\ninterface HeadRoute {\n  head?: Head | ((props: Record<string, any>, previous?: Head) => Head);\n}\n\n/**\n * Minimal state interface for head processing.\n * Avoids circular dependency with alepha/react/router.\n */\ninterface HeadState {\n  head: Head;\n  layers: Array<{\n    route?: HeadRoute;\n    props?: Record<string, any>;\n    error?: Error;\n  }>;\n}\n","import { $inject, createPrimitive, KIND, Primitive } from \"alepha\";\nimport type { Head } from \"../interfaces/Head.ts\";\nimport { HeadProvider } from \"../providers/HeadProvider.ts\";\n\n/**\n * Set global `<head>` options for the application.\n */\nexport const $head = (options: HeadPrimitiveOptions) => {\n  return createPrimitive(HeadPrimitive, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport type HeadPrimitiveOptions = Head | (() => Head);\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class HeadPrimitive extends Primitive<HeadPrimitiveOptions> {\n  protected readonly provider = $inject(HeadProvider);\n  protected onInit() {\n    this.provider.global = [...(this.provider.global ?? []), this.options];\n  }\n}\n\n$head[KIND] = HeadPrimitive;\n","import { $inject, Alepha } from \"alepha\";\nimport type { Head, HeadMeta } from \"../interfaces/Head.ts\";\nimport { HeadProvider } from \"./HeadProvider.ts\";\n\n/**\n * Browser-side head provider that manages document head elements.\n *\n * Used by ReactBrowserProvider and ReactBrowserRouterProvider to update\n * document title, meta tags, and other head elements during client-side\n * navigation.\n */\nexport class BrowserHeadProvider {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly headProvider = $inject(HeadProvider);\n\n  protected get document(): Document {\n    return window.document;\n  }\n\n  /**\n   * Fill head state from route configurations and render to document.\n   * Combines fillHead from HeadProvider with renderHead to the DOM.\n   *\n   * Only runs in browser environment - no-op on server.\n   */\n  public fillAndRenderHead(state: { head: Head; layers: Array<any> }): void {\n    // Skip on server-side\n    if (!this.alepha.isBrowser()) {\n      return;\n    }\n\n    this.headProvider.fillHead(state as any);\n    if (state.head) {\n      this.renderHead(this.document, state.head);\n    }\n  }\n\n  /**\n   * Re-evaluate all global $head entries and apply the result to the DOM.\n   *\n   * Call this when something that affects global $head output changes at runtime\n   * (e.g., theme switch). Page-level head (title, meta from routes) is not touched.\n   */\n  public refreshGlobalHead(): void {\n    const head = this.headProvider.resolveGlobal();\n    this.renderHead(this.document, head);\n  }\n\n  public getHead(document: Document): Head {\n    return {\n      get title() {\n        return document.title;\n      },\n      get htmlAttributes() {\n        const attrs: Record<string, string> = {};\n        for (const attr of document.documentElement.attributes) {\n          attrs[attr.name] = attr.value;\n        }\n        return attrs;\n      },\n      get bodyAttributes() {\n        const attrs: Record<string, string> = {};\n        for (const attr of document.body.attributes) {\n          attrs[attr.name] = attr.value;\n        }\n        return attrs;\n      },\n      get meta() {\n        const metas: HeadMeta[] = [];\n        // Get meta tags with name attribute\n        for (const meta of document.head.querySelectorAll(\"meta[name]\")) {\n          const name = meta.getAttribute(\"name\");\n          const content = meta.getAttribute(\"content\");\n          if (name && content) {\n            metas.push({ name, content });\n          }\n        }\n        // Get meta tags with property attribute (OpenGraph)\n        for (const meta of document.head.querySelectorAll(\"meta[property]\")) {\n          const property = meta.getAttribute(\"property\");\n          const content = meta.getAttribute(\"content\");\n          if (property && content) {\n            metas.push({ property, content });\n          }\n        }\n        return metas;\n      },\n    };\n  }\n\n  public renderHead(document: Document, head: Head): void {\n    if (head.title) {\n      document.title = head.title;\n    }\n\n    if (head.bodyAttributes) {\n      for (const [key, value] of Object.entries(head.bodyAttributes)) {\n        if (value) {\n          document.body.setAttribute(key, value);\n        } else {\n          document.body.removeAttribute(key);\n        }\n      }\n    }\n\n    if (head.htmlAttributes) {\n      for (const [key, value] of Object.entries(head.htmlAttributes)) {\n        if (value) {\n          document.documentElement.setAttribute(key, value);\n        } else {\n          document.documentElement.removeAttribute(key);\n        }\n      }\n    }\n\n    if (head.meta) {\n      for (const it of head.meta) {\n        this.renderMetaTag(document, it);\n      }\n    }\n\n    if (head.link) {\n      for (const it of head.link) {\n        const { rel, href } = it;\n        let link = document.querySelector(`link[rel=\"${rel}\"][href=\"${href}\"]`);\n        if (!link) {\n          link = document.createElement(\"link\");\n          link.setAttribute(\"rel\", rel);\n          link.setAttribute(\"href\", href);\n          if (it.type) {\n            link.setAttribute(\"type\", it.type);\n          }\n          if (it.as) {\n            link.setAttribute(\"as\", it.as);\n          }\n          if (it.crossorigin != null) {\n            link.setAttribute(\"crossorigin\", \"\");\n          }\n          document.head.appendChild(link);\n        }\n      }\n    }\n\n    if (head.script) {\n      for (const it of head.script) {\n        this.renderScriptTag(document, it);\n      }\n    }\n  }\n\n  protected renderScriptTag(\n    document: Document,\n    script:\n      | string\n      | (Record<string, string | boolean | undefined> & { content?: string }),\n  ): void {\n    // Plain string → inline script. Dedupe by exact content match against\n    // any existing inline script (handles SSR-emitted globals that would\n    // otherwise be re-appended on hydration).\n    if (typeof script === \"string\") {\n      if (this.findInlineScriptByContent(document, script)) return;\n      const el = document.createElement(\"script\");\n      el.textContent = script;\n      document.head.appendChild(el);\n      return;\n    }\n\n    const { content, ...attrs } = script;\n\n    // src-based scripts: dedupe by src attribute (existing behaviour).\n    if (attrs.src) {\n      if (document.querySelector(`script[src=\"${attrs.src}\"]`)) return;\n    } else if (typeof attrs.id === \"string\") {\n      // id-based dedupe — single source of truth per id.\n      if (document.querySelector(`script#${CSS.escape(attrs.id)}`)) return;\n    } else if (content) {\n      // Inline scripts with `content` and no src/id: fall back to content match.\n      if (this.findInlineScriptByContent(document, content)) return;\n    }\n\n    const el = document.createElement(\"script\");\n    for (const [key, value] of Object.entries(attrs)) {\n      if (value === true) {\n        el.setAttribute(key, \"\");\n      } else if (value !== undefined && value !== false) {\n        el.setAttribute(key, String(value));\n      }\n    }\n    if (content) {\n      el.textContent = content;\n    }\n    document.head.appendChild(el);\n  }\n\n  /**\n   * Find an existing inline `<script>` tag (no `src`) with matching textContent.\n   * Used to make `renderScriptTag` idempotent across hydration + navigation,\n   * so SSR-emitted global scripts aren't re-appended client-side.\n   */\n  protected findInlineScriptByContent(\n    document: Document,\n    content: string,\n  ): Element | null {\n    for (const existing of document.head.querySelectorAll(\n      \"script:not([src])\",\n    )) {\n      if (existing.textContent === content) return existing;\n    }\n    return null;\n  }\n\n  protected renderMetaTag(document: Document, meta: HeadMeta): void {\n    const { content } = meta;\n\n    // Handle OpenGraph tags (property attribute)\n    if (meta.property) {\n      const existing = document.querySelector(\n        `meta[property=\"${meta.property}\"]`,\n      );\n      if (existing) {\n        existing.setAttribute(\"content\", content);\n      } else {\n        const newMeta = document.createElement(\"meta\");\n        newMeta.setAttribute(\"property\", meta.property);\n        newMeta.setAttribute(\"content\", content);\n        document.head.appendChild(newMeta);\n      }\n      return;\n    }\n\n    // Handle standard meta tags (name attribute)\n    if (meta.name) {\n      const existing = document.querySelector(`meta[name=\"${meta.name}\"]`);\n      if (existing) {\n        existing.setAttribute(\"content\", content);\n      } else {\n        const newMeta = document.createElement(\"meta\");\n        newMeta.setAttribute(\"name\", meta.name);\n        newMeta.setAttribute(\"content\", content);\n        document.head.appendChild(newMeta);\n      }\n    }\n  }\n}\n","import { Alepha } from \"alepha\";\nimport { useInject } from \"alepha/react\";\nimport { useCallback, useEffect, useMemo } from \"react\";\nimport type { Head } from \"../interfaces/Head.ts\";\nimport { BrowserHeadProvider } from \"../providers/BrowserHeadProvider.ts\";\n\n/**\n * ```tsx\n * const App = () => {\n *   const [head, setHead] = useHead({\n *     // will set the document title on the first render\n *     title: \"My App\",\n *   });\n *\n *   return (\n *     // This will update the document title when the button is clicked\n *     <button onClick={() => setHead({ title: \"Change Title\" })}>\n *       Change Title {head.title}\n *     </button>\n *   );\n * }\n * ```\n */\nexport const useHead = (options?: UseHeadOptions): UseHeadReturn => {\n  const alepha = useInject(Alepha);\n\n  const current = useMemo(() => {\n    if (!alepha.isBrowser()) {\n      return {};\n    }\n\n    return alepha.inject(BrowserHeadProvider).getHead(window.document);\n  }, []);\n\n  const setHead = useCallback((head?: Head | ((previous?: Head) => Head)) => {\n    if (!alepha.isBrowser()) {\n      return;\n    }\n\n    const headProvider = alepha.inject(BrowserHeadProvider);\n    const resolved =\n      typeof head === \"function\"\n        ? head(headProvider.getHead(window.document))\n        : head || {};\n    headProvider.renderHead(window.document, resolved);\n  }, []);\n\n  useEffect(() => {\n    if (options) {\n      setHead(options);\n    }\n  }, []);\n\n  return [current, setHead];\n};\n\nexport type UseHeadOptions = Head | ((previous?: Head) => Head);\n\nexport type UseHeadReturn = [\n  Head,\n  (head?: Head | ((previous?: Head) => Head)) => void,\n];\n","import { $module } from \"alepha\";\nimport { AlephaReact } from \"alepha/react\";\nimport { $head } from \"./primitives/$head.ts\";\nimport { BrowserHeadProvider } from \"./providers/BrowserHeadProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./helpers/SeoExpander.ts\";\nexport * from \"./hooks/useHead.ts\";\nexport * from \"./interfaces/Head.ts\";\nexport * from \"./primitives/$head.ts\";\nexport * from \"./providers/BrowserHeadProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Alepha React Head Module\n *\n * @see {@link BrowserHeadProvider}\n * @module alepha.react.head\n */\nexport const AlephaReactHead = $module({\n  name: \"alepha.react.head\",\n  primitives: [$head],\n  services: [AlephaReact, BrowserHeadProvider],\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAqBA,IAAa,cAAb,MAAyB;CACvB,OAAc,MAGZ;EACA,MAAM,OAAmB,EAAE;EAC3B,MAAM,OAA6C,EAAE;AAarD,MAAI,EATF,KAAK,eACL,KAAK,SACL,KAAK,OACL,KAAK,YACL,KAAK,UACL,KAAK,QACL,KAAK,MACL,KAAK,SAGL,QAAO;GAAE;GAAM;GAAM;AAIvB,MAAI,KAAK,YACP,MAAK,KAAK;GAAE,MAAM;GAAe,SAAS,KAAK;GAAa,CAAC;AAI/D,MAAI,KAAK,IACP,MAAK,KAAK;GAAE,KAAK;GAAa,MAAM,KAAK;GAAK,CAAC;AAIjD,OAAK,gBAAgB,MAAM,KAAK;AAGhC,OAAK,cAAc,MAAM,KAAK;AAE9B,SAAO;GAAE;GAAM;GAAM;;CAGvB,gBAA0B,MAAY,MAAwB;EAC5D,MAAM,UAAU,KAAK,IAAI,SAAS,KAAK;EACvC,MAAM,gBAAgB,KAAK,IAAI,eAAe,KAAK;EACnD,MAAM,UAAU,KAAK,IAAI,SAAS,KAAK;AAEvC,MAAI,KAAK,QAAQ,QACf,MAAK,KAAK;GAAE,UAAU;GAAW,SAAS,KAAK,QAAQ;GAAW,CAAC;AAErE,MAAI,KAAK,IACP,MAAK,KAAK;GAAE,UAAU;GAAU,SAAS,KAAK;GAAK,CAAC;AAEtD,MAAI,QACF,MAAK,KAAK;GAAE,UAAU;GAAY,SAAS;GAAS,CAAC;AAEvD,MAAI,cACF,MAAK,KAAK;GAAE,UAAU;GAAkB,SAAS;GAAe,CAAC;AAEnE,MAAI,SAAS;AACX,QAAK,KAAK;IAAE,UAAU;IAAY,SAAS;IAAS,CAAC;AACrD,OAAI,KAAK,WACP,MAAK,KAAK;IACR,UAAU;IACV,SAAS,OAAO,KAAK,WAAW;IACjC,CAAC;AAEJ,OAAI,KAAK,YACP,MAAK,KAAK;IACR,UAAU;IACV,SAAS,OAAO,KAAK,YAAY;IAClC,CAAC;AAEJ,OAAI,KAAK,SACP,MAAK,KAAK;IAAE,UAAU;IAAgB,SAAS,KAAK;IAAU,CAAC;;AAGnE,MAAI,KAAK,SACP,MAAK,KAAK;GAAE,UAAU;GAAgB,SAAS,KAAK;GAAU,CAAC;AAEjE,MAAI,KAAK,OACP,MAAK,KAAK;GAAE,UAAU;GAAa,SAAS,KAAK;GAAQ,CAAC;;CAI9D,cAAwB,MAAY,MAAwB;EAC1D,MAAM,eAAe,KAAK,SAAS,SAAS,KAAK;EACjD,MAAM,qBAAqB,KAAK,SAAS,eAAe,KAAK;EAC7D,MAAM,eAAe,KAAK,SAAS,SAAS,KAAK;AAEjD,MAAI,KAAK,SAAS,QAAQ,gBAAgB,aACxC,MAAK,KAAK;GACR,MAAM;GACN,SACE,KAAK,SAAS,SACb,eAAe,wBAAwB;GAC3C,CAAC;AAEJ,MAAI,KAAK,IACP,MAAK,KAAK;GAAE,MAAM;GAAe,SAAS,KAAK;GAAK,CAAC;AAEvD,MAAI,aACF,MAAK,KAAK;GAAE,MAAM;GAAiB,SAAS;GAAc,CAAC;AAE7D,MAAI,mBACF,MAAK,KAAK;GAAE,MAAM;GAAuB,SAAS;GAAoB,CAAC;AAEzE,MAAI,cAAc;AAChB,QAAK,KAAK;IAAE,MAAM;IAAiB,SAAS;IAAc,CAAC;AAC3D,OAAI,KAAK,SACP,MAAK,KAAK;IAAE,MAAM;IAAqB,SAAS,KAAK;IAAU,CAAC;;AAGpE,MAAI,KAAK,SAAS,KAChB,MAAK,KAAK;GAAE,MAAM;GAAgB,SAAS,KAAK,QAAQ;GAAM,CAAC;AAEjE,MAAI,KAAK,SAAS,QAChB,MAAK,KAAK;GAAE,MAAM;GAAmB,SAAS,KAAK,QAAQ;GAAS,CAAC;;;;;;;;;;;;;;AC5H3E,IAAa,eAAb,MAA0B;CACxB,MAAyB,SAAS;CAClC,cAAiC,QAAQ,YAAY;CAErD,SAA6C,EAAE;;;;CAK/C,4BAAsC;;;;;;;;;;CAWtC,oBAAiC;EAC/B,MAAM,OAAa,EACjB,gBAAgB,EAAE,MAAM,MAAM,EAC/B;AAED,OAAK,MAAM,KAAK,KAAK,UAAU,EAAE,EAAE;GACjC,MAAM,WAAW,OAAO,MAAM,aAAa,GAAG,GAAG;AACjD,OAAI,SAAS,eACX,MAAK,iBAAiB;IACpB,GAAG,KAAK;IACR,GAAG,SAAS;IACb;;AAIL,SAAO;;;;;;;;;;CAWT,gBAA6B;EAC3B,IAAI,OAAa,EAAE;AAEnB,OAAK,MAAM,KAAK,KAAK,UAAU,EAAE,EAAE;GACjC,MAAM,WAAW,OAAO,MAAM,aAAa,GAAG,GAAG;GACjD,MAAM,EAAE,MAAM,SAAS,KAAK,YAAY,OAAO,SAAS;AACxD,UAAO;IACL,GAAG;IACH,GAAG;IACH,MAAM;KAAC,GAAI,KAAK,QAAQ,EAAE;KAAG,GAAG;KAAM,GAAI,SAAS,QAAQ,EAAE;KAAE;IAC/D,MAAM;KAAC,GAAI,KAAK,QAAQ,EAAE;KAAG,GAAG;KAAM,GAAI,SAAS,QAAQ,EAAE;KAAE;IAC/D,QAAQ,CAAC,GAAI,KAAK,UAAU,EAAE,EAAG,GAAI,SAAS,UAAU,EAAE,CAAE;IAC7D;;AAGH,SAAO;;CAGT,SAAgB,OAAkB;AAChC,QAAM,OAAO,EACX,GAAG,MAAM,MACV;AAED,OAAK,MAAM,KAAK,KAAK,UAAU,EAAE,EAAE;GACjC,MAAM,OAAO,OAAO,MAAM,aAAa,GAAG,GAAG;AAC7C,QAAK,UAAU,OAAO,KAAK;;AAG7B,OAAK,MAAM,SAAS,MAAM,OACxB,KAAI,MAAM,OAAO,QAAQ,CAAC,MAAM,MAC9B,MAAK,eAAe,MAAM,OAAO,OAAO,MAAM,SAAS,EAAE,CAAC;AAK9D,QAAM,KAAK,UAAU;AACrB,QAAM,KAAK,iBAAiB;GAC1B,MAAM;GACN,GAAG,MAAM,KAAK;GACf;;CAGH,UAAoB,OAAkB,MAAkB;EAEtD,MAAM,EAAE,MAAM,SAAS,KAAK,YAAY,OAAO,KAAK;AACpD,QAAM,OAAO;GACX,GAAG,MAAM;GACT,GAAG;GACH,MAAM;IAAC,GAAI,MAAM,KAAK,QAAQ,EAAE;IAAG,GAAG;IAAM,GAAI,KAAK,QAAQ,EAAE;IAAE;GACjE,MAAM;IAAC,GAAI,MAAM,KAAK,QAAQ,EAAE;IAAG,GAAG;IAAM,GAAI,KAAK,QAAQ,EAAE;IAAE;GACjE,QAAQ,CAAC,GAAI,MAAM,KAAK,UAAU,EAAE,EAAG,GAAI,KAAK,UAAU,EAAE,CAAE;GAC/D;;CAGH,eACE,MACA,OACA,OACM;AACN,MAAI,CAAC,KAAK,KACR;AAGF,QAAM,SAAS,EAAE;EAEjB,MAAM,OACJ,OAAO,KAAK,SAAS,aACjB,KAAK,KAAK,OAAO,MAAM,KAAK,GAC5B,KAAK;EAGX,MAAM,EAAE,MAAM,SAAS,KAAK,YAAY,OAAO,KAAK;AACpD,QAAM,KAAK,OAAO,CAAC,GAAI,MAAM,KAAK,QAAQ,EAAE,EAAG,GAAG,KAAK;AACvD,QAAM,KAAK,OAAO,CAAC,GAAI,MAAM,KAAK,QAAQ,EAAE,EAAG,GAAG,KAAK;AAEvD,MAAI,KAAK,OAAO;AACd,SAAM,SAAS,EAAE;AAEjB,OAAI,MAAM,KAAK,eACb,OAAM,KAAK,QAAQ,GAAG,KAAK,QAAQ,MAAM,KAAK,iBAAiB,MAAM,KAAK;OAE1E,OAAM,KAAK,QAAQ,KAAK;AAG1B,SAAM,KAAK,iBAAiB,KAAK;;AAKnC,MAAI,KAAK,kBAAkB,CAAC,KAAK,2BAA2B;AAC1D,QAAK,4BAA4B;AACjC,QAAK,IAAI,KACP,mKAED;;AAGH,MAAI,KAAK,eACP,OAAM,KAAK,iBAAiB;GAC1B,GAAG,MAAM,KAAK;GACd,GAAG,KAAK;GACT;AAGH,MAAI,KAAK,KACP,OAAM,KAAK,OAAO,CAAC,GAAI,MAAM,KAAK,QAAQ,EAAE,EAAG,GAAI,KAAK,QAAQ,EAAE,CAAE;AAGtE,MAAI,KAAK,KACP,OAAM,KAAK,OAAO,CAAC,GAAI,MAAM,KAAK,QAAQ,EAAE,EAAG,GAAI,KAAK,QAAQ,EAAE,CAAE;AAGtE,MAAI,KAAK,OACP,OAAM,KAAK,SAAS,CAClB,GAAI,MAAM,KAAK,UAAU,EAAE,EAC3B,GAAI,KAAK,UAAU,EAAE,CACtB;;;;;;;;ACzKP,MAAa,SAAS,YAAkC;AACtD,QAAO,gBAAgB,eAAe,QAAQ;;AAShD,IAAa,gBAAb,cAAmC,UAAgC;CACjE,WAA8B,QAAQ,aAAa;CACnD,SAAmB;AACjB,OAAK,SAAS,SAAS,CAAC,GAAI,KAAK,SAAS,UAAU,EAAE,EAAG,KAAK,QAAQ;;;AAI1E,MAAM,QAAQ;;;;;;;;;;ACbd,IAAa,sBAAb,MAAiC;CAC/B,SAA4B,QAAQ,OAAO;CAC3C,eAAkC,QAAQ,aAAa;CAEvD,IAAc,WAAqB;AACjC,SAAO,OAAO;;;;;;;;CAShB,kBAAyB,OAAiD;AAExE,MAAI,CAAC,KAAK,OAAO,WAAW,CAC1B;AAGF,OAAK,aAAa,SAAS,MAAa;AACxC,MAAI,MAAM,KACR,MAAK,WAAW,KAAK,UAAU,MAAM,KAAK;;;;;;;;CAU9C,oBAAiC;EAC/B,MAAM,OAAO,KAAK,aAAa,eAAe;AAC9C,OAAK,WAAW,KAAK,UAAU,KAAK;;CAGtC,QAAe,UAA0B;AACvC,SAAO;GACL,IAAI,QAAQ;AACV,WAAO,SAAS;;GAElB,IAAI,iBAAiB;IACnB,MAAM,QAAgC,EAAE;AACxC,SAAK,MAAM,QAAQ,SAAS,gBAAgB,WAC1C,OAAM,KAAK,QAAQ,KAAK;AAE1B,WAAO;;GAET,IAAI,iBAAiB;IACnB,MAAM,QAAgC,EAAE;AACxC,SAAK,MAAM,QAAQ,SAAS,KAAK,WAC/B,OAAM,KAAK,QAAQ,KAAK;AAE1B,WAAO;;GAET,IAAI,OAAO;IACT,MAAM,QAAoB,EAAE;AAE5B,SAAK,MAAM,QAAQ,SAAS,KAAK,iBAAiB,aAAa,EAAE;KAC/D,MAAM,OAAO,KAAK,aAAa,OAAO;KACtC,MAAM,UAAU,KAAK,aAAa,UAAU;AAC5C,SAAI,QAAQ,QACV,OAAM,KAAK;MAAE;MAAM;MAAS,CAAC;;AAIjC,SAAK,MAAM,QAAQ,SAAS,KAAK,iBAAiB,iBAAiB,EAAE;KACnE,MAAM,WAAW,KAAK,aAAa,WAAW;KAC9C,MAAM,UAAU,KAAK,aAAa,UAAU;AAC5C,SAAI,YAAY,QACd,OAAM,KAAK;MAAE;MAAU;MAAS,CAAC;;AAGrC,WAAO;;GAEV;;CAGH,WAAkB,UAAoB,MAAkB;AACtD,MAAI,KAAK,MACP,UAAS,QAAQ,KAAK;AAGxB,MAAI,KAAK,eACP,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,eAAe,CAC5D,KAAI,MACF,UAAS,KAAK,aAAa,KAAK,MAAM;MAEtC,UAAS,KAAK,gBAAgB,IAAI;AAKxC,MAAI,KAAK,eACP,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,eAAe,CAC5D,KAAI,MACF,UAAS,gBAAgB,aAAa,KAAK,MAAM;MAEjD,UAAS,gBAAgB,gBAAgB,IAAI;AAKnD,MAAI,KAAK,KACP,MAAK,MAAM,MAAM,KAAK,KACpB,MAAK,cAAc,UAAU,GAAG;AAIpC,MAAI,KAAK,KACP,MAAK,MAAM,MAAM,KAAK,MAAM;GAC1B,MAAM,EAAE,KAAK,SAAS;GACtB,IAAI,OAAO,SAAS,cAAc,aAAa,IAAI,WAAW,KAAK,IAAI;AACvE,OAAI,CAAC,MAAM;AACT,WAAO,SAAS,cAAc,OAAO;AACrC,SAAK,aAAa,OAAO,IAAI;AAC7B,SAAK,aAAa,QAAQ,KAAK;AAC/B,QAAI,GAAG,KACL,MAAK,aAAa,QAAQ,GAAG,KAAK;AAEpC,QAAI,GAAG,GACL,MAAK,aAAa,MAAM,GAAG,GAAG;AAEhC,QAAI,GAAG,eAAe,KACpB,MAAK,aAAa,eAAe,GAAG;AAEtC,aAAS,KAAK,YAAY,KAAK;;;AAKrC,MAAI,KAAK,OACP,MAAK,MAAM,MAAM,KAAK,OACpB,MAAK,gBAAgB,UAAU,GAAG;;CAKxC,gBACE,UACA,QAGM;AAIN,MAAI,OAAO,WAAW,UAAU;AAC9B,OAAI,KAAK,0BAA0B,UAAU,OAAO,CAAE;GACtD,MAAM,KAAK,SAAS,cAAc,SAAS;AAC3C,MAAG,cAAc;AACjB,YAAS,KAAK,YAAY,GAAG;AAC7B;;EAGF,MAAM,EAAE,SAAS,GAAG,UAAU;AAG9B,MAAI,MAAM;OACJ,SAAS,cAAc,eAAe,MAAM,IAAI,IAAI,CAAE;aACjD,OAAO,MAAM,OAAO;OAEzB,SAAS,cAAc,UAAU,IAAI,OAAO,MAAM,GAAG,GAAG,CAAE;aACrD;OAEL,KAAK,0BAA0B,UAAU,QAAQ,CAAE;;EAGzD,MAAM,KAAK,SAAS,cAAc,SAAS;AAC3C,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAM,CAC9C,KAAI,UAAU,KACZ,IAAG,aAAa,KAAK,GAAG;WACf,UAAU,KAAA,KAAa,UAAU,MAC1C,IAAG,aAAa,KAAK,OAAO,MAAM,CAAC;AAGvC,MAAI,QACF,IAAG,cAAc;AAEnB,WAAS,KAAK,YAAY,GAAG;;;;;;;CAQ/B,0BACE,UACA,SACgB;AAChB,OAAK,MAAM,YAAY,SAAS,KAAK,iBACnC,oBACD,CACC,KAAI,SAAS,gBAAgB,QAAS,QAAO;AAE/C,SAAO;;CAGT,cAAwB,UAAoB,MAAsB;EAChE,MAAM,EAAE,YAAY;AAGpB,MAAI,KAAK,UAAU;GACjB,MAAM,WAAW,SAAS,cACxB,kBAAkB,KAAK,SAAS,IACjC;AACD,OAAI,SACF,UAAS,aAAa,WAAW,QAAQ;QACpC;IACL,MAAM,UAAU,SAAS,cAAc,OAAO;AAC9C,YAAQ,aAAa,YAAY,KAAK,SAAS;AAC/C,YAAQ,aAAa,WAAW,QAAQ;AACxC,aAAS,KAAK,YAAY,QAAQ;;AAEpC;;AAIF,MAAI,KAAK,MAAM;GACb,MAAM,WAAW,SAAS,cAAc,cAAc,KAAK,KAAK,IAAI;AACpE,OAAI,SACF,UAAS,aAAa,WAAW,QAAQ;QACpC;IACL,MAAM,UAAU,SAAS,cAAc,OAAO;AAC9C,YAAQ,aAAa,QAAQ,KAAK,KAAK;AACvC,YAAQ,aAAa,WAAW,QAAQ;AACxC,aAAS,KAAK,YAAY,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;ACxN1C,MAAa,WAAW,YAA4C;CAClE,MAAM,SAAS,UAAU,OAAO;CAEhC,MAAM,UAAU,cAAc;AAC5B,MAAI,CAAC,OAAO,WAAW,CACrB,QAAO,EAAE;AAGX,SAAO,OAAO,OAAO,oBAAoB,CAAC,QAAQ,OAAO,SAAS;IACjE,EAAE,CAAC;CAEN,MAAM,UAAU,aAAa,SAA8C;AACzE,MAAI,CAAC,OAAO,WAAW,CACrB;EAGF,MAAM,eAAe,OAAO,OAAO,oBAAoB;EACvD,MAAM,WACJ,OAAO,SAAS,aACZ,KAAK,aAAa,QAAQ,OAAO,SAAS,CAAC,GAC3C,QAAQ,EAAE;AAChB,eAAa,WAAW,OAAO,UAAU,SAAS;IACjD,EAAE,CAAC;AAEN,iBAAgB;AACd,MAAI,QACF,SAAQ,QAAQ;IAEjB,EAAE,CAAC;AAEN,QAAO,CAAC,SAAS,QAAQ;;;;;;;;;;AChC3B,MAAa,kBAAkB,QAAQ;CACrC,MAAM;CACN,YAAY,CAAC,MAAM;CACnB,UAAU,CAAC,aAAa,oBAAoB;CAC7C,CAAC"}
+{"version":3,"file":"index.browser.js","names":[],"sources":["../../../src/react/head/helpers/SeoExpander.ts","../../../src/react/head/providers/HeadProvider.ts","../../../src/react/head/primitives/$head.ts","../../../src/react/head/providers/BrowserHeadProvider.ts","../../../src/react/head/hooks/useHead.ts","../../../src/react/head/index.browser.ts"],"sourcesContent":["import type { Head, HeadMeta } from \"../interfaces/Head.ts\";\n\n/**\n * Expands Head configuration into SEO meta tags.\n *\n * Generates:\n * - `<meta name=\"description\">` from head.description\n * - `<meta property=\"og:*\">` OpenGraph tags\n * - `<meta name=\"twitter:*\">` Twitter Card tags\n *\n * @example\n * ```ts\n * const helper = new SeoExpander();\n * const { meta, link } = helper.expand({\n *   title: \"My App\",\n *   description: \"Build amazing apps\",\n *   image: \"https://example.com/og.png\",\n *   url: \"https://example.com/\",\n * });\n * ```\n */\nexport class SeoExpander {\n  public expand(head: Head): {\n    meta: HeadMeta[];\n    link: Array<{ rel: string; href: string }>;\n  } {\n    const meta: HeadMeta[] = [];\n    const link: Array<{ rel: string; href: string }> = [];\n\n    // Only expand SEO if there's meaningful content beyond just title\n    const hasSeoContent =\n      head.description ||\n      head.image ||\n      head.url ||\n      head.siteName ||\n      head.locale ||\n      head.type ||\n      head.og ||\n      head.twitter;\n\n    if (!hasSeoContent) {\n      return { meta, link };\n    }\n\n    // Base description\n    if (head.description) {\n      meta.push({ name: \"description\", content: head.description });\n    }\n\n    // Canonical URL\n    if (head.url) {\n      link.push({ rel: \"canonical\", href: head.url });\n    }\n\n    // OpenGraph tags\n    this.expandOpenGraph(head, meta);\n\n    // Twitter Card tags\n    this.expandTwitter(head, meta);\n\n    return { meta, link };\n  }\n\n  protected expandOpenGraph(head: Head, meta: HeadMeta[]): void {\n    const ogTitle = head.og?.title ?? head.title;\n    const ogDescription = head.og?.description ?? head.description;\n    const ogImage = head.og?.image ?? head.image;\n\n    if (head.type || ogTitle) {\n      meta.push({ property: \"og:type\", content: head.type ?? \"website\" });\n    }\n    if (head.url) {\n      meta.push({ property: \"og:url\", content: head.url });\n    }\n    if (ogTitle) {\n      meta.push({ property: \"og:title\", content: ogTitle });\n    }\n    if (ogDescription) {\n      meta.push({ property: \"og:description\", content: ogDescription });\n    }\n    if (ogImage) {\n      meta.push({ property: \"og:image\", content: ogImage });\n      if (head.imageWidth) {\n        meta.push({\n          property: \"og:image:width\",\n          content: String(head.imageWidth),\n        });\n      }\n      if (head.imageHeight) {\n        meta.push({\n          property: \"og:image:height\",\n          content: String(head.imageHeight),\n        });\n      }\n      if (head.imageAlt) {\n        meta.push({ property: \"og:image:alt\", content: head.imageAlt });\n      }\n    }\n    if (head.siteName) {\n      meta.push({ property: \"og:site_name\", content: head.siteName });\n    }\n    if (head.locale) {\n      meta.push({ property: \"og:locale\", content: head.locale });\n    }\n  }\n\n  protected expandTwitter(head: Head, meta: HeadMeta[]): void {\n    const twitterTitle = head.twitter?.title ?? head.title;\n    const twitterDescription = head.twitter?.description ?? head.description;\n    const twitterImage = head.twitter?.image ?? head.image;\n\n    if (head.twitter?.card || twitterTitle || twitterImage) {\n      meta.push({\n        name: \"twitter:card\",\n        content:\n          head.twitter?.card ??\n          (twitterImage ? \"summary_large_image\" : \"summary\"),\n      });\n    }\n    if (head.url) {\n      meta.push({ name: \"twitter:url\", content: head.url });\n    }\n    if (twitterTitle) {\n      meta.push({ name: \"twitter:title\", content: twitterTitle });\n    }\n    if (twitterDescription) {\n      meta.push({ name: \"twitter:description\", content: twitterDescription });\n    }\n    if (twitterImage) {\n      meta.push({ name: \"twitter:image\", content: twitterImage });\n      if (head.imageAlt) {\n        meta.push({ name: \"twitter:image:alt\", content: head.imageAlt });\n      }\n    }\n    if (head.twitter?.site) {\n      meta.push({ name: \"twitter:site\", content: head.twitter.site });\n    }\n    if (head.twitter?.creator) {\n      meta.push({ name: \"twitter:creator\", content: head.twitter.creator });\n    }\n  }\n}\n","import { $inject } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { SeoExpander } from \"../helpers/SeoExpander.ts\";\nimport type { Head } from \"../interfaces/Head.ts\";\n\n/**\n * Provides methods to fill and merge head information into the application state.\n *\n * Used both on server and client side to manage document head.\n *\n * @see {@link SeoExpander}\n * @see {@link ServerHeadProvider}\n * @see {@link BrowserHeadProvider}\n */\nexport class HeadProvider {\n  protected readonly log = $logger();\n  protected readonly seoExpander = $inject(SeoExpander);\n\n  public global?: Array<Head | (() => Head)> = [];\n\n  /**\n   * Track if we've warned about page-level htmlAttributes to avoid spam.\n   */\n  protected warnedAboutHtmlAttributes = false;\n\n  /**\n   * Resolve global head configuration (from $head primitives only).\n   *\n   * This is used to get htmlAttributes early, before page loaders run.\n   * Only htmlAttributes from global $head are allowed; page-level htmlAttributes\n   * are ignored for early streaming optimization.\n   *\n   * @returns Merged global head with htmlAttributes\n   */\n  public resolveGlobalHead(): Head {\n    const head: Head = {\n      htmlAttributes: { lang: \"en\" },\n    };\n\n    for (const h of this.global ?? []) {\n      const resolved = typeof h === \"function\" ? h() : h;\n      if (resolved.htmlAttributes) {\n        head.htmlAttributes = {\n          ...head.htmlAttributes,\n          ...resolved.htmlAttributes,\n        };\n      }\n    }\n\n    return head;\n  }\n\n  /**\n   * Fully resolve all global $head entries (functions re-evaluated, objects kept as-is).\n   *\n   * Unlike resolveGlobalHead() which only extracts htmlAttributes for streaming,\n   * this resolves all head properties (meta, link, script, htmlAttributes, etc.).\n   *\n   * Used by BrowserHeadProvider.refreshGlobalHead() to re-apply global head to the DOM.\n   */\n  public resolveGlobal(): Head {\n    let head: Head = {};\n\n    for (const h of this.global ?? []) {\n      const resolved = typeof h === \"function\" ? h() : h;\n      const { meta, link } = this.seoExpander.expand(resolved);\n      head = {\n        ...head,\n        ...resolved,\n        meta: [...(head.meta ?? []), ...meta, ...(resolved.meta ?? [])],\n        link: [...(head.link ?? []), ...link, ...(resolved.link ?? [])],\n        script: [...(head.script ?? []), ...(resolved.script ?? [])],\n      };\n    }\n\n    return head;\n  }\n\n  public fillHead(state: HeadState) {\n    state.head = {\n      ...state.head,\n    };\n\n    for (const h of this.global ?? []) {\n      const head = typeof h === \"function\" ? h() : h;\n      this.mergeHead(state, head);\n    }\n\n    for (const layer of state.layers) {\n      if (layer.route?.head && !layer.error) {\n        this.fillHeadByPage(layer.route, state, layer.props ?? {});\n      }\n    }\n\n    // Defaults if none were set by global $head or page head\n    state.head.title ??= \"App\";\n    state.head.htmlAttributes = {\n      lang: \"en\",\n      ...state.head.htmlAttributes,\n    };\n  }\n\n  protected mergeHead(state: HeadState, head: Head): void {\n    // Expand SEO fields into meta tags\n    const { meta, link } = this.seoExpander.expand(head);\n    state.head = {\n      ...state.head,\n      ...head,\n      meta: [...(state.head.meta ?? []), ...meta, ...(head.meta ?? [])],\n      link: [...(state.head.link ?? []), ...link, ...(head.link ?? [])],\n      script: [...(state.head.script ?? []), ...(head.script ?? [])],\n    };\n  }\n\n  protected fillHeadByPage(\n    page: HeadRoute,\n    state: HeadState,\n    props: Record<string, any>,\n  ): void {\n    if (!page.head) {\n      return;\n    }\n\n    state.head ??= {};\n\n    const head =\n      typeof page.head === \"function\"\n        ? page.head(props, state.head)\n        : page.head;\n\n    // Expand SEO fields into meta tags\n    const { meta, link } = this.seoExpander.expand(head);\n    state.head.meta = [...(state.head.meta ?? []), ...meta];\n    state.head.link = [...(state.head.link ?? []), ...link];\n\n    if (head.title) {\n      state.head ??= {};\n\n      if (state.head.titleSeparator) {\n        state.head.title = `${head.title}${state.head.titleSeparator}${state.head.title}`;\n      } else {\n        state.head.title = head.title;\n      }\n\n      state.head.titleSeparator = head.titleSeparator;\n    }\n\n    // htmlAttributes from pages are ignored for early streaming optimization.\n    // Only global $head can set htmlAttributes.\n    if (head.htmlAttributes && !this.warnedAboutHtmlAttributes) {\n      this.warnedAboutHtmlAttributes = true;\n      this.log.warn(\n        \"Page-level htmlAttributes are ignored. Use global $head() for htmlAttributes instead, \" +\n          \"as they are sent before page loaders run for early streaming optimization.\",\n      );\n    }\n\n    if (head.bodyAttributes) {\n      state.head.bodyAttributes = {\n        ...state.head.bodyAttributes,\n        ...head.bodyAttributes,\n      };\n    }\n\n    if (head.meta) {\n      state.head.meta = [...(state.head.meta ?? []), ...(head.meta ?? [])];\n    }\n\n    if (head.link) {\n      state.head.link = [...(state.head.link ?? []), ...(head.link ?? [])];\n    }\n\n    if (head.script) {\n      state.head.script = [\n        ...(state.head.script ?? []),\n        ...(head.script ?? []),\n      ];\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Minimal route interface for head processing.\n * Avoids circular dependency with alepha/react/router.\n */\ninterface HeadRoute {\n  head?: Head | ((props: Record<string, any>, previous?: Head) => Head);\n}\n\n/**\n * Minimal state interface for head processing.\n * Avoids circular dependency with alepha/react/router.\n */\ninterface HeadState {\n  head: Head;\n  layers: Array<{\n    route?: HeadRoute;\n    props?: Record<string, any>;\n    error?: Error;\n  }>;\n}\n","import { $inject, createPrimitive, KIND, Primitive } from \"alepha\";\nimport type { Head } from \"../interfaces/Head.ts\";\nimport { HeadProvider } from \"../providers/HeadProvider.ts\";\n\n/**\n * Set global `<head>` options for the application.\n */\nexport const $head = (options: HeadPrimitiveOptions) => {\n  return createPrimitive(HeadPrimitive, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport type HeadPrimitiveOptions = Head | (() => Head);\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class HeadPrimitive extends Primitive<HeadPrimitiveOptions> {\n  protected readonly provider = $inject(HeadProvider);\n  protected onInit() {\n    this.provider.global = [...(this.provider.global ?? []), this.options];\n  }\n}\n\n$head[KIND] = HeadPrimitive;\n","import { $inject, Alepha } from \"alepha\";\nimport type { Head, HeadMeta } from \"../interfaces/Head.ts\";\nimport { HeadProvider } from \"./HeadProvider.ts\";\n\n/**\n * Browser-side head provider that manages document head elements.\n *\n * Used by ReactBrowserProvider and ReactBrowserRouterProvider to update\n * document title, meta tags, and other head elements during client-side\n * navigation.\n */\nexport class BrowserHeadProvider {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly headProvider = $inject(HeadProvider);\n\n  protected get document(): Document {\n    return window.document;\n  }\n\n  /**\n   * Fill head state from route configurations and render to document.\n   * Combines fillHead from HeadProvider with renderHead to the DOM.\n   *\n   * Only runs in browser environment - no-op on server.\n   */\n  public fillAndRenderHead(state: { head: Head; layers: Array<any> }): void {\n    // Skip on server-side\n    if (!this.alepha.isBrowser()) {\n      return;\n    }\n\n    this.headProvider.fillHead(state as any);\n    if (state.head) {\n      this.renderHead(this.document, state.head);\n    }\n  }\n\n  /**\n   * Re-evaluate all global $head entries and apply the result to the DOM.\n   *\n   * Call this when something that affects global $head output changes at runtime\n   * (e.g., theme switch). Page-level head (title, meta from routes) is not touched.\n   */\n  public refreshGlobalHead(): void {\n    const head = this.headProvider.resolveGlobal();\n    this.renderHead(this.document, head);\n  }\n\n  public getHead(document: Document): Head {\n    return {\n      get title() {\n        return document.title;\n      },\n      get htmlAttributes() {\n        const attrs: Record<string, string> = {};\n        for (const attr of document.documentElement.attributes) {\n          attrs[attr.name] = attr.value;\n        }\n        return attrs;\n      },\n      get bodyAttributes() {\n        const attrs: Record<string, string> = {};\n        for (const attr of document.body.attributes) {\n          attrs[attr.name] = attr.value;\n        }\n        return attrs;\n      },\n      get meta() {\n        const metas: HeadMeta[] = [];\n        // Get meta tags with name attribute\n        for (const meta of document.head.querySelectorAll(\"meta[name]\")) {\n          const name = meta.getAttribute(\"name\");\n          const content = meta.getAttribute(\"content\");\n          if (name && content) {\n            metas.push({ name, content });\n          }\n        }\n        // Get meta tags with property attribute (OpenGraph)\n        for (const meta of document.head.querySelectorAll(\"meta[property]\")) {\n          const property = meta.getAttribute(\"property\");\n          const content = meta.getAttribute(\"content\");\n          if (property && content) {\n            metas.push({ property, content });\n          }\n        }\n        return metas;\n      },\n    };\n  }\n\n  public renderHead(document: Document, head: Head): void {\n    if (head.title) {\n      document.title = head.title;\n    }\n\n    if (head.bodyAttributes) {\n      for (const [key, value] of Object.entries(head.bodyAttributes)) {\n        if (value) {\n          document.body.setAttribute(key, value);\n        } else {\n          document.body.removeAttribute(key);\n        }\n      }\n    }\n\n    if (head.htmlAttributes) {\n      for (const [key, value] of Object.entries(head.htmlAttributes)) {\n        if (value) {\n          document.documentElement.setAttribute(key, value);\n        } else {\n          document.documentElement.removeAttribute(key);\n        }\n      }\n    }\n\n    if (head.meta) {\n      for (const it of head.meta) {\n        this.renderMetaTag(document, it);\n      }\n    }\n\n    if (head.link) {\n      for (const it of head.link) {\n        const { rel, href } = it;\n        let link = document.querySelector(`link[rel=\"${rel}\"][href=\"${href}\"]`);\n        if (!link) {\n          link = document.createElement(\"link\");\n          link.setAttribute(\"rel\", rel);\n          link.setAttribute(\"href\", href);\n          if (it.type) {\n            link.setAttribute(\"type\", it.type);\n          }\n          if (it.as) {\n            link.setAttribute(\"as\", it.as);\n          }\n          if (it.crossorigin != null) {\n            link.setAttribute(\"crossorigin\", \"\");\n          }\n          document.head.appendChild(link);\n        }\n      }\n    }\n\n    if (head.script) {\n      for (const it of head.script) {\n        this.renderScriptTag(document, it);\n      }\n    }\n  }\n\n  protected renderScriptTag(\n    document: Document,\n    script:\n      | string\n      | (Record<string, string | boolean | undefined> & { content?: string }),\n  ): void {\n    // Plain string → inline script. Dedupe by exact content match against\n    // any existing inline script (handles SSR-emitted globals that would\n    // otherwise be re-appended on hydration).\n    if (typeof script === \"string\") {\n      if (this.findInlineScriptByContent(document, script)) return;\n      const el = document.createElement(\"script\");\n      el.textContent = script;\n      document.head.appendChild(el);\n      return;\n    }\n\n    const { content, ...attrs } = script;\n\n    // src-based scripts: dedupe by src attribute (existing behaviour).\n    if (attrs.src) {\n      if (document.querySelector(`script[src=\"${attrs.src}\"]`)) return;\n    } else if (typeof attrs.id === \"string\") {\n      // id-based dedupe — single source of truth per id.\n      if (document.querySelector(`script#${CSS.escape(attrs.id)}`)) return;\n    } else if (content) {\n      // Inline scripts with `content` and no src/id: fall back to content match.\n      if (this.findInlineScriptByContent(document, content)) return;\n    }\n\n    const el = document.createElement(\"script\");\n    for (const [key, value] of Object.entries(attrs)) {\n      if (value === true) {\n        el.setAttribute(key, \"\");\n      } else if (value !== undefined && value !== false) {\n        el.setAttribute(key, String(value));\n      }\n    }\n    if (content) {\n      el.textContent = content;\n    }\n    document.head.appendChild(el);\n  }\n\n  /**\n   * Find an existing inline `<script>` tag (no `src`) with matching textContent.\n   * Used to make `renderScriptTag` idempotent across hydration + navigation,\n   * so SSR-emitted global scripts aren't re-appended client-side.\n   */\n  protected findInlineScriptByContent(\n    document: Document,\n    content: string,\n  ): Element | null {\n    for (const existing of document.head.querySelectorAll(\n      \"script:not([src])\",\n    )) {\n      if (existing.textContent === content) return existing;\n    }\n    return null;\n  }\n\n  protected renderMetaTag(document: Document, meta: HeadMeta): void {\n    const { content } = meta;\n\n    // Handle OpenGraph tags (property attribute)\n    if (meta.property) {\n      const existing = document.querySelector(\n        `meta[property=\"${meta.property}\"]`,\n      );\n      if (existing) {\n        existing.setAttribute(\"content\", content);\n      } else {\n        const newMeta = document.createElement(\"meta\");\n        newMeta.setAttribute(\"property\", meta.property);\n        newMeta.setAttribute(\"content\", content);\n        document.head.appendChild(newMeta);\n      }\n      return;\n    }\n\n    // Handle standard meta tags (name attribute)\n    if (meta.name) {\n      const existing = document.querySelector(`meta[name=\"${meta.name}\"]`);\n      if (existing) {\n        existing.setAttribute(\"content\", content);\n      } else {\n        const newMeta = document.createElement(\"meta\");\n        newMeta.setAttribute(\"name\", meta.name);\n        newMeta.setAttribute(\"content\", content);\n        document.head.appendChild(newMeta);\n      }\n    }\n  }\n}\n","import { Alepha } from \"alepha\";\nimport { useInject } from \"alepha/react\";\nimport { useCallback, useEffect, useMemo } from \"react\";\nimport type { Head } from \"../interfaces/Head.ts\";\nimport { BrowserHeadProvider } from \"../providers/BrowserHeadProvider.ts\";\n\n/**\n * ```tsx\n * const App = () => {\n *   const [head, setHead] = useHead({\n *     // will set the document title on the first render\n *     title: \"My App\",\n *   });\n *\n *   return (\n *     // This will update the document title when the button is clicked\n *     <button onClick={() => setHead({ title: \"Change Title\" })}>\n *       Change Title {head.title}\n *     </button>\n *   );\n * }\n * ```\n */\nexport const useHead = (options?: UseHeadOptions): UseHeadReturn => {\n  const alepha = useInject(Alepha);\n\n  const current = useMemo(() => {\n    if (!alepha.isBrowser()) {\n      return {};\n    }\n\n    return alepha.inject(BrowserHeadProvider).getHead(window.document);\n  }, []);\n\n  const setHead = useCallback((head?: Head | ((previous?: Head) => Head)) => {\n    if (!alepha.isBrowser()) {\n      return;\n    }\n\n    const headProvider = alepha.inject(BrowserHeadProvider);\n    const resolved =\n      typeof head === \"function\"\n        ? head(headProvider.getHead(window.document))\n        : head || {};\n    headProvider.renderHead(window.document, resolved);\n  }, []);\n\n  useEffect(() => {\n    if (options) {\n      setHead(options);\n    }\n  }, []);\n\n  return [current, setHead];\n};\n\nexport type UseHeadOptions = Head | ((previous?: Head) => Head);\n\nexport type UseHeadReturn = [\n  Head,\n  (head?: Head | ((previous?: Head) => Head)) => void,\n];\n","import { $module } from \"alepha\";\nimport { AlephaReact } from \"alepha/react\";\nimport { $head } from \"./primitives/$head.ts\";\nimport { BrowserHeadProvider } from \"./providers/BrowserHeadProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./helpers/SeoExpander.ts\";\nexport * from \"./hooks/useHead.ts\";\nexport * from \"./interfaces/Head.ts\";\nexport * from \"./primitives/$head.ts\";\nexport * from \"./providers/BrowserHeadProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Alepha React Head Module\n *\n * @see {@link BrowserHeadProvider}\n * @module alepha.react.head\n */\nexport const AlephaReactHead = $module({\n  name: \"alepha.react.head\",\n  primitives: [$head],\n  services: [AlephaReact, BrowserHeadProvider],\n});\n"],"mappings":"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"}

package/dist/react/head/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/react/head/helpers/SeoExpander.ts","../../../src/react/head/providers/HeadProvider.ts","../../../src/react/head/primitives/$head.ts","../../../src/react/head/providers/BrowserHeadProvider.ts","../../../src/react/head/providers/ServerHeadProvider.ts","../../../src/react/head/hooks/useHead.ts","../../../src/react/head/index.ts"],"sourcesContent":["import type { Head, HeadMeta } from \"../interfaces/Head.ts\";\n\n/**\n * Expands Head configuration into SEO meta tags.\n *\n * Generates:\n * - `<meta name=\"description\">` from head.description\n * - `<meta property=\"og:*\">` OpenGraph tags\n * - `<meta name=\"twitter:*\">` Twitter Card tags\n *\n * @example\n * ```ts\n * const helper = new SeoExpander();\n * const { meta, link } = helper.expand({\n *   title: \"My App\",\n *   description: \"Build amazing apps\",\n *   image: \"https://example.com/og.png\",\n *   url: \"https://example.com/\",\n * });\n * ```\n */\nexport class SeoExpander {\n  public expand(head: Head): {\n    meta: HeadMeta[];\n    link: Array<{ rel: string; href: string }>;\n  } {\n    const meta: HeadMeta[] = [];\n    const link: Array<{ rel: string; href: string }> = [];\n\n    // Only expand SEO if there's meaningful content beyond just title\n    const hasSeoContent =\n      head.description ||\n      head.image ||\n      head.url ||\n      head.siteName ||\n      head.locale ||\n      head.type ||\n      head.og ||\n      head.twitter;\n\n    if (!hasSeoContent) {\n      return { meta, link };\n    }\n\n    // Base description\n    if (head.description) {\n      meta.push({ name: \"description\", content: head.description });\n    }\n\n    // Canonical URL\n    if (head.url) {\n      link.push({ rel: \"canonical\", href: head.url });\n    }\n\n    // OpenGraph tags\n    this.expandOpenGraph(head, meta);\n\n    // Twitter Card tags\n    this.expandTwitter(head, meta);\n\n    return { meta, link };\n  }\n\n  protected expandOpenGraph(head: Head, meta: HeadMeta[]): void {\n    const ogTitle = head.og?.title ?? head.title;\n    const ogDescription = head.og?.description ?? head.description;\n    const ogImage = head.og?.image ?? head.image;\n\n    if (head.type || ogTitle) {\n      meta.push({ property: \"og:type\", content: head.type ?? \"website\" });\n    }\n    if (head.url) {\n      meta.push({ property: \"og:url\", content: head.url });\n    }\n    if (ogTitle) {\n      meta.push({ property: \"og:title\", content: ogTitle });\n    }\n    if (ogDescription) {\n      meta.push({ property: \"og:description\", content: ogDescription });\n    }\n    if (ogImage) {\n      meta.push({ property: \"og:image\", content: ogImage });\n      if (head.imageWidth) {\n        meta.push({\n          property: \"og:image:width\",\n          content: String(head.imageWidth),\n        });\n      }\n      if (head.imageHeight) {\n        meta.push({\n          property: \"og:image:height\",\n          content: String(head.imageHeight),\n        });\n      }\n      if (head.imageAlt) {\n        meta.push({ property: \"og:image:alt\", content: head.imageAlt });\n      }\n    }\n    if (head.siteName) {\n      meta.push({ property: \"og:site_name\", content: head.siteName });\n    }\n    if (head.locale) {\n      meta.push({ property: \"og:locale\", content: head.locale });\n    }\n  }\n\n  protected expandTwitter(head: Head, meta: HeadMeta[]): void {\n    const twitterTitle = head.twitter?.title ?? head.title;\n    const twitterDescription = head.twitter?.description ?? head.description;\n    const twitterImage = head.twitter?.image ?? head.image;\n\n    if (head.twitter?.card || twitterTitle || twitterImage) {\n      meta.push({\n        name: \"twitter:card\",\n        content:\n          head.twitter?.card ??\n          (twitterImage ? \"summary_large_image\" : \"summary\"),\n      });\n    }\n    if (head.url) {\n      meta.push({ name: \"twitter:url\", content: head.url });\n    }\n    if (twitterTitle) {\n      meta.push({ name: \"twitter:title\", content: twitterTitle });\n    }\n    if (twitterDescription) {\n      meta.push({ name: \"twitter:description\", content: twitterDescription });\n    }\n    if (twitterImage) {\n      meta.push({ name: \"twitter:image\", content: twitterImage });\n      if (head.imageAlt) {\n        meta.push({ name: \"twitter:image:alt\", content: head.imageAlt });\n      }\n    }\n    if (head.twitter?.site) {\n      meta.push({ name: \"twitter:site\", content: head.twitter.site });\n    }\n    if (head.twitter?.creator) {\n      meta.push({ name: \"twitter:creator\", content: head.twitter.creator });\n    }\n  }\n}\n","import { $inject } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { SeoExpander } from \"../helpers/SeoExpander.ts\";\nimport type { Head } from \"../interfaces/Head.ts\";\n\n/**\n * Provides methods to fill and merge head information into the application state.\n *\n * Used both on server and client side to manage document head.\n *\n * @see {@link SeoExpander}\n * @see {@link ServerHeadProvider}\n * @see {@link BrowserHeadProvider}\n */\nexport class HeadProvider {\n  protected readonly log = $logger();\n  protected readonly seoExpander = $inject(SeoExpander);\n\n  public global?: Array<Head | (() => Head)> = [];\n\n  /**\n   * Track if we've warned about page-level htmlAttributes to avoid spam.\n   */\n  protected warnedAboutHtmlAttributes = false;\n\n  /**\n   * Resolve global head configuration (from $head primitives only).\n   *\n   * This is used to get htmlAttributes early, before page loaders run.\n   * Only htmlAttributes from global $head are allowed; page-level htmlAttributes\n   * are ignored for early streaming optimization.\n   *\n   * @returns Merged global head with htmlAttributes\n   */\n  public resolveGlobalHead(): Head {\n    const head: Head = {\n      htmlAttributes: { lang: \"en\" },\n    };\n\n    for (const h of this.global ?? []) {\n      const resolved = typeof h === \"function\" ? h() : h;\n      if (resolved.htmlAttributes) {\n        head.htmlAttributes = {\n          ...head.htmlAttributes,\n          ...resolved.htmlAttributes,\n        };\n      }\n    }\n\n    return head;\n  }\n\n  /**\n   * Fully resolve all global $head entries (functions re-evaluated, objects kept as-is).\n   *\n   * Unlike resolveGlobalHead() which only extracts htmlAttributes for streaming,\n   * this resolves all head properties (meta, link, script, htmlAttributes, etc.).\n   *\n   * Used by BrowserHeadProvider.refreshGlobalHead() to re-apply global head to the DOM.\n   */\n  public resolveGlobal(): Head {\n    let head: Head = {};\n\n    for (const h of this.global ?? []) {\n      const resolved = typeof h === \"function\" ? h() : h;\n      const { meta, link } = this.seoExpander.expand(resolved);\n      head = {\n        ...head,\n        ...resolved,\n        meta: [...(head.meta ?? []), ...meta, ...(resolved.meta ?? [])],\n        link: [...(head.link ?? []), ...link, ...(resolved.link ?? [])],\n        script: [...(head.script ?? []), ...(resolved.script ?? [])],\n      };\n    }\n\n    return head;\n  }\n\n  public fillHead(state: HeadState) {\n    state.head = {\n      ...state.head,\n    };\n\n    for (const h of this.global ?? []) {\n      const head = typeof h === \"function\" ? h() : h;\n      this.mergeHead(state, head);\n    }\n\n    for (const layer of state.layers) {\n      if (layer.route?.head && !layer.error) {\n        this.fillHeadByPage(layer.route, state, layer.props ?? {});\n      }\n    }\n\n    // Defaults if none were set by global $head or page head\n    state.head.title ??= \"App\";\n    state.head.htmlAttributes = {\n      lang: \"en\",\n      ...state.head.htmlAttributes,\n    };\n  }\n\n  protected mergeHead(state: HeadState, head: Head): void {\n    // Expand SEO fields into meta tags\n    const { meta, link } = this.seoExpander.expand(head);\n    state.head = {\n      ...state.head,\n      ...head,\n      meta: [...(state.head.meta ?? []), ...meta, ...(head.meta ?? [])],\n      link: [...(state.head.link ?? []), ...link, ...(head.link ?? [])],\n      script: [...(state.head.script ?? []), ...(head.script ?? [])],\n    };\n  }\n\n  protected fillHeadByPage(\n    page: HeadRoute,\n    state: HeadState,\n    props: Record<string, any>,\n  ): void {\n    if (!page.head) {\n      return;\n    }\n\n    state.head ??= {};\n\n    const head =\n      typeof page.head === \"function\"\n        ? page.head(props, state.head)\n        : page.head;\n\n    // Expand SEO fields into meta tags\n    const { meta, link } = this.seoExpander.expand(head);\n    state.head.meta = [...(state.head.meta ?? []), ...meta];\n    state.head.link = [...(state.head.link ?? []), ...link];\n\n    if (head.title) {\n      state.head ??= {};\n\n      if (state.head.titleSeparator) {\n        state.head.title = `${head.title}${state.head.titleSeparator}${state.head.title}`;\n      } else {\n        state.head.title = head.title;\n      }\n\n      state.head.titleSeparator = head.titleSeparator;\n    }\n\n    // htmlAttributes from pages are ignored for early streaming optimization.\n    // Only global $head can set htmlAttributes.\n    if (head.htmlAttributes && !this.warnedAboutHtmlAttributes) {\n      this.warnedAboutHtmlAttributes = true;\n      this.log.warn(\n        \"Page-level htmlAttributes are ignored. Use global $head() for htmlAttributes instead, \" +\n          \"as they are sent before page loaders run for early streaming optimization.\",\n      );\n    }\n\n    if (head.bodyAttributes) {\n      state.head.bodyAttributes = {\n        ...state.head.bodyAttributes,\n        ...head.bodyAttributes,\n      };\n    }\n\n    if (head.meta) {\n      state.head.meta = [...(state.head.meta ?? []), ...(head.meta ?? [])];\n    }\n\n    if (head.link) {\n      state.head.link = [...(state.head.link ?? []), ...(head.link ?? [])];\n    }\n\n    if (head.script) {\n      state.head.script = [\n        ...(state.head.script ?? []),\n        ...(head.script ?? []),\n      ];\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Minimal route interface for head processing.\n * Avoids circular dependency with alepha/react/router.\n */\ninterface HeadRoute {\n  head?: Head | ((props: Record<string, any>, previous?: Head) => Head);\n}\n\n/**\n * Minimal state interface for head processing.\n * Avoids circular dependency with alepha/react/router.\n */\ninterface HeadState {\n  head: Head;\n  layers: Array<{\n    route?: HeadRoute;\n    props?: Record<string, any>;\n    error?: Error;\n  }>;\n}\n","import { $inject, createPrimitive, KIND, Primitive } from \"alepha\";\nimport type { Head } from \"../interfaces/Head.ts\";\nimport { HeadProvider } from \"../providers/HeadProvider.ts\";\n\n/**\n * Set global `<head>` options for the application.\n */\nexport const $head = (options: HeadPrimitiveOptions) => {\n  return createPrimitive(HeadPrimitive, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport type HeadPrimitiveOptions = Head | (() => Head);\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class HeadPrimitive extends Primitive<HeadPrimitiveOptions> {\n  protected readonly provider = $inject(HeadProvider);\n  protected onInit() {\n    this.provider.global = [...(this.provider.global ?? []), this.options];\n  }\n}\n\n$head[KIND] = HeadPrimitive;\n","import { $inject, Alepha } from \"alepha\";\nimport type { Head, HeadMeta } from \"../interfaces/Head.ts\";\nimport { HeadProvider } from \"./HeadProvider.ts\";\n\n/**\n * Browser-side head provider that manages document head elements.\n *\n * Used by ReactBrowserProvider and ReactBrowserRouterProvider to update\n * document title, meta tags, and other head elements during client-side\n * navigation.\n */\nexport class BrowserHeadProvider {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly headProvider = $inject(HeadProvider);\n\n  protected get document(): Document {\n    return window.document;\n  }\n\n  /**\n   * Fill head state from route configurations and render to document.\n   * Combines fillHead from HeadProvider with renderHead to the DOM.\n   *\n   * Only runs in browser environment - no-op on server.\n   */\n  public fillAndRenderHead(state: { head: Head; layers: Array<any> }): void {\n    // Skip on server-side\n    if (!this.alepha.isBrowser()) {\n      return;\n    }\n\n    this.headProvider.fillHead(state as any);\n    if (state.head) {\n      this.renderHead(this.document, state.head);\n    }\n  }\n\n  /**\n   * Re-evaluate all global $head entries and apply the result to the DOM.\n   *\n   * Call this when something that affects global $head output changes at runtime\n   * (e.g., theme switch). Page-level head (title, meta from routes) is not touched.\n   */\n  public refreshGlobalHead(): void {\n    const head = this.headProvider.resolveGlobal();\n    this.renderHead(this.document, head);\n  }\n\n  public getHead(document: Document): Head {\n    return {\n      get title() {\n        return document.title;\n      },\n      get htmlAttributes() {\n        const attrs: Record<string, string> = {};\n        for (const attr of document.documentElement.attributes) {\n          attrs[attr.name] = attr.value;\n        }\n        return attrs;\n      },\n      get bodyAttributes() {\n        const attrs: Record<string, string> = {};\n        for (const attr of document.body.attributes) {\n          attrs[attr.name] = attr.value;\n        }\n        return attrs;\n      },\n      get meta() {\n        const metas: HeadMeta[] = [];\n        // Get meta tags with name attribute\n        for (const meta of document.head.querySelectorAll(\"meta[name]\")) {\n          const name = meta.getAttribute(\"name\");\n          const content = meta.getAttribute(\"content\");\n          if (name && content) {\n            metas.push({ name, content });\n          }\n        }\n        // Get meta tags with property attribute (OpenGraph)\n        for (const meta of document.head.querySelectorAll(\"meta[property]\")) {\n          const property = meta.getAttribute(\"property\");\n          const content = meta.getAttribute(\"content\");\n          if (property && content) {\n            metas.push({ property, content });\n          }\n        }\n        return metas;\n      },\n    };\n  }\n\n  public renderHead(document: Document, head: Head): void {\n    if (head.title) {\n      document.title = head.title;\n    }\n\n    if (head.bodyAttributes) {\n      for (const [key, value] of Object.entries(head.bodyAttributes)) {\n        if (value) {\n          document.body.setAttribute(key, value);\n        } else {\n          document.body.removeAttribute(key);\n        }\n      }\n    }\n\n    if (head.htmlAttributes) {\n      for (const [key, value] of Object.entries(head.htmlAttributes)) {\n        if (value) {\n          document.documentElement.setAttribute(key, value);\n        } else {\n          document.documentElement.removeAttribute(key);\n        }\n      }\n    }\n\n    if (head.meta) {\n      for (const it of head.meta) {\n        this.renderMetaTag(document, it);\n      }\n    }\n\n    if (head.link) {\n      for (const it of head.link) {\n        const { rel, href } = it;\n        let link = document.querySelector(`link[rel=\"${rel}\"][href=\"${href}\"]`);\n        if (!link) {\n          link = document.createElement(\"link\");\n          link.setAttribute(\"rel\", rel);\n          link.setAttribute(\"href\", href);\n          if (it.type) {\n            link.setAttribute(\"type\", it.type);\n          }\n          if (it.as) {\n            link.setAttribute(\"as\", it.as);\n          }\n          if (it.crossorigin != null) {\n            link.setAttribute(\"crossorigin\", \"\");\n          }\n          document.head.appendChild(link);\n        }\n      }\n    }\n\n    if (head.script) {\n      for (const it of head.script) {\n        this.renderScriptTag(document, it);\n      }\n    }\n  }\n\n  protected renderScriptTag(\n    document: Document,\n    script:\n      | string\n      | (Record<string, string | boolean | undefined> & { content?: string }),\n  ): void {\n    // Plain string → inline script. Dedupe by exact content match against\n    // any existing inline script (handles SSR-emitted globals that would\n    // otherwise be re-appended on hydration).\n    if (typeof script === \"string\") {\n      if (this.findInlineScriptByContent(document, script)) return;\n      const el = document.createElement(\"script\");\n      el.textContent = script;\n      document.head.appendChild(el);\n      return;\n    }\n\n    const { content, ...attrs } = script;\n\n    // src-based scripts: dedupe by src attribute (existing behaviour).\n    if (attrs.src) {\n      if (document.querySelector(`script[src=\"${attrs.src}\"]`)) return;\n    } else if (typeof attrs.id === \"string\") {\n      // id-based dedupe — single source of truth per id.\n      if (document.querySelector(`script#${CSS.escape(attrs.id)}`)) return;\n    } else if (content) {\n      // Inline scripts with `content` and no src/id: fall back to content match.\n      if (this.findInlineScriptByContent(document, content)) return;\n    }\n\n    const el = document.createElement(\"script\");\n    for (const [key, value] of Object.entries(attrs)) {\n      if (value === true) {\n        el.setAttribute(key, \"\");\n      } else if (value !== undefined && value !== false) {\n        el.setAttribute(key, String(value));\n      }\n    }\n    if (content) {\n      el.textContent = content;\n    }\n    document.head.appendChild(el);\n  }\n\n  /**\n   * Find an existing inline `<script>` tag (no `src`) with matching textContent.\n   * Used to make `renderScriptTag` idempotent across hydration + navigation,\n   * so SSR-emitted global scripts aren't re-appended client-side.\n   */\n  protected findInlineScriptByContent(\n    document: Document,\n    content: string,\n  ): Element | null {\n    for (const existing of document.head.querySelectorAll(\n      \"script:not([src])\",\n    )) {\n      if (existing.textContent === content) return existing;\n    }\n    return null;\n  }\n\n  protected renderMetaTag(document: Document, meta: HeadMeta): void {\n    const { content } = meta;\n\n    // Handle OpenGraph tags (property attribute)\n    if (meta.property) {\n      const existing = document.querySelector(\n        `meta[property=\"${meta.property}\"]`,\n      );\n      if (existing) {\n        existing.setAttribute(\"content\", content);\n      } else {\n        const newMeta = document.createElement(\"meta\");\n        newMeta.setAttribute(\"property\", meta.property);\n        newMeta.setAttribute(\"content\", content);\n        document.head.appendChild(newMeta);\n      }\n      return;\n    }\n\n    // Handle standard meta tags (name attribute)\n    if (meta.name) {\n      const existing = document.querySelector(`meta[name=\"${meta.name}\"]`);\n      if (existing) {\n        existing.setAttribute(\"content\", content);\n      } else {\n        const newMeta = document.createElement(\"meta\");\n        newMeta.setAttribute(\"name\", meta.name);\n        newMeta.setAttribute(\"content\", content);\n        document.head.appendChild(newMeta);\n      }\n    }\n  }\n}\n","import { $inject } from \"alepha\";\nimport type { Head, SimpleHead } from \"../interfaces/Head.ts\";\nimport { HeadProvider } from \"./HeadProvider.ts\";\n\n/**\n * Server-side head provider that fills head content from route configurations.\n *\n * Used by ReactServerProvider to collect title, meta tags, and other head\n * elements which are then rendered by ReactServerTemplateProvider.\n */\nexport class ServerHeadProvider {\n  protected readonly headProvider = $inject(HeadProvider);\n\n  /**\n   * Resolve global head configuration (htmlAttributes only).\n   *\n   * Used for early streaming optimization - htmlAttributes can be sent\n   * before page loaders run since they come from global $head only.\n   */\n  public resolveGlobalHead(): Head {\n    return this.headProvider.resolveGlobalHead();\n  }\n\n  /**\n   * Fill head state from route configurations.\n   * Delegates to HeadProvider to merge head data from all route layers.\n   */\n  public fillHead(state: { head: SimpleHead; layers: Array<any> }): void {\n    this.headProvider.fillHead(state as any);\n  }\n}\n","import { Alepha } from \"alepha\";\nimport { useInject } from \"alepha/react\";\nimport { useCallback, useEffect, useMemo } from \"react\";\nimport type { Head } from \"../interfaces/Head.ts\";\nimport { BrowserHeadProvider } from \"../providers/BrowserHeadProvider.ts\";\n\n/**\n * ```tsx\n * const App = () => {\n *   const [head, setHead] = useHead({\n *     // will set the document title on the first render\n *     title: \"My App\",\n *   });\n *\n *   return (\n *     // This will update the document title when the button is clicked\n *     <button onClick={() => setHead({ title: \"Change Title\" })}>\n *       Change Title {head.title}\n *     </button>\n *   );\n * }\n * ```\n */\nexport const useHead = (options?: UseHeadOptions): UseHeadReturn => {\n  const alepha = useInject(Alepha);\n\n  const current = useMemo(() => {\n    if (!alepha.isBrowser()) {\n      return {};\n    }\n\n    return alepha.inject(BrowserHeadProvider).getHead(window.document);\n  }, []);\n\n  const setHead = useCallback((head?: Head | ((previous?: Head) => Head)) => {\n    if (!alepha.isBrowser()) {\n      return;\n    }\n\n    const headProvider = alepha.inject(BrowserHeadProvider);\n    const resolved =\n      typeof head === \"function\"\n        ? head(headProvider.getHead(window.document))\n        : head || {};\n    headProvider.renderHead(window.document, resolved);\n  }, []);\n\n  useEffect(() => {\n    if (options) {\n      setHead(options);\n    }\n  }, []);\n\n  return [current, setHead];\n};\n\nexport type UseHeadOptions = Head | ((previous?: Head) => Head);\n\nexport type UseHeadReturn = [\n  Head,\n  (head?: Head | ((previous?: Head) => Head)) => void,\n];\n","import { $module } from \"alepha\";\nimport { AlephaReact } from \"alepha/react\";\nimport { SeoExpander } from \"./helpers/SeoExpander.ts\";\nimport { $head } from \"./primitives/$head.ts\";\nimport { BrowserHeadProvider } from \"./providers/BrowserHeadProvider.ts\";\nimport { HeadProvider } from \"./providers/HeadProvider.ts\";\nimport { ServerHeadProvider } from \"./providers/ServerHeadProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./helpers/SeoExpander.ts\";\nexport * from \"./hooks/useHead.ts\";\nexport * from \"./interfaces/Head.ts\";\nexport * from \"./primitives/$head.ts\";\nexport * from \"./providers/BrowserHeadProvider.ts\";\nexport * from \"./providers/ServerHeadProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * HTML head element management.\n *\n * **Features:**\n * - Title, meta tags, and links\n * - SEO optimization\n * - Social media tags\n *\n * @module alepha.react.head\n */\nexport const AlephaReactHead = $module({\n  name: \"alepha.react.head\",\n  primitives: [$head],\n  services: [\n    AlephaReact,\n    BrowserHeadProvider,\n    HeadProvider,\n    SeoExpander,\n    ServerHeadProvider,\n  ],\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/react/head/helpers/SeoExpander.ts","../../../src/react/head/providers/HeadProvider.ts","../../../src/react/head/primitives/$head.ts","../../../src/react/head/providers/BrowserHeadProvider.ts","../../../src/react/head/providers/ServerHeadProvider.ts","../../../src/react/head/hooks/useHead.ts","../../../src/react/head/index.ts"],"sourcesContent":["import type { Head, HeadMeta } from \"../interfaces/Head.ts\";\n\n/**\n * Expands Head configuration into SEO meta tags.\n *\n * Generates:\n * - `<meta name=\"description\">` from head.description\n * - `<meta property=\"og:*\">` OpenGraph tags\n * - `<meta name=\"twitter:*\">` Twitter Card tags\n *\n * @example\n * ```ts\n * const helper = new SeoExpander();\n * const { meta, link } = helper.expand({\n *   title: \"My App\",\n *   description: \"Build amazing apps\",\n *   image: \"https://example.com/og.png\",\n *   url: \"https://example.com/\",\n * });\n * ```\n */\nexport class SeoExpander {\n  public expand(head: Head): {\n    meta: HeadMeta[];\n    link: Array<{ rel: string; href: string }>;\n  } {\n    const meta: HeadMeta[] = [];\n    const link: Array<{ rel: string; href: string }> = [];\n\n    // Only expand SEO if there's meaningful content beyond just title\n    const hasSeoContent =\n      head.description ||\n      head.image ||\n      head.url ||\n      head.siteName ||\n      head.locale ||\n      head.type ||\n      head.og ||\n      head.twitter;\n\n    if (!hasSeoContent) {\n      return { meta, link };\n    }\n\n    // Base description\n    if (head.description) {\n      meta.push({ name: \"description\", content: head.description });\n    }\n\n    // Canonical URL\n    if (head.url) {\n      link.push({ rel: \"canonical\", href: head.url });\n    }\n\n    // OpenGraph tags\n    this.expandOpenGraph(head, meta);\n\n    // Twitter Card tags\n    this.expandTwitter(head, meta);\n\n    return { meta, link };\n  }\n\n  protected expandOpenGraph(head: Head, meta: HeadMeta[]): void {\n    const ogTitle = head.og?.title ?? head.title;\n    const ogDescription = head.og?.description ?? head.description;\n    const ogImage = head.og?.image ?? head.image;\n\n    if (head.type || ogTitle) {\n      meta.push({ property: \"og:type\", content: head.type ?? \"website\" });\n    }\n    if (head.url) {\n      meta.push({ property: \"og:url\", content: head.url });\n    }\n    if (ogTitle) {\n      meta.push({ property: \"og:title\", content: ogTitle });\n    }\n    if (ogDescription) {\n      meta.push({ property: \"og:description\", content: ogDescription });\n    }\n    if (ogImage) {\n      meta.push({ property: \"og:image\", content: ogImage });\n      if (head.imageWidth) {\n        meta.push({\n          property: \"og:image:width\",\n          content: String(head.imageWidth),\n        });\n      }\n      if (head.imageHeight) {\n        meta.push({\n          property: \"og:image:height\",\n          content: String(head.imageHeight),\n        });\n      }\n      if (head.imageAlt) {\n        meta.push({ property: \"og:image:alt\", content: head.imageAlt });\n      }\n    }\n    if (head.siteName) {\n      meta.push({ property: \"og:site_name\", content: head.siteName });\n    }\n    if (head.locale) {\n      meta.push({ property: \"og:locale\", content: head.locale });\n    }\n  }\n\n  protected expandTwitter(head: Head, meta: HeadMeta[]): void {\n    const twitterTitle = head.twitter?.title ?? head.title;\n    const twitterDescription = head.twitter?.description ?? head.description;\n    const twitterImage = head.twitter?.image ?? head.image;\n\n    if (head.twitter?.card || twitterTitle || twitterImage) {\n      meta.push({\n        name: \"twitter:card\",\n        content:\n          head.twitter?.card ??\n          (twitterImage ? \"summary_large_image\" : \"summary\"),\n      });\n    }\n    if (head.url) {\n      meta.push({ name: \"twitter:url\", content: head.url });\n    }\n    if (twitterTitle) {\n      meta.push({ name: \"twitter:title\", content: twitterTitle });\n    }\n    if (twitterDescription) {\n      meta.push({ name: \"twitter:description\", content: twitterDescription });\n    }\n    if (twitterImage) {\n      meta.push({ name: \"twitter:image\", content: twitterImage });\n      if (head.imageAlt) {\n        meta.push({ name: \"twitter:image:alt\", content: head.imageAlt });\n      }\n    }\n    if (head.twitter?.site) {\n      meta.push({ name: \"twitter:site\", content: head.twitter.site });\n    }\n    if (head.twitter?.creator) {\n      meta.push({ name: \"twitter:creator\", content: head.twitter.creator });\n    }\n  }\n}\n","import { $inject } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { SeoExpander } from \"../helpers/SeoExpander.ts\";\nimport type { Head } from \"../interfaces/Head.ts\";\n\n/**\n * Provides methods to fill and merge head information into the application state.\n *\n * Used both on server and client side to manage document head.\n *\n * @see {@link SeoExpander}\n * @see {@link ServerHeadProvider}\n * @see {@link BrowserHeadProvider}\n */\nexport class HeadProvider {\n  protected readonly log = $logger();\n  protected readonly seoExpander = $inject(SeoExpander);\n\n  public global?: Array<Head | (() => Head)> = [];\n\n  /**\n   * Track if we've warned about page-level htmlAttributes to avoid spam.\n   */\n  protected warnedAboutHtmlAttributes = false;\n\n  /**\n   * Resolve global head configuration (from $head primitives only).\n   *\n   * This is used to get htmlAttributes early, before page loaders run.\n   * Only htmlAttributes from global $head are allowed; page-level htmlAttributes\n   * are ignored for early streaming optimization.\n   *\n   * @returns Merged global head with htmlAttributes\n   */\n  public resolveGlobalHead(): Head {\n    const head: Head = {\n      htmlAttributes: { lang: \"en\" },\n    };\n\n    for (const h of this.global ?? []) {\n      const resolved = typeof h === \"function\" ? h() : h;\n      if (resolved.htmlAttributes) {\n        head.htmlAttributes = {\n          ...head.htmlAttributes,\n          ...resolved.htmlAttributes,\n        };\n      }\n    }\n\n    return head;\n  }\n\n  /**\n   * Fully resolve all global $head entries (functions re-evaluated, objects kept as-is).\n   *\n   * Unlike resolveGlobalHead() which only extracts htmlAttributes for streaming,\n   * this resolves all head properties (meta, link, script, htmlAttributes, etc.).\n   *\n   * Used by BrowserHeadProvider.refreshGlobalHead() to re-apply global head to the DOM.\n   */\n  public resolveGlobal(): Head {\n    let head: Head = {};\n\n    for (const h of this.global ?? []) {\n      const resolved = typeof h === \"function\" ? h() : h;\n      const { meta, link } = this.seoExpander.expand(resolved);\n      head = {\n        ...head,\n        ...resolved,\n        meta: [...(head.meta ?? []), ...meta, ...(resolved.meta ?? [])],\n        link: [...(head.link ?? []), ...link, ...(resolved.link ?? [])],\n        script: [...(head.script ?? []), ...(resolved.script ?? [])],\n      };\n    }\n\n    return head;\n  }\n\n  public fillHead(state: HeadState) {\n    state.head = {\n      ...state.head,\n    };\n\n    for (const h of this.global ?? []) {\n      const head = typeof h === \"function\" ? h() : h;\n      this.mergeHead(state, head);\n    }\n\n    for (const layer of state.layers) {\n      if (layer.route?.head && !layer.error) {\n        this.fillHeadByPage(layer.route, state, layer.props ?? {});\n      }\n    }\n\n    // Defaults if none were set by global $head or page head\n    state.head.title ??= \"App\";\n    state.head.htmlAttributes = {\n      lang: \"en\",\n      ...state.head.htmlAttributes,\n    };\n  }\n\n  protected mergeHead(state: HeadState, head: Head): void {\n    // Expand SEO fields into meta tags\n    const { meta, link } = this.seoExpander.expand(head);\n    state.head = {\n      ...state.head,\n      ...head,\n      meta: [...(state.head.meta ?? []), ...meta, ...(head.meta ?? [])],\n      link: [...(state.head.link ?? []), ...link, ...(head.link ?? [])],\n      script: [...(state.head.script ?? []), ...(head.script ?? [])],\n    };\n  }\n\n  protected fillHeadByPage(\n    page: HeadRoute,\n    state: HeadState,\n    props: Record<string, any>,\n  ): void {\n    if (!page.head) {\n      return;\n    }\n\n    state.head ??= {};\n\n    const head =\n      typeof page.head === \"function\"\n        ? page.head(props, state.head)\n        : page.head;\n\n    // Expand SEO fields into meta tags\n    const { meta, link } = this.seoExpander.expand(head);\n    state.head.meta = [...(state.head.meta ?? []), ...meta];\n    state.head.link = [...(state.head.link ?? []), ...link];\n\n    if (head.title) {\n      state.head ??= {};\n\n      if (state.head.titleSeparator) {\n        state.head.title = `${head.title}${state.head.titleSeparator}${state.head.title}`;\n      } else {\n        state.head.title = head.title;\n      }\n\n      state.head.titleSeparator = head.titleSeparator;\n    }\n\n    // htmlAttributes from pages are ignored for early streaming optimization.\n    // Only global $head can set htmlAttributes.\n    if (head.htmlAttributes && !this.warnedAboutHtmlAttributes) {\n      this.warnedAboutHtmlAttributes = true;\n      this.log.warn(\n        \"Page-level htmlAttributes are ignored. Use global $head() for htmlAttributes instead, \" +\n          \"as they are sent before page loaders run for early streaming optimization.\",\n      );\n    }\n\n    if (head.bodyAttributes) {\n      state.head.bodyAttributes = {\n        ...state.head.bodyAttributes,\n        ...head.bodyAttributes,\n      };\n    }\n\n    if (head.meta) {\n      state.head.meta = [...(state.head.meta ?? []), ...(head.meta ?? [])];\n    }\n\n    if (head.link) {\n      state.head.link = [...(state.head.link ?? []), ...(head.link ?? [])];\n    }\n\n    if (head.script) {\n      state.head.script = [\n        ...(state.head.script ?? []),\n        ...(head.script ?? []),\n      ];\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Minimal route interface for head processing.\n * Avoids circular dependency with alepha/react/router.\n */\ninterface HeadRoute {\n  head?: Head | ((props: Record<string, any>, previous?: Head) => Head);\n}\n\n/**\n * Minimal state interface for head processing.\n * Avoids circular dependency with alepha/react/router.\n */\ninterface HeadState {\n  head: Head;\n  layers: Array<{\n    route?: HeadRoute;\n    props?: Record<string, any>;\n    error?: Error;\n  }>;\n}\n","import { $inject, createPrimitive, KIND, Primitive } from \"alepha\";\nimport type { Head } from \"../interfaces/Head.ts\";\nimport { HeadProvider } from \"../providers/HeadProvider.ts\";\n\n/**\n * Set global `<head>` options for the application.\n */\nexport const $head = (options: HeadPrimitiveOptions) => {\n  return createPrimitive(HeadPrimitive, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport type HeadPrimitiveOptions = Head | (() => Head);\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class HeadPrimitive extends Primitive<HeadPrimitiveOptions> {\n  protected readonly provider = $inject(HeadProvider);\n  protected onInit() {\n    this.provider.global = [...(this.provider.global ?? []), this.options];\n  }\n}\n\n$head[KIND] = HeadPrimitive;\n","import { $inject, Alepha } from \"alepha\";\nimport type { Head, HeadMeta } from \"../interfaces/Head.ts\";\nimport { HeadProvider } from \"./HeadProvider.ts\";\n\n/**\n * Browser-side head provider that manages document head elements.\n *\n * Used by ReactBrowserProvider and ReactBrowserRouterProvider to update\n * document title, meta tags, and other head elements during client-side\n * navigation.\n */\nexport class BrowserHeadProvider {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly headProvider = $inject(HeadProvider);\n\n  protected get document(): Document {\n    return window.document;\n  }\n\n  /**\n   * Fill head state from route configurations and render to document.\n   * Combines fillHead from HeadProvider with renderHead to the DOM.\n   *\n   * Only runs in browser environment - no-op on server.\n   */\n  public fillAndRenderHead(state: { head: Head; layers: Array<any> }): void {\n    // Skip on server-side\n    if (!this.alepha.isBrowser()) {\n      return;\n    }\n\n    this.headProvider.fillHead(state as any);\n    if (state.head) {\n      this.renderHead(this.document, state.head);\n    }\n  }\n\n  /**\n   * Re-evaluate all global $head entries and apply the result to the DOM.\n   *\n   * Call this when something that affects global $head output changes at runtime\n   * (e.g., theme switch). Page-level head (title, meta from routes) is not touched.\n   */\n  public refreshGlobalHead(): void {\n    const head = this.headProvider.resolveGlobal();\n    this.renderHead(this.document, head);\n  }\n\n  public getHead(document: Document): Head {\n    return {\n      get title() {\n        return document.title;\n      },\n      get htmlAttributes() {\n        const attrs: Record<string, string> = {};\n        for (const attr of document.documentElement.attributes) {\n          attrs[attr.name] = attr.value;\n        }\n        return attrs;\n      },\n      get bodyAttributes() {\n        const attrs: Record<string, string> = {};\n        for (const attr of document.body.attributes) {\n          attrs[attr.name] = attr.value;\n        }\n        return attrs;\n      },\n      get meta() {\n        const metas: HeadMeta[] = [];\n        // Get meta tags with name attribute\n        for (const meta of document.head.querySelectorAll(\"meta[name]\")) {\n          const name = meta.getAttribute(\"name\");\n          const content = meta.getAttribute(\"content\");\n          if (name && content) {\n            metas.push({ name, content });\n          }\n        }\n        // Get meta tags with property attribute (OpenGraph)\n        for (const meta of document.head.querySelectorAll(\"meta[property]\")) {\n          const property = meta.getAttribute(\"property\");\n          const content = meta.getAttribute(\"content\");\n          if (property && content) {\n            metas.push({ property, content });\n          }\n        }\n        return metas;\n      },\n    };\n  }\n\n  public renderHead(document: Document, head: Head): void {\n    if (head.title) {\n      document.title = head.title;\n    }\n\n    if (head.bodyAttributes) {\n      for (const [key, value] of Object.entries(head.bodyAttributes)) {\n        if (value) {\n          document.body.setAttribute(key, value);\n        } else {\n          document.body.removeAttribute(key);\n        }\n      }\n    }\n\n    if (head.htmlAttributes) {\n      for (const [key, value] of Object.entries(head.htmlAttributes)) {\n        if (value) {\n          document.documentElement.setAttribute(key, value);\n        } else {\n          document.documentElement.removeAttribute(key);\n        }\n      }\n    }\n\n    if (head.meta) {\n      for (const it of head.meta) {\n        this.renderMetaTag(document, it);\n      }\n    }\n\n    if (head.link) {\n      for (const it of head.link) {\n        const { rel, href } = it;\n        let link = document.querySelector(`link[rel=\"${rel}\"][href=\"${href}\"]`);\n        if (!link) {\n          link = document.createElement(\"link\");\n          link.setAttribute(\"rel\", rel);\n          link.setAttribute(\"href\", href);\n          if (it.type) {\n            link.setAttribute(\"type\", it.type);\n          }\n          if (it.as) {\n            link.setAttribute(\"as\", it.as);\n          }\n          if (it.crossorigin != null) {\n            link.setAttribute(\"crossorigin\", \"\");\n          }\n          document.head.appendChild(link);\n        }\n      }\n    }\n\n    if (head.script) {\n      for (const it of head.script) {\n        this.renderScriptTag(document, it);\n      }\n    }\n  }\n\n  protected renderScriptTag(\n    document: Document,\n    script:\n      | string\n      | (Record<string, string | boolean | undefined> & { content?: string }),\n  ): void {\n    // Plain string → inline script. Dedupe by exact content match against\n    // any existing inline script (handles SSR-emitted globals that would\n    // otherwise be re-appended on hydration).\n    if (typeof script === \"string\") {\n      if (this.findInlineScriptByContent(document, script)) return;\n      const el = document.createElement(\"script\");\n      el.textContent = script;\n      document.head.appendChild(el);\n      return;\n    }\n\n    const { content, ...attrs } = script;\n\n    // src-based scripts: dedupe by src attribute (existing behaviour).\n    if (attrs.src) {\n      if (document.querySelector(`script[src=\"${attrs.src}\"]`)) return;\n    } else if (typeof attrs.id === \"string\") {\n      // id-based dedupe — single source of truth per id.\n      if (document.querySelector(`script#${CSS.escape(attrs.id)}`)) return;\n    } else if (content) {\n      // Inline scripts with `content` and no src/id: fall back to content match.\n      if (this.findInlineScriptByContent(document, content)) return;\n    }\n\n    const el = document.createElement(\"script\");\n    for (const [key, value] of Object.entries(attrs)) {\n      if (value === true) {\n        el.setAttribute(key, \"\");\n      } else if (value !== undefined && value !== false) {\n        el.setAttribute(key, String(value));\n      }\n    }\n    if (content) {\n      el.textContent = content;\n    }\n    document.head.appendChild(el);\n  }\n\n  /**\n   * Find an existing inline `<script>` tag (no `src`) with matching textContent.\n   * Used to make `renderScriptTag` idempotent across hydration + navigation,\n   * so SSR-emitted global scripts aren't re-appended client-side.\n   */\n  protected findInlineScriptByContent(\n    document: Document,\n    content: string,\n  ): Element | null {\n    for (const existing of document.head.querySelectorAll(\n      \"script:not([src])\",\n    )) {\n      if (existing.textContent === content) return existing;\n    }\n    return null;\n  }\n\n  protected renderMetaTag(document: Document, meta: HeadMeta): void {\n    const { content } = meta;\n\n    // Handle OpenGraph tags (property attribute)\n    if (meta.property) {\n      const existing = document.querySelector(\n        `meta[property=\"${meta.property}\"]`,\n      );\n      if (existing) {\n        existing.setAttribute(\"content\", content);\n      } else {\n        const newMeta = document.createElement(\"meta\");\n        newMeta.setAttribute(\"property\", meta.property);\n        newMeta.setAttribute(\"content\", content);\n        document.head.appendChild(newMeta);\n      }\n      return;\n    }\n\n    // Handle standard meta tags (name attribute)\n    if (meta.name) {\n      const existing = document.querySelector(`meta[name=\"${meta.name}\"]`);\n      if (existing) {\n        existing.setAttribute(\"content\", content);\n      } else {\n        const newMeta = document.createElement(\"meta\");\n        newMeta.setAttribute(\"name\", meta.name);\n        newMeta.setAttribute(\"content\", content);\n        document.head.appendChild(newMeta);\n      }\n    }\n  }\n}\n","import { $inject } from \"alepha\";\nimport type { Head, SimpleHead } from \"../interfaces/Head.ts\";\nimport { HeadProvider } from \"./HeadProvider.ts\";\n\n/**\n * Server-side head provider that fills head content from route configurations.\n *\n * Used by ReactServerProvider to collect title, meta tags, and other head\n * elements which are then rendered by ReactServerTemplateProvider.\n */\nexport class ServerHeadProvider {\n  protected readonly headProvider = $inject(HeadProvider);\n\n  /**\n   * Resolve global head configuration (htmlAttributes only).\n   *\n   * Used for early streaming optimization - htmlAttributes can be sent\n   * before page loaders run since they come from global $head only.\n   */\n  public resolveGlobalHead(): Head {\n    return this.headProvider.resolveGlobalHead();\n  }\n\n  /**\n   * Fill head state from route configurations.\n   * Delegates to HeadProvider to merge head data from all route layers.\n   */\n  public fillHead(state: { head: SimpleHead; layers: Array<any> }): void {\n    this.headProvider.fillHead(state as any);\n  }\n}\n","import { Alepha } from \"alepha\";\nimport { useInject } from \"alepha/react\";\nimport { useCallback, useEffect, useMemo } from \"react\";\nimport type { Head } from \"../interfaces/Head.ts\";\nimport { BrowserHeadProvider } from \"../providers/BrowserHeadProvider.ts\";\n\n/**\n * ```tsx\n * const App = () => {\n *   const [head, setHead] = useHead({\n *     // will set the document title on the first render\n *     title: \"My App\",\n *   });\n *\n *   return (\n *     // This will update the document title when the button is clicked\n *     <button onClick={() => setHead({ title: \"Change Title\" })}>\n *       Change Title {head.title}\n *     </button>\n *   );\n * }\n * ```\n */\nexport const useHead = (options?: UseHeadOptions): UseHeadReturn => {\n  const alepha = useInject(Alepha);\n\n  const current = useMemo(() => {\n    if (!alepha.isBrowser()) {\n      return {};\n    }\n\n    return alepha.inject(BrowserHeadProvider).getHead(window.document);\n  }, []);\n\n  const setHead = useCallback((head?: Head | ((previous?: Head) => Head)) => {\n    if (!alepha.isBrowser()) {\n      return;\n    }\n\n    const headProvider = alepha.inject(BrowserHeadProvider);\n    const resolved =\n      typeof head === \"function\"\n        ? head(headProvider.getHead(window.document))\n        : head || {};\n    headProvider.renderHead(window.document, resolved);\n  }, []);\n\n  useEffect(() => {\n    if (options) {\n      setHead(options);\n    }\n  }, []);\n\n  return [current, setHead];\n};\n\nexport type UseHeadOptions = Head | ((previous?: Head) => Head);\n\nexport type UseHeadReturn = [\n  Head,\n  (head?: Head | ((previous?: Head) => Head)) => void,\n];\n","import { $module } from \"alepha\";\nimport { AlephaReact } from \"alepha/react\";\nimport { SeoExpander } from \"./helpers/SeoExpander.ts\";\nimport { $head } from \"./primitives/$head.ts\";\nimport { BrowserHeadProvider } from \"./providers/BrowserHeadProvider.ts\";\nimport { HeadProvider } from \"./providers/HeadProvider.ts\";\nimport { ServerHeadProvider } from \"./providers/ServerHeadProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./helpers/SeoExpander.ts\";\nexport * from \"./hooks/useHead.ts\";\nexport * from \"./interfaces/Head.ts\";\nexport * from \"./primitives/$head.ts\";\nexport * from \"./providers/BrowserHeadProvider.ts\";\nexport * from \"./providers/ServerHeadProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * HTML head element management.\n *\n * **Features:**\n * - Title, meta tags, and links\n * - SEO optimization\n * - Social media tags\n *\n * @module alepha.react.head\n */\nexport const AlephaReactHead = $module({\n  name: \"alepha.react.head\",\n  primitives: [$head],\n  services: [\n    AlephaReact,\n    BrowserHeadProvider,\n    HeadProvider,\n    SeoExpander,\n    ServerHeadProvider,\n  ],\n});\n"],"mappings":"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"}