add Readme for space-header

.vscode/settings.json

@@ -13,5 +13,6 @@
  "editor.defaultFormatter": "esbenp.prettier-vscode"
  },
  "cSpell.words": ["huggingface"],
- "deno.enablePaths": ["./e2e/deno"]
+ "deno.enablePaths": ["./e2e/deno"],
+ "typescript.tsdk": "node_modules/typescript/lib"
 }

CODEOWNERS

@@ -21,3 +21,6 @@
 # Ownership for the gguf Package
 
 /packages/gguf @mishig25 @julien-c
+
+# Ownership for the space-header Package
+/packages/space-header @enzostvs

README.md

@@ -54,6 +54,7 @@ This is a collection of JS libraries to interact with the Hugging Face API, with
 - [@huggingface/agents](packages/agents/README.md): Interact with HF models through a natural language interface
 - [@huggingface/gguf](packages/gguf/README.md): A GGUF parser that works on remotely hosted files.
 - [@huggingface/tasks](packages/tasks/README.md): The definition files and source-of-truth for the Hub's main primitives like pipeline tasks, model libraries, etc.
+- [@huggingface/space-header](packages/space-header/README.md): Use the Space `mini_header` outside Hugging Face
 
 
 We use modern features to avoid polyfills and dependencies, so the libraries will only work on modern browsers / Node.js >= 18 / Bun / Deno.

docs/_toctree.yml

@@ -21,3 +21,13 @@
  title: Use Agents to run multi-modal workflows from a natural language API
  - local: agents/modules
  title: API Reference
+- title: "@huggingface/space-header"
+ isExpanded: true
+ sections:
+ - local: space-header/README
+ title: Use Space mini_header in your app
+- title: "@huggingface/gguf"
+ isExpanded: true
+ sections:
+ - local: gguf/README
+ title: Parse local and remote GGUF files

packages/doc-internal/package.json

@@ -5,14 +5,16 @@
  "description": "Package to generate doc for other @huggingface packages",
  "private": true,
  "scripts": {
- "start": "pnpm run fix-cdn-versions && pnpm run doc-hub && pnpm run doc-inference && pnpm run doc-agents && cp ../../README.md ../../docs/index.md && pnpm run update-toc && pnpm run fix-md-links && pnpm run fix-md-headinghashlinks",
+ "start": "pnpm run fix-cdn-versions && pnpm run doc-hub && pnpm run doc-inference && pnpm run doc-agents && pnpm run doc-space-header && pnpm run doc-gguf && cp ../../README.md ../../docs/index.md && pnpm run update-toc && pnpm run fix-md-links && pnpm run fix-md-headinghashlinks",
  "lint": "eslint --quiet --fix --ext .cjs,.ts .",
  "lint:check": "eslint --ext .cjs,.ts .",
  "format": "prettier --write .",
  "format:check": "prettier --check .",
  "doc-hub": "typedoc --tsconfig ../hub/tsconfig.json --githubPages false --plugin typedoc-plugin-markdown --out ../../docs/hub --hideBreadcrumbs --hideInPageTOC --sourceLinkTemplate https://github.com/huggingface/huggingface.js/blob/main/{path}#L{line} ../hub/index.ts",
  "doc-inference": "typedoc --tsconfig ../inference/tsconfig.json --githubPages false --plugin typedoc-plugin-markdown --out ../../docs/inference --hideBreadcrumbs --hideInPageTOC --sourceLinkTemplate https://github.com/huggingface/huggingface.js/blob/main/{path}#L{line} ../inference/src/index.ts",
  "doc-agents": "typedoc --tsconfig ../agents/tsconfig.json --githubPages false --plugin typedoc-plugin-markdown --out ../../docs/agents --hideBreadcrumbs --hideInPageTOC --sourceLinkTemplate https://github.com/huggingface/huggingface.js/blob/main/{path}#L{line} ../agents/src/index.ts",
+ "doc-gguf": "mkdir -p ../../docs/gguf && cp ../../packages/gguf/README.md ../../docs/gguf/README.md",
+ "doc-space-header": "mkdir -p ../../docs/space-header && cp ../../packages/space-header/README.md ../../docs/space-header/README.md",
  "update-toc": "tsx update-toc.ts",
  "fix-cdn-versions": "tsx fix-cdn-versions.ts",
  "fix-md-links": "tsx fix-md-links.ts",

packages/space-header/README.md

@@ -0,0 +1,59 @@
+# 🤗 Hugging Face Space Header
+
+A Typescript powered wrapper for the Space `mini_header` feature.
+
+## Install
+
+```console
+pnpm add @huggingface/space-header
+
+npm add @huggingface/space-header
+
+yarn add @huggingface/space-header
+```
+
+### Deno
+
+```ts
+// esm.sh
+import { init } from "https://esm.sh/@huggingface/space-header"
+// or npm:
+import { init } from "npm:@huggingface/space-header"
+```
+
+### Initialize
+```ts
+import { init } from "@huggingface/space-header";
+
+// ...
+
+init(":user/:spaceId");
+// init("enzostvs/lora-studio") for example
+```
+❗Important note: The `init` method must be called on the client side.
+
+## Usage
+
+Uses the `target` option to inject the space-header into another DOM element
+
+```ts
+const app = document.getElementById("app");
+
+// ...
+
+init(":user/:spaceId", {
+ target: app
+});
+```
+
+If you already have the space data, you can also pass it as a parameter to avoid a fetch
+
+```ts
+init(space);
+
+// space = {
+// id: string;
+// likes: number;
+// author: string;
+// }
+```

packages/space-header/package.json

@@ -1,6 +1,6 @@
 {
  "name": "@huggingface/space-header",
- "version": "1.0.0",
+ "version": "0.0.0",
  "description": "",
  "main": "index.js",
  "type": "module",
@@ -15,7 +15,7 @@
  "prepublishOnly": "pnpm run build"
  },
  "keywords": [],
- "author": "",
+ "author": "Hugging Face",
  "license": "ISC",
  "devDependencies": {
  "tsup": "^8.1.0",