@tscircuit/fake-snippets 0.0.1

package/dist/robots.txt

@@ -0,0 +1,9 @@
+# Allow all crawlers
+User-agent: *
+Allow: /
+
+# Sitemaps
+Sitemap: https://tscircuit.com/sitemap.xml
+
+# Crawl-delay
+Crawl-delay: 10

package/dist/sitemap.xml

@@ -0,0 +1,118 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+  <url>
+    <loc>https://tscircuit.com/</loc>
+    <changefreq>weekly</changefreq>
+    <priority>1.0</priority>
+  </url>
+  <url>
+    <loc>https://tscircuit.com/editor</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.9</priority>
+  </url>
+  <url>
+    <loc>https://tscircuit.com/playground</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.9</priority>
+  </url>
+  <url>
+    <loc>https://tscircuit.com/quickstart</loc>
+    <changefreq>monthly</changefreq>
+    <priority>0.8</priority>
+  </url>
+  <url>
+    <loc>https://tscircuit.com/dashboard</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://tscircuit.com/newest</loc>
+    <changefreq>daily</changefreq>
+    <priority>0.8</priority>
+  </url>
+  <url>
+    <loc>https://tscircuit.com/search</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://tscircuit.com/settings</loc>
+    <changefreq>monthly</changefreq>
+    <priority>0.6</priority>
+  </url>
+  <url>
+    <loc>https://tscircuit.com/community/join-redirect</loc>
+    <changefreq>monthly</changefreq>
+    <priority>0.6</priority>
+  </url>
+  <url>
+    <loc>https://tscircuit.com/legal/terms-of-service</loc>
+    <changefreq>yearly</changefreq>
+    <priority>0.3</priority>
+  </url>
+  <url>
+    <loc>https://tscircuit.com/legal/privacy-policy</loc>
+    <changefreq>yearly</changefreq>
+    <priority>0.3</priority>
+  </url>
+  <url>
+    <loc>https://tscircuit.com/techmannih/regulator-SPX1117M3L50TR</loc>
+    <lastmod>2025-01-07T02:12:09.440Z</lastmod>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://tscircuit.com/seveibar/HS91L02W2C01</loc>
+    <lastmod>2025-01-06T01:41:28.137Z</lastmod>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://tscircuit.com/AnasSarkiz/grid-of-LEDs-with-an-ESP32</loc>
+    <lastmod>2025-01-15T12:29:08.815Z</lastmod>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://tscircuit.com/techmannih/blinking-led-circuit</loc>
+    <lastmod>2025-01-05T02:51:31.724Z</lastmod>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://tscircuit.com/imrishabh18/testing-123456</loc>
+    <lastmod>2024-12-03T11:47:21.770Z</lastmod>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://tscircuit.com/Abse2001/OR-Gate-Chip</loc>
+    <lastmod>2024-12-01T19:50:12.221Z</lastmod>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://tscircuit.com/anas-sarkez/Arduino_Nano</loc>
+    <lastmod>2024-11-23T21:51:52.436Z</lastmod>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://tscircuit.com/seveibar/smd-usb-c</loc>
+    <lastmod>2024-11-14T21:18:02.296Z</lastmod>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://tscircuit.com/seveibar/a555timer</loc>
+    <lastmod>2024-10-14T17:46:25.789Z</lastmod>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://tscircuit.com/seveibar/Key</loc>
+    <lastmod>2025-01-02T19:16:31.127Z</lastmod>
+    <changefreq>weekly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  </urlset>

package/docs/CIRCUIT_JSON_SOURCE_COMPONENT_OVERVIEW.md

