@chrismo/superkit 1.0.0

package/dist/lib/help.js

@@ -0,0 +1,163 @@
+import { readFileSync, readdirSync } from 'fs';
+import { join, basename } from 'path';
+import { getDocsDir } from './docs.js';
+import { getExpertDoc, buildOverview } from './expert-sections.js';
+/**
+ * List available tutorial names from docs/tutorials/
+ */
+function listTutorials() {
+    const tutorialsDir = join(getDocsDir(), 'tutorials');
+    try {
+        return readdirSync(tutorialsDir)
+            .filter(f => f.endsWith('.md') && f !== 'index.md')
+            .map(f => basename(f, '.md'))
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+const SITE_BASE = 'https://chrismo.github.io/superkit/docs';
+const webUrls = {
+    'expert': `${SITE_BASE}/superdb-expert`,
+    'upgrade': `${SITE_BASE}/zq-to-super-upgrades`,
+    'upgrade-guide': `${SITE_BASE}/zq-to-super-upgrades`,
+    'migration': `${SITE_BASE}/zq-to-super-upgrades`,
+    'tutorials': `${SITE_BASE}/tutorials`,
+};
+/**
+ * Get help documentation by topic.
+ *
+ * Topics: expert, expert:all, expert:<slug>, upgrade, upgrade-guide, migration,
+ * tutorials, tutorial:<name>
+ */
+export function superHelp(topic) {
+    const docsDir = getDocsDir();
+    const topics = {
+        'upgrade': 'zq-to-super-upgrades.md',
+        'upgrade-guide': 'zq-to-super-upgrades.md',
+        'migration': 'zq-to-super-upgrades.md',
+    };
+    const normalized = topic.toLowerCase();
+    // Handle expert doc topics: expert, expert:all, expert:<slug>
+    if (normalized === 'expert' || normalized.startsWith('expert:')) {
+        try {
+            const doc = getExpertDoc();
+            const webUrl = webUrls['expert'];
+            const suffix = normalized === 'expert' ? null : normalized.slice('expert:'.length);
+            if (suffix === 'all') {
+                const filepath = join(docsDir, 'superdb-expert.md');
+                const content = readFileSync(filepath, 'utf-8');
+                return { success: true, topic, content, web_url: webUrl, error: null };
+            }
+            if (suffix) {
+                const section = doc.sections.find(s => s.slug === suffix);
+                if (!section) {
+                    const available = doc.sections.map(s => `expert:${s.slug}`).join(', ');
+                    return {
+                        success: false,
+                        topic,
+                        content: '',
+                        error: `Unknown expert section: ${suffix}. Available sections: ${available}`,
+                    };
+                }
+                return { success: true, topic, content: section.content, web_url: webUrl, error: null };
+            }
+            const content = buildOverview(doc);
+            const sections = doc.sections.map(s => ({ slug: s.slug, title: s.title, lines: s.lines }));
+            return { success: true, topic, content, sections, web_url: webUrl, error: null };
+        }
+        catch (e) {
+            return {
+                success: false,
+                topic,
+                content: '',
+                error: `Failed to read expert documentation: ${e instanceof Error ? e.message : String(e)}`,
+            };
+        }
+    }
+    // Handle "tutorials" topic — list available tutorials
+    if (normalized === 'tutorials') {
+        const tutorials = listTutorials();
+        const listing = tutorials.length > 0
+            ? tutorials.map(t => `- tutorial:${t}`).join('\n')
+            : 'No tutorials found.';
+        return {
+            success: true,
+            topic,
+            content: `# Available Tutorials\n\nUse \`super_help\` with topic \`"tutorial:<name>"\` to read a specific tutorial.\n\n${listing}`,
+            web_url: webUrls['tutorials'],
+            error: null,
+        };
+    }
+    // Handle "tutorial:<name>" topics
+    if (normalized.startsWith('tutorial:')) {
+        const tutorialName = normalized.slice('tutorial:'.length);
+        const tutorialsDir = join(docsDir, 'tutorials');
+        const candidates = [
+            `${tutorialName}.md`,
+            `${tutorialName.replace(/-/g, '_')}.md`,
+            `${tutorialName.replace(/_/g, '-')}.md`,
+        ];
+        for (const candidate of candidates) {
+            try {
+                const filepath = join(tutorialsDir, candidate);
+                const content = readFileSync(filepath, 'utf-8');
+                const resolvedName = basename(candidate, '.md');
+                return {
+                    success: true,
+                    topic,
+                    content,
+                    web_url: `${SITE_BASE}/tutorials/${resolvedName}`,
+                    error: null,
+                };
+            }
+            catch {
+                // Try next candidate
+            }
+        }
+        const tutorials = listTutorials();
+        return {
+            success: false,
+            topic,
+            content: '',
+            error: `Unknown tutorial: ${tutorialName}. Available tutorials: ${tutorials.join(', ')}`,
+        };
+    }
+    const filename = topics[normalized];
+    if (!filename) {
+        const tutorials = listTutorials();
+        const allTopics = [
+            'expert',
+            ...Object.keys(topics),
+            'tutorials',
+            ...tutorials.map(t => `tutorial:${t}`),
+        ];
+        return {
+            success: false,
+            topic,
+            content: '',
+            error: `Unknown topic: ${topic}. Available topics: ${allTopics.join(', ')}`,
+        };
+    }
+    try {
+        const filepath = join(docsDir, filename);
+        const content = readFileSync(filepath, 'utf-8');
+        return {
+            success: true,
+            topic,
+            content,
+            ...(webUrls[normalized] && { web_url: webUrls[normalized] }),
+            error: null,
+        };
+    }
+    catch (e) {
+        return {
+            success: false,
+            topic,
+            content: '',
+            error: `Failed to read documentation: ${e instanceof Error ? e.message : String(e)}`,
+        };
+    }
+}
+//# sourceMappingURL=help.js.map

package/dist/lib/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/lib/help.ts"],"names":[],"mappings":"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"}

package/dist/lib/recipes.d.ts

@@ -0,0 +1,29 @@
+export interface RecipeArg {
+    name: string;
+    desc?: string;
+    value?: string;
+}
+export interface RecipeExample {
+    i: string;
+    o: string;
+}
+export interface RecipeFunction {
+    name: string;
+    type: string;
+    description: string;
+    args: RecipeArg[];
+    examples: RecipeExample[];
+    snippet?: string;
+    source_file: string;
+}
+export interface RecipesResult {
+    success: boolean;
+    recipes: RecipeFunction[];
+    count: number;
+    error: string | null;
+}
+/**
+ * Search/list available recipe functions.
+ */
+export declare function superRecipes(query?: string): RecipesResult;
+//# sourceMappingURL=recipes.d.ts.map

package/dist/lib/recipes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipes.d.ts","sourceRoot":"","sources":["../../src/lib/recipes.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AA2GD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,CAmC1D"}

package/dist/lib/recipes.js

@@ -0,0 +1,133 @@
+import { readFileSync, readdirSync } from 'fs';
+import { join, basename } from 'path';
+import { getDocsDir } from './docs.js';
+/**
+ * Parse skdoc metadata from a .spq file.
+ */
+function parseSkdocFromFile(filepath) {
+    const content = readFileSync(filepath, 'utf-8');
+    const sourceFile = basename(filepath, '.spq');
+    const recipes = [];
+    const skdocPattern = /fn\s+skdoc_\w+\(\):\s*\(\s*cast\(\s*(\{[\s\S]*?\}),\s*<skdoc>\)/g;
+    const skdocOpPattern = /op\s+skdoc_\w+:\s*\(\s*cast\(\s*(\{[\s\S]*?\}),\s*<skdoc>\)/g;
+    for (const pattern of [skdocPattern, skdocOpPattern]) {
+        let match;
+        while ((match = pattern.exec(content)) !== null) {
+            try {
+                const raw = match[1];
+                const recipe = parseSkdocObject(raw, sourceFile);
+                if (recipe) {
+                    recipes.push(recipe);
+                }
+            }
+            catch {
+                // Skip malformed skdoc entries
+            }
+        }
+    }
+    return recipes;
+}
+/**
+ * Parse a SUP-format skdoc object into a RecipeFunction.
+ */
+function parseSkdocObject(raw, sourceFile) {
+    const nameMatch = raw.match(/name:"([^"]+)"/);
+    const typeMatch = raw.match(/type:"([^"]+)"/);
+    const descMatch = raw.match(/desc:"([^"]+)"/);
+    if (!nameMatch || !typeMatch || !descMatch) {
+        return null;
+    }
+    const args = [];
+    const argsMatch = raw.match(/args:\[([\s\S]*?)\]/);
+    if (argsMatch) {
+        const argsContent = argsMatch[1];
+        const argPattern = /\{([^}]+)\}/g;
+        let argMatch;
+        while ((argMatch = argPattern.exec(argsContent)) !== null) {
+            const argObj = argMatch[1];
+            const argName = argObj.match(/name:"([^"]+)"/);
+            const argDesc = argObj.match(/desc:"([^"]+)"/);
+            const argValue = argObj.match(/value:"([^"]+)"/);
+            if (argName) {
+                args.push({
+                    name: argName[1],
+                    ...(argDesc && { desc: argDesc[1] }),
+                    ...(argValue && { value: argValue[1] }),
+                });
+            }
+        }
+    }
+    const examples = [];
+    const examplesMatch = raw.match(/examples:\[([\s\S]*?)\]/);
+    if (examplesMatch) {
+        const exContent = examplesMatch[1];
+        const exPattern = /\{([^}]+)\}/g;
+        let exMatch;
+        while ((exMatch = exPattern.exec(exContent)) !== null) {
+            const exObj = exMatch[1];
+            const iMatch = exObj.match(/i:"([^"]+)"/);
+            const oMatch = exObj.match(/o:"([^"]+)"/);
+            if (iMatch && oMatch) {
+                examples.push({ i: iMatch[1], o: oMatch[1] });
+            }
+        }
+    }
+    const snippetMatch = raw.match(/snippet:'([^']+)'/);
+    return {
+        name: nameMatch[1],
+        type: typeMatch[1],
+        description: descMatch[1],
+        args,
+        examples,
+        ...(snippetMatch && { snippet: snippetMatch[1] }),
+        source_file: sourceFile,
+    };
+}
+/**
+ * Load all recipes from the docs/recipes directory.
+ */
+function loadAllRecipes() {
+    const recipesDir = join(getDocsDir(), 'recipes');
+    const files = readdirSync(recipesDir).filter(f => f.endsWith('.spq')).sort();
+    const all = [];
+    for (const file of files) {
+        const filepath = join(recipesDir, file);
+        all.push(...parseSkdocFromFile(filepath));
+    }
+    return all;
+}
+/**
+ * Search/list available recipe functions.
+ */
+export function superRecipes(query) {
+    try {
+        const allRecipes = loadAllRecipes();
+        if (!query) {
+            return {
+                success: true,
+                recipes: allRecipes,
+                count: allRecipes.length,
+                error: null,
+            };
+        }
+        const q = query.toLowerCase();
+        const filtered = allRecipes.filter(r => r.name.toLowerCase().includes(q) ||
+            r.description.toLowerCase().includes(q) ||
+            r.source_file.toLowerCase().includes(q));
+        return {
+            success: true,
+            recipes: filtered,
+            count: filtered.length,
+            error: null,
+        };
+    }
+    catch (e) {
+        return {
+            success: false,
+            recipes: [],
+            count: 0,
+            error: e instanceof Error ? e.message : String(e),
+        };
+    }
+}
+//# sourceMappingURL=recipes.js.map

