Lettras word search

Create a word-search puzzle (sopa de letras) from a list of words. Keeps native letters (Ñ, Ç, Ã, Ä, ẞ, È…) as one cell each. Returns the grid, where every word is hidden, and any words that did not fit. Empty cells are marked "-": call fill_word_search with the grid to complete it with random letters. The same seed always gives the same puzzle.

{
  "type": "object",
  "properties": {
    "classicMode": {
      "description": "Strip accents in the grid (ñ becomes N).",
      "type": "boolean"
    },
    "clustering": {
      "description": "0 keeps words apart, 1 makes them cross. Default 0.5.",
      "maximum": 1,
      "minimum": 0,
      "type": "number"
    },
    "cols": {
      "description": "Grid width. May differ from rows for a rectangular grid.",
      "maximum": 30,
      "minimum": 6,
      "type": "integer"
    },
    "difficulty": {
      "description": "Used when position is not set: 1 easy (right, down) to 4 expert (all 8 directions).",
      "maximum": 4,
      "minimum": 1,
      "type": "integer"
    },
    "lang": {
      "description": "Language of the words. Default es.",
      "enum": [
        "es",
        "en",
        "pt",
        "fr",
        "de",
        "it"
      ],
      "type": "string"
    },
    "position": {
      "description": "horizontal = left to right only, vertical = top to bottom only, mixed = all 8 directions including diagonals.",
      "enum": [
        "horizontal",
        "vertical",
        "mixed"
      ],
      "type": "string"
    },
    "rows": {
      "description": "Grid height.",
      "maximum": 30,
      "minimum": 6,
      "type": "integer"
    },
    "seed": {
      "description": "Repeatable puzzles: same input and seed, same grid.",
      "minimum": 0,
      "type": "integer"
    },
    "words": {
      "description": "Words to hide, in their normal spelling (accents kept).",
      "items": {
        "maxLength": 30,
        "minLength": 1,
        "type": "string"
      },
      "maxItems": 60,
      "minItems": 1,
      "type": "array"
    }
  },
  "required": [
    "words",
    "rows",
    "cols"
  ],
  "additionalProperties": false
}

Completes a word search: takes the grid from generate_word_search (empty cells are "-") and fills them with random letters in the chosen language, with accents on or off. Letters follow how common they are in that language. Pass the puzzle's words so the filler never creates an extra copy of one.

{
  "type": "object",
  "properties": {
    "accents": {
      "description": "true (default): use the language's accented/native letters (Ñ, Ç, Ã, Ä, ẞ…). false: plain A-Z only.",
      "type": "boolean"
    },
    "empty": {
      "description": "What marks an empty cell. Default \"-\".",
      "maxLength": 4,
      "type": "string"
    },
    "grid": {
      "description": "The grid from generate_word_search: rows of one-letter strings, \"-\" for empty cells.",
      "items": {
        "items": {
          "maxLength": 4,
          "minLength": 1,
          "type": "string"
        },
        "maxItems": 30,
        "minItems": 1,
        "type": "array"
      },
      "maxItems": 30,
      "minItems": 1,
      "type": "array"
    },
    "lang": {
      "description": "Language of the letters. Default es.",
      "enum": [
        "es",
        "en",
        "pt",
        "fr",
        "de",
        "it"
      ],
      "type": "string"
    },
    "seed": {
      "description": "Repeatable filler. Omit for a different filler every time.",
      "minimum": 0,
      "type": "integer"
    },
    "words": {
      "description": "The hidden words, so the filler cannot create an extra copy of one.",
      "items": {
        "maxLength": 30,
        "minLength": 1,
        "type": "string"
      },
      "maxItems": 60,
      "type": "array"
    }
  },
  "required": [
    "grid"
  ],
  "additionalProperties": false
}

Languages Lettras supports, with the native letters each one adds to its grid alphabet.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}