@@ -0,0 +1,151 @@
+# Circuit JSON Specification: Source Component Overview
+
+> Created at 2024-11-12T19:07:05.930Z
+> Latest Version: https://github.com/tscircuit/circuit-json/blob/main/docs/SOURCE_COMPONENT_OVERVIEW.md
+
+Any type below can be imported from `circuit-json`. Every type has a corresponding
+snake_case version which is a zod type that can be used to parse unknown json,
+for example `SourceComponent` has a `source_component.parse` function that you
+can also import.
+
+```ts
+interface SourceSimpleChip {
+  type: "source_component"
+  ftype: "simple_chip"
+  source_component_id: string
+  name: string
+  manufacturer_part_number?: string
+  supplier_part_numbers?: Partial<Record<string, string[]>>
+  display_value?: string
+}
+
+interface SourceSimpleInductor {
+  type: "source_component"
+  ftype: "simple_inductor"
+  source_component_id: string
+  name: string
+  manufacturer_part_number?: string
+  supplier_part_numbers?: Partial<Record<string, string[]>>
+  display_value?: string
+  inductance: number
+}
+
+interface SourceLed {
+  type: "source_component"
+  ftype: "led"
+  source_component_id: string
+  name: string
+  manufacturer_part_number?: string
+  supplier_part_numbers?: Partial<Record<string, string[]>>
+  display_value?: string
+}
+
+interface SourceTrace {
+  type: "source_trace"
+  source_trace_id: string
+  connected_source_port_ids: string[]
+  connected_source_net_ids: string[]
+  subcircuit_connectivity_map_key?: string
+}
+
+interface SourceSimpleGround {
+  type: "source_component"
+  ftype: "simple_ground"
+  source_component_id: string
+  name: string
+  manufacturer_part_number?: string
+  supplier_part_numbers?: Partial<Record<string, string[]>>
+  display_value?: string
+}
+
+interface SourceSimpleResistor {
+  type: "source_component"
+  ftype: "simple_resistor"
+  source_component_id: string
+  name: string
+  manufacturer_part_number?: string
+  supplier_part_numbers?: Partial<Record<string, string[]>>
+  display_value?: string
+  resistance: number
+}
+
+interface SourceSimpleBattery {
+  type: "source_component"
+  ftype: "simple_battery"
+  source_component_id: string
+  name: string
+  manufacturer_part_number?: string
+  supplier_part_numbers?: Partial<Record<string, string[]>>
+  display_value?: string
+  capacity: number
+}
+
+interface SourceNet {
+  type: "source_net"
+  source_net_id: string
+  name: string
+  member_source_group_ids: string[]
+  is_power?: boolean
+  is_ground?: boolean
+  is_digital_signal?: boolean
+  is_analog_signal?: boolean
+  trace_width?: number
+}
+
+interface SourceSimpleDiode {
+  type: "source_component"
+  ftype: "simple_diode"
+  source_component_id: string
+  name: string
+  manufacturer_part_number?: string
+  supplier_part_numbers?: Partial<Record<string, string[]>>
+  display_value?: string
+}
+
+interface SourceGroup {
+  type: "source_group"
+  source_group_id: string
+  name?: string
+}
+
+interface SourcePort {
+  type: "source_port"
+  pin_number?: number
+  port_hints?: string[]
+  name: string
+  source_port_id: string
+  source_component_id: string
+}
+
+interface SourceSimplePowerSource {
+  type: "source_component"
+  ftype: "simple_power_source"
+  source_component_id: string
+  name: string
+  manufacturer_part_number?: string
+  supplier_part_numbers?: Partial<Record<string, string[]>>
+  display_value?: string
+  voltage: number
+}
+
+interface SourceSimpleCapacitor {
+  type: "source_component"
+  ftype: "simple_capacitor"
+  source_component_id: string
+  name: string
+  manufacturer_part_number?: string
+  supplier_part_numbers?: Partial<Record<string, string[]>>
+  display_value?: string
+  capacitance: number
+}
+
+interface SourceComponentBase {
+  type: "source_component"
+  ftype?: string
+  source_component_id: string
+  name: string
+  manufacturer_part_number?: string
+  supplier_part_numbers?: Partial<Record<string, string[]>>
+  display_value?: string
+}
+```

package/fake-snippets-api/README.md

@@ -0,0 +1,6 @@
+# Template API Project
+
+This is a template project with best-practice modules:
+- Winterspec for defining the API
+- bun testing
+- Zustand store with zod definition for database state