package/dist/lib/recipes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipes.js","sourceRoot":"","sources":["../../src/lib/recipes.ts"],"names":[],"mappings":"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"}

package/docs/grok-patterns.sup

@@ -0,0 +1,89 @@
+{pattern_name:"USERNAME",regex:"[a-zA-Z0-9._-]+"}
+{pattern_name:"USER",regex:"%{USERNAME}"}
+{pattern_name:"EMAILLOCALPART",regex:"[a-zA-Z][a-zA-Z0-9_.+-=:]+"}
+{pattern_name:"HOSTNAME",regex:"\\b[0-9A-Za-z][0-9A-Za-z-]{0,62}(?:\\.[0-9A-Za-z][0-9A-Za-z-]{0,62})*(\\.?|\\b)"}
+{pattern_name:"EMAILADDRESS",regex:"%{EMAILLOCALPART}@%{HOSTNAME}"}
+{pattern_name:"HTTPDUSER",regex:"%{EMAILADDRESS}|%{USER}"}
+{pattern_name:"INT",regex:"[+-]?(?:[0-9]+)"}
+{pattern_name:"BASE10NUM",regex:"[+-]?(?:(?:[0-9]+(?:\\.[0-9]+)?)|(?:\\.[0-9]+))"}
+{pattern_name:"NUMBER",regex:"%{BASE10NUM}"}
+{pattern_name:"BASE16NUM",regex:"[+-]?(?:0x)?(?:[0-9A-Fa-f]+)"}
+{pattern_name:"BASE16FLOAT",regex:"\\b[+-]?(?:0x)?(?:(?:[0-9A-Fa-f]+(?:\\.[0-9A-Fa-f]*)?)|(?:\\.[0-9A-Fa-f]+))\\b"}
+{pattern_name:"POSINT",regex:"\\b[1-9][0-9]*\\b"}
+{pattern_name:"NONNEGINT",regex:"\\b[0-9]+\\b"}
+{pattern_name:"WORD",regex:"\\b\\w+\\b"}
+{pattern_name:"NOTSPACE",regex:"\\S+"}
+{pattern_name:"SPACE",regex:"\\s*"}
+{pattern_name:"DATA",regex:".*?"}
+{pattern_name:"GREEDYDATA",regex:".*"}
+{pattern_name:"QUOTEDSTRING",regex:"(\"(\\\\.|[^\\\\\"]+)+\")\"\"|('(\\\\.|[^\\\\'+)+')+'|''|"}
+{pattern_name:"UUID",regex:"[A-Fa-f0-9]{8}-(?:[A-Fa-f0-9]{4}-){3}[A-Fa-f0-9]{12}"}
+{pattern_name:"CISCOMAC",regex:"(?:[A-Fa-f0-9]{4}\\.){2}[A-Fa-f0-9]{4}"}
+{pattern_name:"WINDOWSMAC",regex:"(?:[A-Fa-f0-9]{2}-){5}[A-Fa-f0-9]{2}"}
+{pattern_name:"COMMONMAC",regex:"(?:[A-Fa-f0-9]{2}:){5}[A-Fa-f0-9]{2}"}
+{pattern_name:"MAC",regex:"%{CISCOMAC}|%{WINDOWSMAC}|%{COMMONMAC}"}
+{pattern_name:"IPV6",regex:"((([0-9A-Fa-f]{1,4}:){7}([0-9A-Fa-f]{1,4}|:))|(([0-9A-Fa-f]{1,4}:){6}(:[0-9A-Fa-f]{1,4}|((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3})|:))|(([0-9A-Fa-f]{1,4}:){5}(((:[0-9A-Fa-f]{1,4}){1,2})|:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3})|:))|(([0-9A-Fa-f]{1,4}:){4}(((:[0-9A-Fa-f]{1,4}){1,3})|((:[0-9A-Fa-f]{1,4})?:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){3}(((:[0-9A-Fa-f]{1,4}){1,4})|((:[0-9A-Fa-f]{1,4}){0,2}:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){2}(((:[0-9A-Fa-f]{1,4}){1,5})|((:[0-9A-Fa-f]{1,4}){0,3}:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){1}(((:[0-9A-Fa-f]{1,4}){1,6})|((:[0-9A-Fa-f]{1,4}){0,4}:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:))|(:(((:[0-9A-Fa-f]{1,4}){1,7})|((:[0-9A-Fa-f]{1,4}){0,5}:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:)))(%.+)?"}
+{pattern_name:"IPV4",regex:"(?:(?:[0-1]?[0-9]{1,2}|2[0-4][0-9]|25[0-5])[.](?:[0-1]?[0-9]{1,2}|2[0-4][0-9]|25[0-5])[.](?:[0-1]?[0-9]{1,2}|2[0-4][0-9]|25[0-5])[.](?:[0-1]?[0-9]{1,2}|2[0-4][0-9]|25[0-5]))"}
+{pattern_name:"IP",regex:"%{IPV6}|%{IPV4}"}
+{pattern_name:"IPORHOST",regex:"%{IP}|%{HOSTNAME}"}
+{pattern_name:"HOSTPORT",regex:"%{IPORHOST}:%{POSINT}"}
+{pattern_name:"UNIXPATH",regex:"(/([\\w_%!$@:.,~-]+|\\\\.)*)+"}
+{pattern_name:"TTY",regex:"/dev/(pts|tty([pq])?)( \\w+)?/?(?:[0-9]+)"}
+{pattern_name:"WINPATH",regex:"(?:[A-Za-z]+:|\\\\)(?:\\\\[^\\\\?*]*)+"}
+{pattern_name:"PATH",regex:"%{UNIXPATH}|%{WINPATH}"}
+{pattern_name:"URIPROTO",regex:"[A-Za-z]+(\\+[A-Za-z+]+)?"}
+{pattern_name:"URIHOST",regex:"%{IPORHOST}(?::%{POSINT:port})?"}
+{pattern_name:"URIPATH",regex:"(?:/[A-Za-z0-9$.+!'(){},~:;=@#%_\\-]*)+"}
+{pattern_name:"URIPARAM",regex:"\\?[A-Za-z0-9$.+!'|(){},~@#%&/=:;_?\\-\\[\\]<>]*"}
+{pattern_name:"URIPATHPARAM",regex:"%{URIPATH}(?:%{URIPARAM})?"}
+{pattern_name:"URI",regex:"%{URIPROTO}://(?:%{USER}(?::[^@]*)?@)?(?:%{URIHOST})?(?:%{URIPATHPARAM})?"}
+{pattern_name:"MONTH",regex:"\\bJan(?:uary|uar)?|Feb(?:ruary|ruar)?|M(?:a|ä)?r(?:ch|z)?|Apr(?:il)?|Ma(?:y|i)?|Jun(?:e|i)?|Jul(?:y)?|Aug(?:ust)?|Sep(?:tember)?|O(?:c|k)?t(?:ober)?|Nov(?:ember)?|De(?:c|z)(?:ember)?\\b"}
+{pattern_name:"MONTHNUM",regex:"0?[1-9]|1[0-2]"}
+{pattern_name:"MONTHNUM2",regex:"0[1-9]|1[0-2]"}
+{pattern_name:"MONTHDAY",regex:"(?:0[1-9])|(?:[12][0-9])|(?:3[01])|[1-9]"}
+{pattern_name:"DAY",regex:"Mon(?:day)?|Tue(?:sday)?|Wed(?:nesday)?|Thu(?:rsday)?|Fri(?:day)?|Sat(?:urday)?|Sun(?:day)?"}
+{pattern_name:"YEAR",regex:"(?:\\d\\d){1,2}"}
+{pattern_name:"HOUR",regex:"2[0123]|[01]?[0-9]"}
+{pattern_name:"MINUTE",regex:"[0-5][0-9]"}
+{pattern_name:"SECOND",regex:"(?:[0-5]?[0-9]|60)(?:[:.,][0-9]+)?"}
+{pattern_name:"TIME",regex:"%{HOUR}:%{MINUTE}:%{SECOND}"}
+{pattern_name:"DATE_US",regex:"%{MONTHNUM}[/-]%{MONTHDAY}[/-]%{YEAR}"}
+{pattern_name:"DATE_EU",regex:"%{MONTHDAY}[./-]%{MONTHNUM}[./-]%{YEAR}"}
+{pattern_name:"DATE_X",regex:"%{YEAR}/%{MONTHNUM2}/%{MONTHDAY}"}
+{pattern_name:"ISO8601_TIMEZONE",regex:"Z|[+-]%{HOUR}(?::?%{MINUTE})"}
+{pattern_name:"ISO8601_SECOND",regex:"%{SECOND}|60"}
+{pattern_name:"DATESTAMP_ISO8601",regex:"%{YEAR}-%{MONTHNUM}-%{MONTHDAY}"}
+{pattern_name:"TIMESTAMP_ISO8601",regex:"%{DATESTAMP_ISO8601}[T ]%{HOUR}:?%{MINUTE}(?::?%{SECOND})?%{ISO8601_TIMEZONE}?"}
+{pattern_name:"DATE",regex:"%{DATE_US}|%{DATE_EU}|%{DATE_X}"}
+{pattern_name:"DATESTAMP",regex:"%{DATE}[- ]%{TIME}"}
+{pattern_name:"TZ",regex:"[A-Z]{3}"}
+{pattern_name:"NUMTZ",regex:"[+-]\\d{4}"}
+{pattern_name:"DATESTAMP_RFC822",regex:"%{DAY} %{MONTH} %{MONTHDAY} %{YEAR} %{TIME} %{TZ}"}
+{pattern_name:"DATESTAMP_RFC2822",regex:"%{DAY}, %{MONTHDAY} %{MONTH} %{YEAR} %{TIME} %{ISO8601_TIMEZONE}"}
+{pattern_name:"DATESTAMP_OTHER",regex:"%{DAY} %{MONTH} %{MONTHDAY} %{TIME} %{TZ} %{YEAR}"}
+{pattern_name:"DATESTAMP_EVENTLOG",regex:"%{YEAR}%{MONTHNUM2}%{MONTHDAY}%{HOUR}%{MINUTE}%{SECOND}"}
+{pattern_name:"HTTPDERROR_DATE",regex:"%{DAY} %{MONTH} %{MONTHDAY} %{TIME} %{YEAR}"}
+{pattern_name:"ANSIC",regex:"%{DAY} %{MONTH} [_123]\\d %{TIME} %{YEAR}\""}
+{pattern_name:"UNIXDATE",regex:"%{DAY} %{MONTH} [_123]\\d %{TIME} %{TZ} %{YEAR}"}
+{pattern_name:"RUBYDATE",regex:"%{DAY} %{MONTH} [0-3]\\d %{TIME} %{NUMTZ} %{YEAR}"}
+{pattern_name:"RFC822Z",regex:"[0-3]\\d %{MONTH} %{YEAR} %{TIME} %{NUMTZ}"}
+{pattern_name:"RFC850",regex:"%{DAY}, [0-3]\\d-%{MONTH}-%{YEAR} %{TIME} %{TZ}"}
+{pattern_name:"RFC1123",regex:"%{DAY}, [0-3]\\d %{MONTH} %{YEAR} %{TIME} %{TZ}"}
+{pattern_name:"RFC1123Z",regex:"%{DAY}, [0-3]\\d %{MONTH} %{YEAR} %{TIME} %{NUMTZ}"}
+{pattern_name:"RFC3339",regex:"%{YEAR}-[01]\\d-[0-3]\\dT%{TIME}%{ISO8601_TIMEZONE}"}
+{pattern_name:"RFC3339NANO",regex:"%{YEAR}-[01]\\d-[0-3]\\dT%{TIME}\\.\\d{9}%{ISO8601_TIMEZONE}"}
+{pattern_name:"KITCHEN",regex:"\\d{1,2}:\\d{2}(AM|PM|am|pm)"}
+{pattern_name:"SYSLOGTIMESTAMP",regex:"%{MONTH} +%{MONTHDAY} %{TIME}"}
+{pattern_name:"PROG",regex:"[\\x21-\\x5a\\x5c\\x5e-\\x7e]+"}
+{pattern_name:"SYSLOGPROG",regex:"%{PROG:program}(?:\\[%{POSINT:pid}\\])?"}
+{pattern_name:"SYSLOGHOST",regex:"%{IPORHOST}"}
+{pattern_name:"SYSLOGFACILITY",regex:"<%{NONNEGINT:facility}.%{NONNEGINT:priority}>"}
+{pattern_name:"HTTPDATE",regex:"%{MONTHDAY}/%{MONTH}/%{YEAR}:%{TIME} %{INT}"}
+{pattern_name:"QS",regex:"%{QUOTEDSTRING}"}
+{pattern_name:"LOGLEVEL",regex:"[Aa]lert|ALERT|[Tt]race|TRACE|[Dd]ebug|DEBUG|[Nn]otice|NOTICE|[Ii]nfo|INFO|[Ww]arn?(?:ing)?|WARN?(?:ING)?|[Ee]rr?(?:or)?|ERR?(?:OR)?|[Cc]rit?(?:ical)?|CRIT?(?:ICAL)?|[Ff]atal|FATAL|[Ss]evere|SEVERE|EMERG(?:ENCY)?|[Ee]merg(?:ency)?"}
+{pattern_name:"SYSLOGBASE",regex:"%{SYSLOGTIMESTAMP:timestamp} (?:%{SYSLOGFACILITY} )?%{SYSLOGHOST:logsource} %{SYSLOGPROG}:"}
+{pattern_name:"COMMONAPACHELOG",regex:"%{IPORHOST:clientip} %{HTTPDUSER:ident} %{USER:auth} \\[%{HTTPDATE:timestamp}\\] \"(?:%{WORD:verb} %{NOTSPACE:request}(?: HTTP/%{NUMBER:httpversion})?|%{DATA:rawrequest})\" %{NUMBER:response} (?:%{NUMBER:bytes}|-)"}
+{pattern_name:"COMBINEDAPACHELOG",regex:"%{COMMONAPACHELOG} %{QS:referrer} %{QS:agent}"}
+{pattern_name:"HTTPD20_ERRORLOG",regex:"\\[%{HTTPDERROR_DATE:timestamp}\\] \\[%{LOGLEVEL:loglevel}\\] (?:\\[client %{IPORHOST:clientip}\\] ){0,1}%{GREEDYDATA:errormsg}"}
+{pattern_name:"HTTPD24_ERRORLOG",regex:"\\[%{HTTPDERROR_DATE:timestamp}\\] \\[%{WORD:module}:%{LOGLEVEL:loglevel}\\] \\[pid %{POSINT:pid}:tid %{NUMBER:tid}\\]( \\(%{POSINT:proxy_errorcode}\\)%{DATA:proxy_errormessage}:)?( \\[client %{IPORHOST:client}:%{POSINT:clientport}\\])? %{DATA:errorcode}: %{GREEDYDATA:message}"}
+{pattern_name:"HTTPD_ERRORLOG",regex:"%{HTTPD20_ERRORLOG}|%{HTTPD24_ERRORLOG}"}

