projects.ahmadjalil.com

{
  "name": "get_lockup_state",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read what is currently on screen. There are two identities: the historical era builds crest lockups from parts and reports wording, colours, alignment and size; the current era serves the Province’s official ministry marks and reports which one. Call this before changing anything.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/PofBC/"
}

{
  "name": "set_lockup",
  "kind": "act",
  "impl": "imperative",
  "description": "Change what is shown. Every field is optional — pass only what should change. In the historical era the ministry may be any text, listed or not, and a newline in it forces a line break. In the current era the wording is fixed artwork: choose a ministry by its code (see list_current_marks), a language, and one of the four official colourways.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "era": {
        "type": "string",
        "enum": [
          "historical",
          "flag",
          "crest",
          "current"
        ],
        "description": "historical: the older crest lockups built from parts. flag: BC beside the waving provincial flag. crest: the coat of arms with the BRITISH COLUMBIA wordmark. current: the Province’s mark with the ministry wording set beside it."
      },
      "ministryCode": {
        "type": "string",
        "description": "Current era. A ministry abbreviation such as FOR or ENV."
      },
      "arrangement": {
        "type": "string",
        "enum": [
          "horizontal",
          "vertical",
          "vertical-arms"
        ],
        "description": "Crest era. horizontal: the arms then the wordmark beside them. vertical: the arms above it, both centred."
      },
      "ministryPlacement": {
        "type": "string",
        "enum": [
          "beside",
          "below"
        ],
        "description": "Crest era. Whether the ministry sits beside the lockup or below it."
      },
      "symbol": {
        "type": "string",
        "enum": [
          "horizontal",
          "vertical",
          "flag",
          "badge"
        ],
        "description": "Flag era. horizontal: BC then the flag. vertical: the flag above BC. flag: the flag alone. The first two are what the standards page sanctions."
      },
      "namePlacement": {
        "type": "string",
        "enum": [
          "below",
          "beside"
        ],
        "description": "Flag era. Whether the wording sits below the symbol or beside it."
      },
      "provinceLine": {
        "type": "boolean",
        "description": "Flag era. Sets \"Province of British Columbia\" in bold above the ministry."
      },
      "thirdLine": {
        "type": "string",
        "description": "Flag era. A line after the ministry — a minister, a place, a bulletin number."
      },
      "flagPalette": {
        "type": "string",
        "enum": [
          "official",
          "modern",
          "ink"
        ],
        "description": "Flag era. Whether the flag keeps its own navy, red and gold, or is set in one ink with the letters."
      },
      "wording": {
        "type": "string",
        "description": "The wording of a current-era mark, overriding the ministry’s official text. A newline is a line break, as in the published artwork. Use this for a ministry that has been renamed or never had a mark published."
      },
      "language": {
        "type": "string",
        "enum": [
          "en",
          "fr"
        ],
        "description": "Current era. The official marks exist in English and French."
      },
      "variant": {
        "type": "string",
        "enum": [
          "colour",
          "reverse",
          "black",
          "white"
        ],
        "description": "Current era. colour: The mark as drawn. For white and very light backgrounds. reverse: For BC Blue and black. The mountains lighten and the type goes white. black: One colour. For BC Gold, the 60% tints, and white. white: One colour. For BC Blue and black."
      },
      "lockup": {
        "type": "string",
        "enum": [
          "stacked",
          "centred",
          "horizontal",
          "columns"
        ],
        "description": "stacked: Mark above a left-aligned text column. The tallest of the four. centred: Mark centred above centred text, without the province wordmark. horizontal: Mark to the left of the text, on one line each. For narrow headers and letterheads. columns: Mark, then the wordmark, then the ministry — three columns in a row. The widest of the four."
      },
      "ministry": {
        "type": "string",
        "maxLength": 200,
        "description": "The ministry, agency or office."
      },
      "secondLine": {
        "type": "string",
        "maxLength": 200,
        "description": "An optional line beneath it, such as a programme."
      },
      "showWordmark": {
        "type": "boolean",
        "description": "Whether to show \"Province of British Columbia\"."
      },
      "markAlignment": {
        "type": "string",
        "enum": [
          "top",
          "centre",
          "bottom"
        ],
        "description": "Where the mark sits against the type. Only used by the horizontal and side-by-side lockups."
      },
      "clearSpace": {
        "type": "string",
        "enum": [
          "none",
          "snug",
          "standard",
          "generous"
        ],
        "description": "Margin around the lockup. The background colour fills it."
      }
    }
  },
  "page": "/PofBC/"
}

{
  "name": "set_colours",
  "kind": "act",
  "impl": "imperative",
  "description": "Set the mark, the type and the background independently. Pass only what should change. Use \"transparent\" for a background with no colour at all. The reply reports the resulting contrast, which is worth checking before exporting.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "markColor": {
        "type": "string",
        "description": "The mark. A palette name (white, black, green, blue, red, gold, silver, grey), a hex value such as #006837, or any CSS colour notation."
      },
      "textColor": {
        "type": "string",
        "description": "The type. A palette name (white, black, green, blue, red, gold, silver, grey), a hex value such as #006837, or any CSS colour notation."
      },
      "background": {
        "type": "string",
        "description": "The background. A palette name (white, black, green, blue, red, gold, silver, grey), a hex value such as #006837, or any CSS colour notation. Or \"transparent\"."
      }
    }
  },
  "page": "/PofBC/"
}

{
  "name": "export_lockup",
  "kind": "act",
  "impl": "imperative",
  "description": "Download the lockup as it currently stands. This saves a file to the browser’s downloads; set the lockup up first and check the state if unsure. Vector formats may keep their text live with the font embedded, or convert it to outlines, which is what a printer usually wants.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "format": {
        "type": "string",
        "enum": [
          "svg",
          "pdf",
          "png",
          "webp",
          "jpeg"
        ],
        "description": "svg: vector, pdf: vector, png: raster, webp: raster, jpeg: raster"
      },
      "pixelWidth": {
        "type": "integer",
        "enum": [
          512,
          1024,
          2048,
          4096
        ],
        "description": "Raster formats only. Ignored for SVG and PDF."
      },
      "outlineText": {
        "type": "boolean",
        "description": "Vector formats only. Converts the type to paths so the file needs no font."
      }
    },
    "required": [
      "format"
    ]
  },
  "page": "/PofBC/"
}

{
  "name": "get_share_link",
  "kind": "answer",
  "impl": "imperative",
  "description": "A URL that reproduces the current lockup exactly. The whole configuration travels in the link, so nothing is stored anywhere and it can be handed to someone else or reopened later.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/PofBC/"
}

{
  "name": "list_current_marks",
  "kind": "answer",
  "impl": "imperative",
  "description": "The Province’s ministries and the official wording of their marks, in English and French, with the code to pass to set_lockup. Newlines in the wording are the line breaks the published artwork uses. A ministry not listed has no published mark, but set_lockup takes any wording, so one can still be set.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/PofBC/"
}

{
  "name": "find_ministry",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search the 27 listed ministries and agencies. The search ignores case and punctuation, so \"citizens services\" finds \"Ministry of Citizens’ Services\". The list is a convenience only — in the historical era set_lockup accepts any name, listed or not. For the current era use list_current_marks instead; its marks are fixed artwork.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Part of a name. Omit to list everything."
      }
    }
  },
  "page": "/PofBC/"
}