package/fake-snippets-api/biome.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://biomejs.dev/schemas/1.7.3/schema.json",
+  "organizeImports": {
+    "enabled": true
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space"
+  },
+  "files": {
+    "ignore": ["cosmos-export", "dist", "package.json"]
+  },
+  "javascript": {
+    "formatter": {
+      "jsxQuoteStyle": "double",
+      "quoteProperties": "asNeeded",
+      "trailingCommas": "all",
+      "semicolons": "asNeeded",
+      "arrowParentheses": "always",
+      "bracketSpacing": true,
+      "bracketSameLine": false
+    }
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "suspicious": {
+        "noExplicitAny": "off"
+      },
+      "complexity": {
+        "noBannedTypes": "off"
+      },
+      "style": {
+        "noNonNullAssertion": "off",
+        "useFilenamingConvention": {
+          "level": "error",
+          "options": {
+            "strictCase": true,
+            "requireAscii": true,
+            "filenameCases": ["kebab-case", "export"]
+          }
+        }
+      }
+    }
+  }
+}

package/fake-snippets-api/lib/db/autoload-dev-snippets.ts

@@ -0,0 +1,84 @@
+import axios from "redaxios"
+import fs from "fs"
+import path from "path"
+import { DbClient } from "./db-client"
+
+const extractTsciDependencies = (
+  code: string,
+): Array<{ owner: string; name: string }> => {
+  const regex = /@tsci\/([^.]+)\.([^"'\s]+)/g
+  const matches = Array.from(code.matchAll(regex))
+  return matches.map((match) => ({
+    owner: match[1],
+    name: match[2],
+  }))
+}
+
+const registryApi = axios.create({
+  baseURL: "https://registry-api.tscircuit.com",
+  headers: {
+    Accept: "application/json",
+    "Content-Type": "application/json",
+  },
+})
+
+const fetchSnippetFromRegistry = async (owner: string, name: string) => {
+  const response = await registryApi.get(
+    `/snippets/get?owner_name=${owner}&unscoped_name=${name}`,
+  )
+  return response.data.snippet
+}
+
+const loadSnippetWithDependencies = async (
+  db: DbClient,
+  owner: string,
+  name: string,
+  loadedSnippets = new Set<string>(),
+) => {
+  const snippetKey = `${owner}/${name}`
+  if (loadedSnippets.has(snippetKey)) {
+    return
+  }
+
+  try {
+    const snippet = await fetchSnippetFromRegistry(owner, name)
+
+    if (db.getSnippetByAuthorAndName(owner, name)) return
+
+    db.addSnippet(snippet)
+    loadedSnippets.add(snippetKey)
+
+    const dependencies = extractTsciDependencies(snippet.code)
+    for (const dep of dependencies) {
+      loadSnippetWithDependencies(db, dep.owner, dep.name, loadedSnippets)
+    }
+  } catch (e) {
+    console.error(`✗ Failed to load ${snippetKey}:`, e)
+  }
+}
+
+export const loadAutoloadSnippets = async (db: DbClient) => {
+  try {
+    const autoloadPath = path.join(
+      path.dirname(__dirname),
+      "db",
+      "autoload-snippets.json",
+    )
+    if (fs.existsSync(autoloadPath)) {
+      const autoloadContent = JSON.parse(fs.readFileSync(autoloadPath, "utf8"))
+      console.log("Loading development snippets from registry...")
+
+      const loadedSnippets = new Set<string>()
+      for (const snippetRef of autoloadContent.snippets) {
+        loadSnippetWithDependencies(
+          db,
+          snippetRef.owner,
+          snippetRef.name,
+          loadedSnippets,
+        )
+      }
+    }
+  } catch (e) {
+    console.error("Failed to load autoload-snippets.json:", e)
+  }
+}

package/fake-snippets-api/lib/db/autoload-snippets.json

@@ -0,0 +1,24 @@
+{
+  "snippets": [
+    {
+      "owner": "Abse2001",
+      "name": "Arduino-Nano-Servo-Breakout"
+    },
+    {
+      "owner": "ShiboSoftwareDev",
+      "name": "Wifi-Camera-Module"
+    },
+    {
+      "owner": "imrishabh18",
+      "name": "Arduino-nano"
+    },
+    {
+      "owner": "seveibar",
+      "name": "usb-c-flashlight"
+    },
+    {
+      "owner": "AnasSarkiz",
+      "name": "grid-of-LEDs-with-an-ESP32"
+    }
+  ]
+}