package/docs/recipes/array.md

@@ -0,0 +1,66 @@
+---
+title: Array
+layout: default
+nav_order: 2
+parent: Recipes
+---
+
+# Array Recipes
+
+Source: `array.spq`
+
+---
+
+## sk_in_array
+
+Puts value in an array if value isn't an array itself.
+
+**Type:** function
+
+| Argument | Description |
+|----------|-------------|
+| `value` | any |
+
+```supersql
+sk_in_array(1)
+-- => [1]
+
+sk_in_array([1])
+-- => [1]
+```
+
+**Implementation:**
+
+```supersql
+fn sk_in_array(value): (
+  kind(value) == "array" ? value : [value]
+)
+```
+
+---
+
+## sk_array_flatten
+
+Flattens an array of arrays into a single array.
+
+**Type:** operator
+
+```supersql
+[1,2,[3,4],5] | sk_array_flatten
+-- => [1,2,3,4,5]
+
+[[1,2],[3,4]] | sk_array_flatten
+-- => [1,2,3,4]
+```
+
+**Implementation:**
+
+```supersql
+op sk_array_flatten: (
+  this::string
+  | this[1:-1]
+  | replace(this,'[','')
+  | replace(this, ']','')
+  | parse_sup(f'[{this}]')
+)
+```

