package.json

{
  "Notes": [
    "The 'all' runs _all_ named scripts in sequence, even if one fails; and exits with failure in that case."
  ],
  "scripts": {
    "__check:format:nowrap": "npm run _check:format:any -- --prose-wrap preserve",
    "__check:format": "./scripts/npx-helper.sh prettier --ignore-unknown",
    "__check:links": "make --keep-going check-links",
    "__find:md:not-old-blog": "sh -c 'find \"$@\" -name \"*.md\" -not -path \"content/en/blog/2019/*\" -not -path \"content/en/blog/202[0-4]/*\" -print0' --",
    "_build": "npm run _hugo -- --logLevel info -e dev --buildDrafts --buildFuture --baseURL \"${DEPLOY_PRIME_URL:-http://localhost}\"",
    "_check:format:any": "npm run __check:format -- --check --ignore-path ''",
    "_check:format:nowrap": "npm run __check:format:nowrap -- content/ja content/uk content/zh",
    "_check:format": "npm run __check:format -- --check .",
    "_check:links--md": "npx markdown-link-check --config .markdown-link-check.json *.md",
    "_check:links--warn": "npm run _check:links || (echo; echo 'WARNING: see link-checker output for issues.'; echo)",
    "_check:links:htmltest": "HTMLTEST_ARGS='--log-level 1' npm run __check:links",
    "_check:links:lychee": "scripts/lychee/check/index.sh",
    "_check:links": "npm run \"_check:links:${LINK_CHECKER:-htmltest}\"",
    "_check:markdown": "npx gulp lint-md",
    "_check:registry": "npx gulp validate-registry",
    "_check:text": "npx textlint content data `ls *.md`",
    "_check:uv": "command -v uv >/dev/null || { echo '[help] The collector-sync scripts require uv. Install it: https://docs.astral.sh/uv/getting-started/installation/'; exit 1; }",
    "_code-excerpter-over-en": "code-excerpter content/en",
    "_commit:public": "HASH=$(git rev-parse --short main); cd public && git add -A && git commit -m \"Site at $HASH\"",
    "_diff:check": "git diff --name-only --exit-code",
    "_diff:fail": "git diff --name-only --exit-code || exit 1",
    "_fail": "exit 1",
    "_filename-error": "echo 'ERROR: the following files or directories violate repo conventions; fix using: `npm run fix:filenames`'; echo; npm run -s _ls-bad-filenames; exit 1",
    "_fix:dict": "npm run -s __find:md:not-old-blog -- content layouts projects | xargs -0 scripts/normalize-cspell-front-matter.pl",
    "_fix:format:diff": "npm run __check:format -- --write",
    "_fix:obsolete-files": "[ ! -e tools ] || (echo 'Removing obsolete path: tools/' && rm -rf tools)",
    "_fix:trailing-spaces": "npm run -s __find:md:not-old-blog -- content | xargs -0 perl -i -pe 's/[ \t]+$//g'",
    "_get:no": "echo SKIPPING get operation",
    "_get:submodule": "set -x && git submodule update --init ${DEPTH:- --depth 999}",
    "_htmltest": "LINK_CHECKER=htmltest npm run",
    "_hugo": "hugo --cleanDestinationDir",
    "_install:cspell": "npm install -D $(npm run -s _list:cspell)",
    "_install:netlify-cli": "npm list netlify-cli || npm install -O netlify-cli",
    "_list:check:*": "npm run --loglevel=warn | grep -Ee '^\\s*check:[^:]+$' | grep -Ev \"check:all|${CMD_SKIP:-noop}\"",
    "_list:check:for-test-and-fix": "npm -s run _list:check:* | grep -Ev \"collector-sync|i18n\"",
    "_list:cspell": "jq -r '.devDependencies | keys[] | select(. == \"cspell\" or startswith(\"@cspell/\"))' package.json | xargs",
    "_list:diff-never-empty": "echo README.md && npm run _list:diff --",
    "_list:diff:all": "(npm run -s _list:diff -- HEAD; git ls-files --others --exclude-standard) | sort -u",
    "_list:diff": "git diff --name-only --diff-filter=AMR",
    "_list:fix:*": "npm run --loglevel=warn | grep -Ee '^\\s*fix:[^:]+$' | grep -Ev \"fix:all|${CMD_SKIP:-noop}\"",
    "_list:fix:for-test-and-fix": "npm -s run _list:fix:* | grep -Ev \"collector-sync|i18n|refcache|submodule\"",
    "_list:test:compound-tests": "npm run --loglevel=warn | grep -Ee '^\\s*test:[^:]+-[^:]+$' | grep -Ev \"compound-tests|${CMD_SKIP:-noop}\"",
    "_ls-bad-filenames": "find assets content static -name '*_*' ! -name '[_.]*'; [ -e tools ] && echo tools; true",
    "_lychee:reseed-cache": "rm -f .lycheecache && npm run _lychee:seed-cache",
    "_lychee:seed-cache": "test -f .lycheecache || node scripts/lychee/refcache-to-lycheecache/index.mjs static/refcache.json .lycheecache",
    "_lychee:setup": "npm run seq -- generate:config:links:lychee _lychee:seed-cache",
    "_lychee": "LINK_CHECKER=lychee npm run",
    "_pin:submodule": "scripts/pin-submodules.pl",
    "_prebuild": "npm run seq -- get:submodule cp:spec generate:config-types",
    "_prepare:docsy": "cd themes/docsy && npm install",
    "_prettier:any": "npx prettier --ignore-path ''",
    "_refcache:prune": "npx gulp prune",
    "_rename-to-kebab-case": "find assets content static -name '*_*' ! -name '[_.]*' -exec sh -c 'mv \"$1\" \"${1//_/-}\"' _ {} \\;",
    "_serve:hugo": "hugo server --buildDrafts --minify",
    "_serve:netlify": "netlify dev -c \"npm run _serve:hugo -- --renderToMemory\"",
    "_test:all:live": "node tests/live-check.mjs",
    "_test:ef:live:asset-tracking": "node netlify/edge-functions/asset-tracking/live-check.mjs",
    "_test:ef:live:markdown-negotiation": "node netlify/edge-functions/markdown-negotiation/live-check.mjs",
    "_test:ef:live:registry-component-redirect": "node netlify/edge-functions/registry-component-redirect/live-check.mjs",
    "_test:ef:live:schema-analytics": "node netlify/edge-functions/schema-analytics/live-check.mjs",
    "_test:ef:live": "node netlify/edge-functions/bin/live-check.mjs",
    "_test:redirects:live": "node tests/redirects/live-check.mjs",
    "full:build": "BUILD_KIND=full npm run",
    "all": "bash -c 'x=0; for c in \"$@\"; do npm run $c || x=$((x+1)); done; ((!x)) || (echo \"ERROR: some scripts failed!\" && exit 1)' -",
    "build:full": "npm run _build --",
    "build:lean": "npm run -s lean -- _build",
    "build:preview": "set -x && npm run _build -- --minify",
    "build:production": "npm run _hugo -- --minify",
    "build": "npm run \"build:${BUILD_KIND:-lean}\" --",
    "cd:public": "cd public &&",
    "check:all": "npm run seq -- $(npm run -s _list:check:*)",
    "check:code-excerpts": "npm run _code-excerpter-over-en -- --dry-run --fail-on-update",
    "check:codeowners": "node scripts/gh/locale-codeowners/cli.mjs --check",
    "check:collector-sync:lint": "cd scripts/collector-sync && uv run --extra dev ruff check src/",
    "check:collector-sync:types": "cd scripts/collector-sync && uv run --extra dev mypy src/",
    "check:collector-sync": "cd scripts/collector-sync && uv run --extra dev pytest",
    "check:expired": "find content -name '*.md' | xargs ./scripts/list-expired.pl",
    "check:filenames": "test -z \"$(npm run -s _ls-bad-filenames)\" || npm run -s _filename-error",
    "check:format": "npm run _check:format && npm run _check:format:nowrap || (echo '[help] Run: npm run fix:format'; exit 1)",
    "check:i18n": "scripts/check-i18n.sh",
    "check:l10n:do-not-copy-images-etc": "node scripts/validate/l10n-do-not-copy-images-etc/index.mjs",
    "check:l10n": "npm run seq -- check:l10n:do-not-copy-images-etc",
    "check:links:diff": "node scripts/lychee/diff-check/index.mjs",
    "check:links:htmltest": "npm run _check:links:htmltest",
    "check:links:lychee": "npm run _check:links:lychee",
    "check:links": "npm run \"check:links:${LINK_CHECKER:-htmltest}\"",
    "check:markdown:specs": "npx markdownlint-cli2 'tmp/(otel|otlp|semconv)/**/*.md'",
    "check:markdown": "npx markdownlint-cli2 '*.md' '{content,projects}/**/*.md'",
    "check:registry": "npm run _check:registry -- ",
    "check:spelling": "npx cspell --no-progress -c .cspell.yml content data 'layouts/**/*.md' projects/**/*.md",
    "check:text": "npm run _check:text -- ",
    "check": "CMD_SKIP=collector-sync npm run check:all",
    "clean": "make clean",
    "code-excerpts": "node -e 'console.error(\"\\x1b[31mWARNING: THIS IS A DEPRECATED ALIAS, instead use: `fix:code-excerpts` or `check:code-excerpts`\\x1b[0m\")' && npm run fix:code-excerpts --",
    "cp:spec": "scripts/content-modules/cp-pages.sh",
    "diff:check": "npm run _diff:check || (echo; echo 'WARNING: the files above have not been committed'; echo)",
    "diff:fail": "npm run _diff:check || (echo; echo 'ERROR: the files above have changed. Locally rerun `npm run test-and-fix` and commit changes'; echo; exit 1)",
    "fix-and-test:all": "npm run full:build -- all fix:submodule $(CMD_SKIP='refcache|submodule' npm -s run _list:fix:*) fix:refcache $(CMD_SKIP='links|i18n' npm -s run _list:check:*)",
    "fix:all": "npm run all -- $(npm -s run _list:fix:*)",
    "fix:code-excerpts": "npm run _code-excerpter-over-en",
    "fix:codeowners": "node scripts/gh/locale-codeowners/cli.mjs",
    "fix:collector-sync:lint": "cd scripts/collector-sync && uv run --extra dev ruff check --fix src/",
    "fix:dict": "scripts/sort-cspell-words.pl .cspell/*.txt && npm run _fix:dict",
    "fix:expired": "npm run -s check:expired -- -q | xargs -r -I {} sh -c 'echo \"Deleting expired file: {}\" && rm {}'",
    "fix:filenames": "npm run _fix:obsolete-files && npm run _rename-to-kebab-case",
    "fix:format:diff": "npm run _fix:format:diff -- $(npm -s run _list:diff:all)",
    "fix:format:staged": "npx prettier --write --ignore-unknown $(npm -s run _list:diff-never-empty -- --cached)",
    "fix:format": "npm run format; npm run _fix:trailing-spaces",
    "fix:i18n:new": "scripts/check-i18n.sh -n -c HEAD",
    "fix:i18n:status": "scripts/check-i18n.sh -D",
    "fix:i18n": "npm run seq -- fix:i18n:new fix:i18n:status",
    "fix:l10n:do-not-copy-images-etc": "npm run check:l10n:do-not-copy-images-etc -- --fix",
    "fix:l10n": "npm run seq -- fix:l10n:do-not-copy-images-etc",
    "fix:markdown": "npm run check:markdown -- --fix && echo '\nTrimming trailing whitespace' && npm run _fix:trailing-spaces",
    "fix:refcache:refresh": "npm run _refcache:prune -- -n ${PRUNE_N:-128}",
    "fix:refcache": "npm run _refcache:prune; npm run check:links:htmltest",
    "fix:submodule": "npm run pin:submodule",
    "fix:text": "npm run check:text -- --fix",
    "fix": "CMD_SKIP=i18n npm run fix:all",
    "format": "npm run _check:format -- --write && npm run _check:format:nowrap -- --write",
    "generate:config-types": "node scripts/generate-config-types.mjs",
    "generate:config:links:lychee": "npm run generate:config:links && scripts/lychee/config/index.sh",
    "generate:config:links": "scripts/htmltest-config.sh",
    "get:submodule": "npm run _get:${GET:-submodule} --",
    "lean": "HUGOxPARAMSxTDxLEAN_RENDER=remove npm run",
    "locale-auto-merge": "node scripts/gh/locale-auto-merge/cli.mjs",
    "locale-team-cleanup": "node scripts/gh/locale-team-cleanup/cli.mjs",
    "log:build": "npm run build 2>&1 | tee tmp/build-log.txt",
    "log:check:links": "npm run check:links 2>&1 | tee tmp/check-links-log.txt",
    "lychee:reseed": "npm run _lychee:reseed-cache",
    "make:public": "make public ls-public",
    "metrics:build": "node scripts/metrics/build.mjs",
    "netlify-build:preview": "npm run seq -- build:preview diff:check",
    "netlify-build:production": "npm run seq -- build:production diff:check",
    "pin:submodule": "npm run _pin:submodule -- $PIN_SKIP",
    "post_hugo": "scripts/strip-hugo-ctx.sh public",
    "postfix:refcache:refresh": "npm run fix:refcache",
    "postfix:submodule": "git submodule",
    "postget:submodule": "git submodule && echo && scripts/update-semconv-mounts.pl",
    "pre__check:links": "npm run generate:config:links",
    "pre_build": "echo \"BUILD_KIND=$BUILD_KIND\nHUGOxPARAMSxTDxLEAN_RENDER=$HUGOxPARAMSxTDxLEAN_RENDER\"",
    "pre_check:links:lychee": "npm run _lychee:setup",
    "prebuild:full": "npm run _prebuild",
    "prebuild:lean": "npm run _prebuild",
    "prebuild:preview": "npm run _prebuild",
    "prebuild:production": "npm run _prebuild",
    "precheck:collector-sync:lint": "npm run -s _check:uv",
    "precheck:collector-sync:types": "npm run -s _check:uv",
    "precheck:collector-sync": "npm run -s _check:uv",
    "precheck:links:diff": "npm run _lychee:setup",
    "precheck:links:htmltest": "npm run \"build:${BUILD_KIND:-lean}\"",
    "precheck:links:lychee": "npm run \"build:${BUILD_KIND:-lean}\"",
    "precheck:markdown:specs": "mkdir -p tmp && cp .markdownlint-for-specs.yml tmp/.markdownlint.yml",
    "prefix:collector-sync:lint": "npm run -s _check:uv",
    "prefix:submodule": "npm run update:submodule",
    "prepare": "npm run seq -- get:submodule _prepare:docsy",
    "preserve:hugo": "npm run _prebuild",
    "preserve:netlify": "npm run seq -- _prebuild _install:netlify-cli",
    "schemas:update": "npm run update:submodule -- content-modules/opentelemetry-specification",
    "seq": "bash -c 'for cmd in \"$@\"; do npm run $cmd || exit 1; done' - ",
    "serve:hugo": "npm run _serve:hugo -- --renderToMemory",
    "serve:netlify": "npm run _serve:netlify",
    "serve": "npm run serve:hugo --",
    "test-and-fix": "npm run seq -- fix:submodule $(npm -s run _list:fix:for-test-and-fix) $(npm -s run _list:check:for-test-and-fix)",
    "test:all:live": "npm run _test:all:live --",
    "test:all": "npm run test:base && npm run test:compound-tests",
    "test:base": "npm run check",
    "test:collector-sync": "npm run check:collector-sync && npm run check:collector-sync:types && npm run check:collector-sync:lint",
    "test:compound-tests": "npm run seq -- check:code-excerpts $(CMD_SKIP=collector-sync npm -s run _list:test:compound-tests)",
    "test:config-schema-tests": "node --test \"assets/js/**/*.test.mjs\"",
    "test:edge-functions:live": "npm run _test:ef:live --",
    "test:edge-functions": "node --test \"netlify/edge-functions/**/*.test.ts\"",
    "test:local-tools:lychee": "echo 'Running the lychee slice of local-tools tests (needs the lychee binary)' && node --test \"scripts/lychee/sanity/**/*.test.mjs\"",
    "test:local-tools": "node --test \"scripts/**/*.test.mjs\"",
    "test:public": "node --test \"tests/public/**/*.test.mjs\"",
    "test:redirects:live": "npm run _test:redirects:live --",
    "test": "CMD_SKIP=collector-sync npm run test:base",
    "update:hugo": "npm install --save-dev --save-exact hugo-extended@latest",
    "update:packages:no-hugo": "npm run update:packages -- -x hugo-extended",
    "update:packages": "npx npm-check-updates --dep 'prod,dev,optional,peer' -u",
    "update:submodule": "set -x && git submodule update --remote ${DEPTH:- --depth 999} && git submodule foreach 'git fetch $(git remote | tail -1) --tags'",
    "zzz": "echo 'bogus script used to help keep the script collection sorted'"
  },
  "devDependencies": {
    "@cspell/dict-bn": "1.0.4",
    "@cspell/dict-es-es": "3.0.8",
    "@cspell/dict-fr-fr": "2.3.2",
    "@cspell/dict-pl_pl": "3.0.6",
    "@cspell/dict-pt-br": "2.4.2",
    "@cspell/dict-ro-ro": "2.0.6",
    "@cspell/dict-uk-ua": "4.0.6",
    "ajv": "8.20.0",
    "ajv-errors": "3.0.0",
    "ajv-formats": "3.0.1",
    "autoprefixer": "10.5.0",
    "code-excerpter": "0.2.0",
    "cspell": "10.0.1",
    "gulp": "5.0.1",
    "hugo-extended": "0.163.2",
    "js-yaml": "4.2.0",
    "markdown-it": "14.2.0",
    "markdown-link-check": "3.14.2",
    "markdownlint": "0.41.0",
    "markdownlint-cli2": "0.22.1",
    "markdownlint-rule-helpers": "0.31.0",
    "markdownlint-rule-link-pattern": "github:chalin/markdownlint-rule-link-pattern#semver:0.2.0",
    "markdownlint-rule-no-shortcut-ref-link": "github:chalin/markdownlint-rule-no-shortcut-ref-link#v0.3.1",
    "postcss-cli": "11.0.1",
    "prettier": "3.8.4",
    "puppeteer": "25.1.0",
    "puppeteer-core": "25.1.0",
    "require-dir": "1.2.0",
    "textlint": "15.7.1",
    "textlint-filter-rule-allowlist": "4.0.0",
    "textlint-filter-rule-comments": "1.3.0",
    "textlint-rule-prh": "6.1.0",
    "textlint-rule-terminology": "5.2.16",
    "yargs": "18.0.0"
  },
  "dependencies": {
    "@opentelemetry/api": "^1.9.1",
    "@opentelemetry/auto-instrumentations-web": "^0.64.0",
    "@opentelemetry/context-zone": "^2.7.0",
    "@opentelemetry/core": "^2.7.0",
    "@opentelemetry/exporter-trace-otlp-http": "^0.219.0",
    "@opentelemetry/instrumentation": "^0.219.0",
    "@opentelemetry/resources": "^2.7.0",
    "@opentelemetry/sdk-trace-base": "^2.7.0",
    "@opentelemetry/sdk-trace-web": "^2.7.0",
    "@opentelemetry/semantic-conventions": "^1.40.0",
    "minisearch": "^7.2.0",
    "path": "^0.12.7"
  },
  "optionalDependencies": {
    "netlify-cli": "^26.0.0",
    "npm-check-updates": "^22.0.1"
  },
  "enginesComment": "Ensure that engines.node value stays consistent with the project's .nvmrc",
  "engines": {
    "node": ">=24"
  },
  "gitHubActionCacheKey": "2023-07-13 - change this key to force cache refresh",
  "private": true,
  "prettier": {
    "proseWrap": "always",
    "singleQuote": true
  },
  "spelling": "cSpell:ignore elemetry lycheecache loglevel minisearch mypy nowrap precheck pytest startswith -"
}