package/docs/recipes/array.spq

@@ -0,0 +1,31 @@
+fn skdoc_in_array(): (
+  cast(
+    {name:"sk_in_array",
+     type:"func",
+     desc:"Puts value in an array if value isn't an array itself.",
+     args:[{name:"value",value:"any"}],
+     examples:[{i:"sk_in_array(1)",o:"[1]"}
+               {i:"sk_in_array([1])",o:"[1]"}]}, <skdoc>)
+)
+
+fn sk_in_array(value): (
+  kind(value) == "array" ? value : [value]
+)
+
+fn skdoc_array_flatten(): (
+  cast(
+    {name:"sk_array_flatten",
+     type:"op",
+     desc:"Flattens an array of arrays into a single array.",
+     args:[],
+     examples:[{i:"[1,2,[3,4],5] | sk_array_flatten",o:"[1,2,3,4,5]"}
+               {i:"[[1,2],[3,4]] | sk_array_flatten",o:"[1,2,3,4]"}]}, <skdoc>)
+)
+
+op sk_array_flatten: (
+  this::string
+  | this[1:-1]
+  | replace(this,'[','')
+  | replace(this, ']','')
+  | parse_sup(f'[{this}]')
+)

package/docs/recipes/character.md

@@ -0,0 +1,110 @@
+---
+title: Character
+layout: default
+nav_order: 4
+parent: Recipes
+---
+
+# Character Recipes
+
+Source: `character.spq` (includes `string.spq`)
+
+---
+
+## sk_seq
+
+Generates a sequence 0..n-1 (like generate_series).
+
+**Type:** operator
+
+| Argument | Description |
+|----------|-------------|
+| `n` | Number of elements to generate |
+
+```supersql
+sk_seq(3)
+-- => 0, 1, 2
+```
+
+**Implementation:**
+
+```supersql
+op sk_seq(n): (
+  split(sk_pad_left('', '0', n), '')
+  | unnest this
+  | count
+  | values count - 1
+)
+```
+
+---
+
+## sk_hex_digits
+
+Returns the 16 hex digit characters as an array.
+
+**Type:** function
+
+```supersql
+sk_hex_digits()
+-- => ["0","1","2","3","4","5","6","7","8","9","a","b","c","d","e","f"]
+```
+
+**Implementation:**
+
+```supersql
+fn sk_hex_digits(): (
+  split("0123456789abcdef", "")
+)
+```
+
+---
+
+## sk_chr
+
+Converts an integer (0-127) to its ASCII character.
+
+**Type:** function
+
+| Argument | Description |
+|----------|-------------|
+| `code` | ASCII code (0-127) |
+
+```supersql
+sk_chr(65)
+-- => 'A'
+```
+
+**Implementation:**
+
+```supersql
+fn sk_chr(code): (
+  let d = sk_hex_digits() |
+  hex(f'{d[code/16]}{d[code%16]}')::string
+)
+```
+
+---
+
+## sk_alpha
+
+Converts 1-26 to A-Z.
+
+**Type:** function
+
+| Argument | Description |
+|----------|-------------|
+| `n` | Number 1-26 |
+
+```supersql
+sk_alpha(3)
+-- => 'C'
+```
+
+**Implementation:**
+
+```supersql
+fn sk_alpha(n): (
+  sk_chr(64 + n)
+)
+```